CDRN

Zakoduj PDF do Base64

  • Panel
  • Dokumentacja
  • API
konwertuje PDF do ciągu Base64 / Data URI, idealne do osadzania dokumentu bezpośrednio w HTML, JSON lub e-mailu

Kodowanie PDF w Base64

Base64 to kodowanie reprezentujące dane binarne w postaci tekstu ASCII (64 znaki: A-Z, a-z, 0-9 plus dwa dodatkowe znaki). Plik PDF, który z natury jest binarny, nie może być wklejony bezpośrednio do wiadomości HTML, ładunku JSON ani atrybutu XML: najpierw musi zostać przekonwertowany na tekst. Nasze narzędzie pobiera twój plik PDF i zwraca jego reprezentację Base64, gotową do skopiowania.

Szczegóły dotyczące Base64 i ogólnego formatu Data URI znajdziesz w naszym enkoderze Base64 tekst, który dogłębnie obejmuje te zasady.

Dlaczego kodować PDF w Base64?

  • Osadzenie PDF w wiadomości HTML: niektóre klienty pocztowe akceptują linki Data URI lub załączniki kodowane inline w MIME.
  • Przechowywanie PDF w polu tekstowym bazy danych (kolumna TEXT lub VARCHAR), gdy ograniczenie aplikacyjne zabrania typu binarnego (BLOB).
  • Przesyłanie PDF w ładunku JSON API: JSON nie obsługuje danych binarnych, więc każdy plik musi być przesłany w Base64.
  • Osadzenie PDF w URL data: rzadkie zastosowanie, zarezerwowane dla bardzo małych plików, ponieważ URL mają ograniczenia długości (zazwyczaj od 2000 do 8000 znaków w zależności od przeglądarki i serwera).

Format Data URI dla PDF

URL typu Data URI osadza zawartość PDF bezpośrednio w URL: 

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

Prefiks data:application/pdf;base64, wskazuje przeglądarce typ MIME i kodowanie. Możesz wkleić ten URL bezpośrednio w pasku adresu nowoczesnej przeglądarki, aby otworzyć PDF, lub umieścić go w atrybucie src elementu <iframe> lub <embed>.

Konkretne przypadki użycia

  • Podpisy elektroniczne: większość API podpisów (DocuSign, Yousign itp.) akceptuje lub wymaga PDF w Base64 w treści JSON żądania.
  • Kopie zapasowe i archiwizacja: serializacja PDF w eksport JSON lub plik tekstowy wersjonowany w git (do uniknięcia dla dużych ilości, ale praktyczne dla danych testowych).
  • Testy automatyczne: osadzenie referencyjnego PDF bezpośrednio w teście jednostkowym bez zależności od zewnętrznego pliku.
  • Eksporty klienta: generowanie PDF po stronie serwera, zwracanie go w Base64 w odpowiedzi JSON, klient go dekoduje i pobiera bez dodatkowego wywołania HTTP.

Wady do poznania

  • Zwiększenie rozmiaru: Base64 dodaje około 33% do objętości. PDF o rozmiarze 1 MB staje się ciągiem 1,37 MB w Base64.
  • Brak pamięci podręcznej HTTP: PDF osadzony w Data URI w stronie HTML jest ponownie pobierany przy każdym ładowaniu, w przeciwieństwie do pliku serwowanego z klasycznego URL z nagłówkami pamięci podręcznej.
  • Ograniczenia rozmiaru: pamięć przeglądarki, maksymalny rozmiar POST po stronie serwera (upload_max_filesize i post_max_size w PHP) oraz limity bazy danych (na przykład rozmiar wiersza MySQL) mogą zostać szybko przekroczone dla dużych PDF.
  • Nieodpowiednie dla dużych plików: powyżej kilku MB preferuj dedykowane przechowywanie (S3, dysk) i przekazuj URL zamiast zakodowanej zawartości.

Jak korzystać z narzędzia

  1. Kliknij pole przesyłania i wybierz swój plik PDF.
  2. Narzędzie koduje binarną zawartość w Base64 i wyświetla wynik.
  3. Możesz wybrać, czy dołączyć prefiks data:application/pdf;base64, w zależności od twojego przypadku użycia (z prefiksem dla Data URI, bez prefiksu dla ładunku JSON).
  4. Skopiuj ciąg i wklej go tam, gdzie tego potrzebujesz.

Najczęściej zadawane pytania

Jaki jest maksymalny akceptowany rozmiar PDF?

Limit zależy od konfiguracji serwera. W praktyce pozostań poniżej kilku MB, aby zachować płynne doświadczenie. Powyżej tego przeglądarka zwalnia, schowek nasyca się, a miejsca docelowe (e-mail, JSON, baza danych) mogą odrzucić ładunek.

Czy PDF w Base64 jest zgodny z klientami pocztowymi (Gmail, Outlook)?

Jako załącznik zakodowany inline w wiadomości MIME, tak: to nawet standardowy mechanizm poczty elektronicznej. Natomiast jako Data URI w treści HTML wiadomości (<a href="data:..."> lub <iframe>) większość klientów pocztowych blokuje lub przepisuje te URL ze względów bezpieczeństwa. Preferuj klasyczny załącznik.

Jaka jest różnica w stosunku do zaszyfrowanego PDF?

Kodowanie w Base64 to nie szyfrowanie: ciąg pozostaje czytelny i banalny do zdekodowania przez kogokolwiek. Zaszyfrowany PDF (hasło właściciela lub użytkownika) pozostaje zaszyfrowany nawet po zakodowaniu Base64: kodowanie i szyfrowanie to dwie niezależne operacje.

Czy mogę wykonać operację odwrotną?

Tak: użyj naszego dekodera PDF Base64, aby przekształcić ciąg Base64 w plik PDF do pobrania.

Czy mój PDF jest wysyłany na wasze serwery?

Kodowanie jest przetwarzane po stronie serwera przez czas trwania żądania, a następnie plik jest zwalniany. Nie jest wykonywane żadne trwałe przechowywanie. Dla szczególnie wrażliwych PDF preferuj lokalne przetwarzanie za pomocą narzędzia offline.

Przykładowe zapytanie

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

Schemat wejściowy

Pole Typ Wymagane Domyślnie
file file ✓ –

to narzędzie wymaga pliku - użyj Content-Type multipart/form-data zamiast application/json

Punkty końcowe

  • GET https://cdrn.fr/api/v1/tools - lista wszystkich dostępnych narzędzi
  • GET https://cdrn.fr/api/v1/tools/base64-pdf-encoder - zwraca schemat dla tego narzędzia
  • POST https://cdrn.fr/api/v1/tools/base64-pdf-encoder/execute - uruchamia to narzędzie z payloadem JSON