CDRN

PDF kódolása Base64-be

  • Irányítópult
  • Dokumentáció
  • API
PDF-et Base64 / Data URI karakterlánccá alakít, ideális dokumentum közvetlen beágyazásához HTML, JSON vagy email tartalomba

PDF kódolása Base64 formátumba

A Base64 egy olyan kódolás, amely a bináris adatokat ASCII szövegként jeleníti meg (64 karakter: A-Z, a-z, 0-9, plusz két további karakter). Egy PDF fájl, amely természeténél fogva bináris, nem illeszthető be közvetlenül egy HTML e-mailbe, egy JSON payloadba vagy egy XML attribútumba: először szöveggé kell alakítani. Eszközünk fogja a PDF fájlját, és visszaadja annak Base64 reprezentációját, amely készen áll a másolásra.

A Base64-gyel és a Data URI formátummal kapcsolatos részletekért tekintse meg a Base64 szövegkódolónkat, amely mélyrehatóan tárgyalja az alapelveket.

Miért kódoljunk PDF-et Base64 formátumba?

  • PDF beágyazása HTML e-mailbe: bizonyos e-mail kliensek elfogadják a Data URI linkeket vagy a MIME-ben inline kódolt mellékleteket.
  • PDF tárolása adatbázis szöveges mezőjében (TEXT vagy VARCHAR oszlop), ha az alkalmazás korlátai tiltják a bináris típust (BLOB).
  • PDF továbbítása API JSON payloadjában: a JSON nem támogatja a bináris formátumot, így minden fájlnak Base64-en keresztül kell áthaladnia.
  • PDF beágyazása data: URL-be: ritka használat, csak nagyon kis fájlokhoz javasolt, mivel az URL-ek hossza korlátozott (jellemzően 2000-8000 karakter a böngészőtől és a szervertől függően).

Data URI formátum PDF-hez

A Data URI típusú URL közvetlenül az URL-be ágyazza a PDF tartalmát: 

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

A data:application/pdf;base64, előtag jelzi a böngészőnek a MIME típust és a kódolást. Ezt az URL-t közvetlenül beillesztheti egy modern böngésző címsorába a PDF megnyitásához, vagy elhelyezheti egy <iframe> vagy <embed> src attribútumában.

Gyakorlati felhasználási esetek

  • Elektronikus aláírások: a legtöbb aláíró API (DocuSign, Yousign stb.) elfogadja vagy megköveteli a Base64 PDF-et a kérés JSON törzsében.
  • Mentés és archiválás: PDF sorosítása JSON exportba vagy git-ben verziózott szöveges fájlba (nagy mennyiségeknél kerülendő, de teszt fixture-ökhöz praktikus).
  • Automatizált tesztek: referencia PDF beágyazása közvetlenül egy egységtesztbe, külső fájltól való függés nélkül.
  • Ügyfél exportok: PDF generálása szerver oldalon, visszaküldése Base64-ben a JSON válaszban, az ügyfél dekódolja és letölti további HTTP hívás nélkül.

Ismert hátrányok

  • Méretnövekedés: a Base64 körülbelül 33%-kal növeli a volument. Egy 1 MB-os PDF-ből 1,37 MB-os karakterlánc lesz Base64-ben.
  • Nincs HTTP gyorsítótár: a HTML oldalba Data URI-ként beágyazott PDF minden betöltéskor újra letöltődik, ellentétben a klasszikus URL-ről kiszolgált, gyorsítótár-fejlécekkel ellátott fájllal.
  • Méretkorlátok: a böngésző memóriája, a szerver oldali POST maximális mérete (upload_max_filesize és post_max_size PHP-ben) és az adatbázis kvótái (például MySQL sorhossz) hamar túlléphetők nagy PDF-ek esetén.
  • Nem alkalmas nagy fájlokhoz: néhány MB felett preferálja a dedikált tárolást (S3, lemez), és küldjön URL-t a kódolt tartalom helyett.

Hogyan használjuk az eszközt

  1. Kattintson a feltöltési mezőre, és válassza ki a PDF fájlját.
  2. Az eszköz a bináris tartalmat Base64 formátumba kódolja, és megjeleníti az eredményt.
  3. Választhat, hogy tartalmazza-e a data:application/pdf;base64, előtagot a felhasználási esettől függően (előtaggal Data URI-hoz, előtag nélkül JSON payloadhoz).
  4. Másolja ki a karakterláncot, és illessze be oda, ahol szüksége van rá.

Gyakran ismételt kérdések

Mekkora a maximálisan elfogadott PDF méret?

A korlát a szerver konfigurációjától függ. A gyakorlatban maradjon néhány MB alatt a zökkenőmentes élmény érdekében. E felett a böngésző lassulhat, a vágólap telítődhet, és a célállomások (e-mail, JSON, adatbázis) elutasíthatják a terhelést.

Kompatibilis a Base64 PDF az e-mail kliensekkel (Gmail, Outlook)?

MIME üzenetbe ágyazott mellékletként igen: ez az elektronikus levelezés szabványos mechanizmusa. Ezzel szemben az üzenet HTML törzsében lévő Data URI-ként (<a href="data:..."> vagy <iframe>) a legtöbb e-mail kliens biztonsági okokból blokkolja vagy átírja ezeket az URL-eket. Preferálja a klasszikus mellékletet.

Mi a különbség a titkosított PDF-hez képest?

A Base64 kódolás nem titkosítás: a karakterlánc olvasható marad, és bárki számára triviális a dekódolása. A titkosított PDF (tulajdonosi vagy felhasználói jelszóval) a Base64 kódolás után is titkosított marad: a kódolás és a titkosítás két független művelet.

Elvégezhetem a fordított műveletet?

Igen: használja a Base64 PDF dekódolónkat a Base64 karakterlánc letölthető PDF fájllá alakításához.

Elküldik a PDF-emet a szervereikre?

A kódolás a szerver oldalon történik a kérés idejére, majd a fájl felszabadul. Nem történik tartós tárolás. Különösen érzékeny PDF-ek esetén preferálja a helyi feldolgozást egy offline eszközzel.

Kérés példa

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

Bemeneti séma

Mező Típus Kötelező Alapértelmezett
file file ✓ –

ez az eszköz fájlt vár - használjon Content-Type multipart/form-data értéket application/json helyett

Végpontok

  • GET https://cdrn.fr/api/v1/tools - listázza az összes elérhető eszközt
  • GET https://cdrn.fr/api/v1/tools/base64-pdf-encoder - lekéri ezen eszköz sémáját
  • POST https://cdrn.fr/api/v1/tools/base64-pdf-encoder/execute - végrehajtja ezen eszközt JSON payloaddal