Codificare un PDF in Base64

Codificare un PDF in Base64

Il Base64 è una codifica che rappresenta dati binari come testo ASCII (64 caratteri: A-Z, a-z, 0-9, più due caratteri aggiuntivi). Un file PDF, che è binario per natura, non può essere incollato direttamente in un'email HTML, un payload JSON o un attributo XML: deve prima essere convertito in testo. Il nostro strumento prende il vostro file PDF e restituisce la sua rappresentazione Base64, pronta da copiare.

Per i dettagli su Base64 e il formato Data URI in generale, consultate il nostro encoder Base64 testo che copre i principi in profondità.

Perché codificare un PDF in Base64?

• Integrare un PDF in un'email HTML: alcuni client di posta accettano i link Data URI o gli allegati codificati inline in MIME.
• Memorizzare un PDF in un campo di testo di database (colonna TEXT o VARCHAR) quando il vincolo applicativo vieta un tipo binario (BLOB).
• Trasmettere un PDF in un payload JSON di API: JSON non supporta il binario, quindi ogni file deve transitare in Base64.
• Incorporare un PDF in un URL data: uso raro, da riservare a file molto piccoli, perché gli URL hanno limiti di lunghezza (tipicamente da 2000 a 8000 caratteri a seconda del browser e del server).

Formato Data URI per PDF

Un URL di tipo Data URI incorpora il contenuto del PDF direttamente nell'URL:

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

Il prefisso data:application/pdf;base64, indica al browser il tipo MIME e la codifica. Potete incollare questo URL direttamente nella barra degli indirizzi di un browser moderno per aprire il PDF, o inserirlo nell'attributo src di un <iframe> o <embed>.

Casi d'uso concreti

• Firme elettroniche: la maggior parte delle API di firma (DocuSign, Yousign, ecc.) accetta o richiede il PDF in Base64 nel corpo JSON della richiesta.
• Backup e archiviazione: serializzare un PDF in un export JSON o in un file di testo versionato in git (da evitare per grossi volumi, ma pratico per fixture di test).
• Test automatizzati: integrare un PDF di riferimento direttamente in un test unitario senza dipendere da un file esterno.
• Export cliente: generare un PDF lato server, restituirlo in Base64 nella risposta JSON, il client lo decodifica e lo scarica senza chiamata HTTP aggiuntiva.

Inconvenienti da conoscere

• Sovraccarico di dimensione: Base64 aggiunge circa il 33% al volume. Un PDF di 1 MB diventa una stringa di 1,37 MB in Base64.
• Nessuna cache HTTP: un PDF incorporato in Data URI in una pagina HTML viene scaricato di nuovo a ogni caricamento, a differenza di un file servito da un URL classico con header di cache.
• Limiti di dimensione: la memoria del browser, la dimensione massima di un POST lato server (upload_max_filesize e post_max_size in PHP), e le quote del database (dimensione di riga MySQL, per esempio) possono essere rapidamente superate su PDF voluminosi.
• Non adatto a file di grandi dimensioni: oltre qualche MB, preferite uno storage dedicato (S3, disco) e trasmettete un URL piuttosto che il contenuto codificato.

Come usare lo strumento

1. Cliccate sul campo di upload e selezionate il vostro file PDF.
2. Lo strumento codifica il contenuto binario in Base64 e mostra il risultato.
3. Potete scegliere di includere o meno il prefisso data:application/pdf;base64, in base al vostro caso d'uso (con prefisso per una Data URI, senza prefisso per un payload JSON).
4. Copiate la stringa e incollatela dove ne avete bisogno.

Domande frequenti

Esempio di richiesta

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

Schema di input

questo strumento si aspetta un file - utilizzare Content-Type multipart/form-data invece di application/json

Endpoint

• GET https://cdrn.fr/api/v1/tools - elenca tutti gli strumenti disponibili
• GET https://cdrn.fr/api/v1/tools/base64-pdf-encoder - recupera lo schema di questo strumento
• POST https://cdrn.fr/api/v1/tools/base64-pdf-encoder/execute - esegue questo strumento con un payload JSON