CDRN

Koda en PDF till Base64

  • Panel
  • Dokumentation
  • API
konverterar en PDF till en Base64 / Data URI-sträng, perfekt för att bädda in ett dokument direkt i HTML, JSON eller ett e-postmeddelande

Koda en PDF i Base64

Base64 är en kodning som representerar binär data som ASCII-text (64 tecken: A-Z, a-z, 0-9, plus två ytterligare tecken). En PDF-fil, som är binär till sin natur, kan inte klistras in direkt i ett HTML-mejl, en JSON-payload eller ett XML-attribut: den måste först konverteras till text. Vårt verktyg tar din PDF-fil och returnerar dess Base64-representation, redo att kopieras.

För detaljer om Base64 och Data URI-formatet i allmänhet, se vår Base64-textkodare som täcker principerna på djupet.

Varför koda en PDF i Base64?

  • Bädda in en PDF i ett HTML-mejl: vissa e-postklienter accepterar Data URI-länkar eller inline-kodade MIME-bilagor.
  • Lagra en PDF i ett textfält i en databas (kolumn TEXT eller VARCHAR) när applikationsbegränsningen förbjuder en binär typ (BLOB).
  • Skicka en PDF i en API-JSON-payload: JSON stöder inte binärt, så alla filer måste transporteras i Base64.
  • Bädda in en PDF i en data:-URL: sällsynt användning, reserverad för mycket små filer, eftersom URL:er har längdbegränsningar (typiskt 2000 till 8000 tecken beroende på webbläsare och server).

Data URI-format för PDF

En URL av typen Data URI bäddar in PDF-innehållet direkt i URL:en: 

data:application/pdf;base64,JVBERi0xLjQKJcfsj6IKNSAwIG9iago8PC9MZW5ndGggNiAwIFI...

Prefixet data:application/pdf;base64, talar om för webbläsaren MIME-typen och kodningen. Du kan klistra in denna URL direkt i adressfältet på en modern webbläsare för att öppna PDF:en, eller placera den i attributet src på en <iframe> eller <embed>.

Konkreta användningsfall

  • Elektroniska signaturer: de flesta signatur-API:er (DocuSign, Yousign osv.) accepterar eller kräver PDF:en i Base64 i JSON-kroppen av förfrågan.
  • Säkerhetskopior och arkivering: serialisera en PDF i en JSON-export eller en textfil versionshanterad i git (att undvika för stora volymer, men praktiskt för testfixturer).
  • Automatiserade tester: bädda in en referens-PDF direkt i ett enhetstest utan att vara beroende av en extern fil.
  • Klientexporter: generera en PDF på serversidan, returnera den i Base64 i JSON-svaret, klienten avkodar och laddar ner den utan ytterligare HTTP-anrop.

Nackdelar att känna till

  • Storleksoverhead: Base64 lägger till ungefär 33 % till volymen. En 1 MB PDF blir en 1,37 MB-sträng i Base64.
  • Ingen HTTP-cache: en PDF inbäddad i Data URI i en HTML-sida laddas ner igen vid varje sidladdning, till skillnad från en fil serverad från en klassisk URL med cache-headers.
  • Storleksbegränsningar: webbläsarminne, max POST-storlek på serversidan (upload_max_filesize och post_max_size i PHP) och databaskvoter (radstorlek i MySQL, till exempel) kan snabbt överskridas på stora PDF:er.
  • Olämpligt för stora filer: bortom några MB, föredra dedikerad lagring (S3, disk) och skicka en URL istället för det kodade innehållet.

Så använder du verktyget

  1. Klicka på uppladdningsfältet och välj din PDF-fil.
  2. Verktyget kodar det binära innehållet i Base64 och visar resultatet.
  3. Du kan välja att inkludera eller inte inkludera prefixet data:application/pdf;base64, beroende på ditt användningsfall (med prefix för Data URI, utan prefix för en JSON-payload).
  4. Kopiera strängen och klistra in den där du behöver.

Vanliga frågor

Vilken är den maximala accepterade PDF-storleken?

Gränsen beror på serverkonfigurationen. I praktiken, håll dig under några MB för att behålla en smidig upplevelse. Bortom det blir webbläsaren långsam, urklippet blir överbelastat och destinationerna (e-post, JSON, databas) riskerar att avvisa lasten.

Är Base64-PDF:en kompatibel med e-postklienter (Gmail, Outlook)?

Som inline-kodad bilaga i ett MIME-meddelande, ja: det är till och med e-postens standardmekanism. Däremot, i Data URI i HTML-kroppen av ett meddelande (<a href="data:..."> eller <iframe>), blockerar eller skriver de flesta e-postklienter om dessa URL:er av säkerhetsskäl. Föredra den klassiska bilagan.

Vad är skillnaden mot en krypterad PDF?

Att koda i Base64 är inte kryptering: strängen är läsbar och trivial att avkoda av vem som helst. En krypterad PDF (ägar- eller användarlösenord) förblir krypterad även efter Base64-kodning: kodning och kryptering är två oberoende operationer.

Kan jag göra den omvända operationen?

Ja: använd vår Base64 PDF-avkodare för att omvandla en Base64-sträng till en nedladdningsbar PDF-fil.

Skickas min PDF till era servrar?

Kodningen hanteras på serversidan under själva förfrågan, sedan frigörs filen. Ingen beständig lagring sker. För särskilt känsliga PDF:er, föredra en lokal behandling med ett offline-verktyg.

Exempelförfrågan

curl -X POST https://cdrn.fr/api/v1/tools/base64-pdf-encoder/execute \
  -F "file=@/path/to/file"

Indatasschema

Fält Typ Obligatorisk Standard
file file ✓ –

detta verktyg förväntar sig en fil - använd Content-Type multipart/form-data istället för application/json

Slutpunkter

  • GET https://cdrn.fr/api/v1/tools - listar alla tillgängliga verktyg
  • GET https://cdrn.fr/api/v1/tools/base64-pdf-encoder - hämtar schemat för detta verktyg
  • POST https://cdrn.fr/api/v1/tools/base64-pdf-encoder/execute - kör detta verktyg med en JSON-payload