Kod en PDF til Base64
- Dashboard
- Dokumentation
- API
Encoder til PDF og Base64
Base64 er en kodning, der repræsenterer binære data som tekst ASCII (64 tegn: A-Z, a-z, 0-9, plus to ekstra tegn). En PDF-fil, dvs binær af natur, kan ikke indsættes direkte i en HTML-e-mail, en JSON-nyttelast eller en XML-attribut: den skal først konverteres til tekst. Vores værktøj tager din PDF-fil og returnerer sin Base64-repræsentation, klar til at kopiere.
For detaljer om Base64 og Data URI-formatet generelt, se vores Base64-tekstkoder som dækker principperne i dybde.
Hvorfor kode en PDF i Base64?
- Integrer en PDF i en HTML-e-mail: Nogle e-mail-klienter accepterer links Data URI eller inline MIME-kodede vedhæftede filer.
- Gem en PDF i et databasetekstfelt (kolonnen
TEXTellerVARCHAR), når applikationsbegrænsningen forbyder en binær type (BLOB). - Send en PDF i en API JSON nyttelast: JSON understøtter ikke binær, derfor skal enhver fil passere gennem Base64.
- Indlejring af en PDF i en data-URL: sjældent brug, forbeholdt meget unge mennesker filer, fordi URL'er har længdegrænser (typisk 2000 til 8000 tegn afhængig af browser og server).
Formater data-URI til PDF
En URL af typen Data URI indlejrer indholdet af PDF'en direkte i URL'en:
data:application/pdf;base64,JVBERi0xLjQKJcfsj6IKNSAwIG9iago8PC9MZW5ndGggNiAwIFI...
Præfikset data:application/pdf;base64, fortæller browseren MIME-typen og -kodningen.
Du kan indsætte denne URL direkte i adresselinjen i en moderne browser for at åbne
PDF-filen, eller placer den i src-attributten for en eller
.
Konkrete use cases
- Elektroniske signaturer: de fleste signatur-API'er (DocuSign, Du underskriver osv.) accepterer eller kræver Base64 PDF'en i JSON-teksten i anmodningen.
- Sikkerhedskopier og arkivering: Serialiser en PDF til en JSON-eksport eller fil tekst versioneret i git (skal undgås for store mængder, men praktisk til inventar af test).
- Automatiske tests: Integrer en reference-PDF direkte i en test enhed uden at være afhængig af en ekstern fil.
- Klienteksport: generer en PDF på serversiden, returner den i Base64 i JSON-svar, afkoder klienten det og downloader det uden yderligere HTTP-kald.
Ulemper at være opmærksom på
- Størrelsesomkostninger: Base64 tilføjer ca. 33 % til lydstyrken. En 1 MB PDF bliver en 1,37 MB streng i Base64.
- Ingen HTTP-cache: en PDF, der er indlejret i data-URI på en HTML-side, er gendownloades ved hver indlæsning, i modsætning til en fil, der serveres fra en klassisk URL med cacheoverskrifter.
- Størrelsesgrænser: browserhukommelse, maksimal størrelse på en POST-side
server (
upload_max_filesizeogpost_max_sizei PHP) og kvoter af databasen (MySQL rækkestørrelse, f.eks.) kan hurtigt overskrides på Stor PDF. - Ikke egnet til store filer: ud over et par MB, foretrækker lagerplads dedikeret (S3, disk) og videregive en URL i stedet for det kodede indhold.
Sådan bruger du værktøjet
- Klik på upload-feltet, og vælg din PDF-fil.
- Værktøjet koder det binære indhold i Base64 og viser resultatet.
- Du kan vælge, om du vil inkludere præfikset
data:application/pdf;base64,afhængigt af dit use case (med præfiks for en data-URI, uden præfiks for en JSON-nyttelast). - Kopiér strengen, og indsæt den, hvor du har brug for den.
Ofte stillede spørgsmål
Hvad er den maksimalt accepterede PDF-størrelse?
Grænsen afhænger af serverkonfigurationen. I praksis skal du holde dig under et par MB for at beholde en problemfri oplevelse. Ud over det sænker browseren farten, udklipsholderen mættes, og den destinationer (e-mail, JSON, database) kan afvise nyttelasten.
Er Base64 PDF kompatibel med e-mail-klienter (Gmail, Outlook)?
Som en inline-kodet vedhæftet fil i en MIME-besked, ja: det er endda mekanismen
e-mail standard. På den anden side i Data URI i HTML-brødteksten i en meddelelse
( eller ), de fleste kunder
mail blokerer eller omskriver disse URL'er af sikkerhedsmæssige årsager. Foretrækker vedhæftning
klassisk.
Hvad er forskellen med en krypteret PDF?
Kodning i Base64 er ikke krypteret: strengen forbliver læsbar og triviel for afkode af enhver. En krypteret PDF (ejer- eller brugeradgangskode) forbliver krypteret selv efter Base64-kodning: kodning og kryptering er to operationer uafhængig.
Kan jeg gøre det omvendte?
Ja: brug vores Base64 PDF-dekoder til at transformer en Base64-streng til en PDF-fil, der kan downloades.
Er min PDF sendt til dine servere?
Kodningen behandles på serversiden i løbet af anmodningen, hvorefter filen frigives. Ingen vedvarende lagring udføres ikke. For særligt følsomme PDF-filer skal du vælge en lokal behandling med et offlineværktøj.
Anmodningseksempel
curl -X POST https://cdrn.fr/api/v1/tools/base64-pdf-encoder/execute \
-F "file=@/path/to/file"
Inputskema
| Felt | Type | Påkrævet | Standard |
|---|---|---|---|
file |
file | ✓ | – |
dette værktøj forventer en fil - brug Content-Type multipart/form-data i stedet for application/json
Endpoints
GET https://cdrn.fr/api/v1/tools- lister alle tilgængelige værktøjerGET https://cdrn.fr/api/v1/tools/base64-pdf-encoder- henter skemaet for dette værktøjPOST https://cdrn.fr/api/v1/tools/base64-pdf-encoder/execute- udfører dette værktøj med et JSON-payload