CDRN

Zakódovať PDF do Base64

  • Dashboard
  • Dokumentácia
  • API
konvertuje PDF na reťazec Base64 / Data URI, ideálne na vloženie dokumentu priamo do HTML, JSON alebo emailu

Kódovať PDF v Base64

Base64 je kódovanie, ktoré reprezentuje binárne dáta vo forme ASCII textu (64 znakov: A-Z, a-z, 0-9, plus dva ďalšie znaky). PDF súbor, ktorý je binárny svojou povahou, nemôže byť vložený priamo do HTML emailu, JSON payloadu alebo XML atribútu: musí byť najprv konvertovaný na text. Náš nástroj berie váš PDF súbor a vracia jeho Base64 reprezentáciu, pripravenú na kopírovanie.

Pre detaily o Base64 a Data URI formáte všeobecne, konzultujte náš Base64 textový enkóder, ktorý pokrýva princípy do hĺbky.

Prečo kódovať PDF v Base64?

  • Integrovať PDF do HTML emailu: niektoré mail klienty akceptujú Data URI linky alebo prílohy kódované inline v MIME.
  • Uložiť PDF v textovom poli databázy (TEXT alebo VARCHAR stĺpec), keď aplikačná podmienka zakazuje binárny typ (BLOB).
  • Prenášať PDF v JSON API payloade: JSON nepodporuje binárny, takže každý súbor musí prejsť v Base64.
  • Vložiť PDF do data: URL: zriedkavé použitie, vyhradené pre veľmi malé súbory, pretože URL majú limity dĺžky (typicky 2000 až 8000 znakov podľa prehliadača a servera).

Data URI formát pre PDF

URL typu Data URI vkladá obsah PDF priamo do URL: 

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

Prefix data:application/pdf;base64, indikuje prehliadaču MIME typ a kódovanie. Túto URL môžete vložiť priamo do adresného riadku moderného prehliadača pre otvorenie PDF, alebo ju umiestniť do atribútu src <iframe> alebo <embed>.

Konkrétne prípady použitia

  • Elektronické podpisy: väčšina podpisových API (DocuSign, Yousign, atď.) akceptuje alebo vyžaduje PDF v Base64 v JSON tele požiadavky.
  • Zálohy a archivácia: serializovať PDF v JSON exporte alebo textovom súbore verzionovanom v git (vyhnúť sa pre veľké objemy, ale praktické pre testovacie fixtures).
  • Automatizované testy: integrovať referenčné PDF priamo do unit testu bez závislosti na externom súbore.
  • Klientske exporty: generovať PDF na strane servera, vrátiť ho v Base64 v JSON odpovedi, klient ho dekóduje a stiahne bez dodatočného HTTP volania.

Nevýhody k znalosti

  • Nárast veľkosti: Base64 pridáva približne 33 % k objemu. 1 MB PDF sa stáva reťazcom 1,37 MB v Base64.
  • Žiadny HTTP cache: PDF vložené v Data URI v HTML stránke je znovu stiahnuté pri každom načítaní, na rozdiel od súboru servovaného z klasickej URL s cache hlavičkami.
  • Limity veľkosti: prehliadačová pamäť, maximálna veľkosť POST na strane servera (upload_max_filesize a post_max_size v PHP), a kvóty databázy (veľkosť MySQL riadku, napríklad) môžu byť rýchlo prekročené na objemných PDF.
  • Nevhodné pre veľké súbory: nad niekoľko MB preferujte dedikované úložisko (S3, disk) a prenášajte URL skôr než kódovaný obsah.

Ako nástroj používať

  1. Kliknite na upload pole a vyberte váš PDF súbor.
  2. Nástroj kóduje binárny obsah v Base64 a zobrazuje výsledok.
  3. Môžete si vybrať, či zahrnúť prefix data:application/pdf;base64, alebo nie podľa vášho prípadu použitia (s prefixom pre Data URI, bez prefixu pre JSON payload).
  4. Skopírujte reťazec a vložte ho tam, kde ho potrebujete.

Často kladené otázky

Aká je maximálna akceptovaná veľkosť PDF?

Limit závisí od konfigurácie servera. V praxi zostaňte pod niekoľko MB pre zachovanie plynulého zážitku. Nad tým prehliadač spomalí, schránka saturuje a destinácie (email, JSON, databáza) môžu odmietnuť záťaž.

Je Base64 PDF kompatibilné s mailovými klientmi (Gmail, Outlook)?

Ako príloha kódovaná inline v MIME správe, áno: je to dokonca štandardný mechanizmus elektronickej pošty. Naopak v Data URI v HTML tele správy (<a href="data:..."> alebo <iframe>) väčšina mail klientov blokuje alebo prepisuje tieto URL z bezpečnostných dôvodov. Preferujte klasickú prílohu.

Aký rozdiel od šifrovaného PDF?

Kódovať v Base64 nie je šifrovať: reťazec zostáva čitateľný a triviálne dekódovateľný kýmkoľvek. Šifrované PDF (vlastnícke alebo užívateľské heslo) zostáva šifrované aj po Base64 kódovaní: kódovanie a šifrovanie sú dve nezávislé operácie.

Môžem urobiť opačnú operáciu?

Áno: použite náš PDF Base64 dekóder pre transformáciu Base64 reťazca na stiahnuteľný PDF súbor.

Je moje PDF odosielané na vaše servery?

Kódovanie je spracované na strane servera počas trvania požiadavky, potom je súbor uvoľnený. Žiadne perzistentné úložisko nie je vykonané. Pre obzvlášť citlivé PDF preferujte lokálne spracovanie s offline nástrojom.

Ukážka požiadavky

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

Vstupná schéma

Pole Typ Povinné Predvolené
file file ✓ –

tento nástroj očakáva súbor - použite Content-Type multipart/form-data namiesto application/json

Koncové body

  • GET https://cdrn.fr/api/v1/tools - vypíše všetky dostupné nástroje
  • GET https://cdrn.fr/api/v1/tools/base64-pdf-encoder - získa schému tohto nástroja
  • POST https://cdrn.fr/api/v1/tools/base64-pdf-encoder/execute - spustí tento nástroj s JSON payloadom