CDRN

Zakódovat PDF do Base64

  • Dashboard
  • Dokumentace
  • API
převede PDF na řetězec Base64 / Data URI, ideální pro vložení dokumentu přímo do HTML, JSON nebo emailu

Kódovat PDF do Base64

Base64 je kódování, které reprezentuje binární data ve formě ASCII textu (64 znaků: A-Z, a-z, 0-9, plus dva dodatečné znaky). PDF soubor, který je binární svou povahou, nelze vložit přímo do HTML emailu, JSON payload nebo XML atributu: musí být nejprve převeden na text. Náš nástroj vezme váš PDF soubor a vrátí jeho Base64 reprezentaci, připravenou ke kopírování.

Pro detaily o Base64 a Data URI formátu obecně se podívejte na náš enkodér Base64 textu, který pokrývá principy do hloubky.

Proč kódovat PDF do Base64?

  • Integrovat PDF do HTML emailu: některé emailové klienty přijímají Data URI odkazy nebo přílohy kódované inline v MIME.
  • Uložit PDF do textového pole databáze (sloupec TEXT nebo VARCHAR), když aplikační omezení zakazuje binární typ (BLOB).
  • Přenést PDF v JSON payload API: JSON nepodporuje binární data, takže každý soubor musí procházet v Base64.
  • Vložit PDF do data: URL vzácné použití, vyhrazené velmi malým souborům, protože URL mají délkové limity (typicky 2000 až 8000 znaků podle prohlížeče a serveru).

Data URI formát pro PDF

URL typu Data URI vkládá obsah PDF přímo do URL: 

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

Předpona data:application/pdf;base64, indikuje prohlížeči MIME typ a kódování. Tuto URL můžete vložit přímo do adresního řádku moderního prohlížeče pro otevření PDF, nebo ji umístit do atributu src tagu <iframe> nebo <embed>.

Konkrétní případy použití

  • Elektronické podpisy: většina podpisových API (DocuSign, Yousign, atd.) přijímá nebo vyžaduje PDF v Base64 v JSON těle požadavku.
  • Zálohy a archivace: serializovat PDF v JSON exportu nebo textovém souboru verzovaném v gitu (vyhnout se pro velké objemy, ale praktické pro testovací fixtures).
  • Automatizované testy: integrovat referenční PDF přímo do unit testu bez závislosti na externím souboru.
  • Klientské exporty: vygenerovat PDF na straně serveru, vrátit ho v Base64 v JSON odpovědi, klient ho dekóduje a stáhne bez dalšího HTTP volání.

Nevýhody, které je třeba znát

  • Náklad na velikost: Base64 přidává asi 33 % k objemu. PDF o 1 MB se v Base64 stane řetězcem o 1,37 MB.
  • Žádné HTTP cache: PDF vložené v Data URI v HTML stránce je znovu staženo při každém načtení, na rozdíl od souboru servírovaného z klasické URL s cache hlavičkami.
  • Velikostní limity: paměť prohlížeče, maximální velikost POST na straně serveru (upload_max_filesize a post_max_size v PHP), a kvóty databáze (velikost řádku MySQL, například) mohou být rychle překročeny na objemných PDF.
  • Nevhodné pro velké soubory: nad několik MB preferujte dedikované úložiště (S3, disk) a přenášejte URL místo kódovaného obsahu.

Jak nástroj používat

  1. Klikněte na upload pole a vyberte svůj PDF soubor.
  2. Nástroj kóduje binární obsah do Base64 a zobrazí výsledek.
  3. Můžete zvolit, zda zahrnout nebo ne předponu data:application/pdf;base64, podle vašeho případu použití (s předponou pro Data URI, bez předpony pro JSON payload).
  4. Zkopírujte řetězec a vložte ho tam, kde ho potřebujete.

Často kladené otázky

Jaká je maximální přijatelná velikost PDF?

Limit závisí na konfiguraci serveru. V praxi zůstaňte pod několika MB pro zachování plynulého zážitku. Nad to prohlížeč zpomaluje, schránka saturuje, a cíle (email, JSON, databáze) riskují odmítnutí nákladu.

Je Base64 PDF kompatibilní s emailovými klienty (Gmail, Outlook)?

Jako příloha kódovaná inline v MIME zprávě ano: je to dokonce standardní mechanismus elektronické pošty. Naproti tomu v Data URI v HTML těle zprávy (<a href="data:..."> nebo <iframe>) většina emailových klientů blokuje nebo přepisuje tyto URL z bezpečnostních důvodů. Preferujte klasickou přílohu.

Jaký je rozdíl od šifrovaného PDF?

Kódovat v Base64 není šifrovat: řetězec zůstává čitelný a triviálně dekódovatelný kýmkoli. Šifrované PDF (vlastnické heslo nebo uživatelské) zůstává šifrované i po Base64 kódování: kódování a šifrování jsou dvě nezávislé operace.

Mohu udělat opačnou operaci?

Ano: použijte náš dekodér Base64 PDF pro převod Base64 řetězce na stažitelný PDF soubor.

Je mé PDF odesíláno na vaše servery?

Kódování je zpracováno na straně serveru po dobu požadavku, pak je soubor uvolněn. Žádné trvalé úložiště není provedeno. Pro zvláště citlivá PDF preferujte lokální zpracování offline nástrojem.

Ukázka požadavku

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

Vstupní schéma

Pole Typ Povinné Výchozí
file file ✓ –

tento nástroj očekává soubor - použijte Content-Type multipart/form-data místo application/json

Koncové body

  • GET https://cdrn.fr/api/v1/tools - vypíše všechny dostupné nástroje
  • GET https://cdrn.fr/api/v1/tools/base64-pdf-encoder - získá schéma tohoto nástroje
  • POST https://cdrn.fr/api/v1/tools/base64-pdf-encoder/execute - spustí tento nástroj s JSON payloadem