Кодиране на PDF в Base64
- Табло
- Документация
- API
Кодер към PDF и Base64
Base64 е кодиране, което представя двоичните данни като текст ASCII (64 знака: A-Z, a-z, 0-9, плюс два допълнителни знака). PDF файл, който е двоичен по природа не може да бъде поставен директно в HTML имейл, JSON полезен товар или a XML атрибут: първо трябва да бъде преобразуван в текст. Нашият инструмент взема вашите PDF файл и връща неговото Base64 представяне, готово за копиране.
За подробности относно Base64 и Data URI формата като цяло вижте нашия кодер на текст Base64, който обхваща принципите в дълбочина.
Защо да кодирате PDF в Base64?
- Вграждане на PDF в HTML имейл: някои имейл клиенти приемат връзки URI на данни или вградени MIME кодирани прикачени файлове.
- Съхранявайте PDF в текстово поле на база данни (колона
TEXTилиVARCHAR), когато ограничението на приложението забранява двоичен тип (BLOB). - Предаване на PDF в API JSON полезен товар: JSON не поддържа двоичен код, следователно всеки файл трябва да премине през Base64.
- Вграждане на PDF в URL адрес на данни: рядко използване, запазено за много млади хора файлове, тъй като URL адресите имат ограничения за дължина (обикновено от 2000 до 8000 знака в зависимост от браузъра и сървъра).
Форматиране на URI данни за PDF
URL адрес от тип URI на данни вгражда съдържанието на PDF файла директно в URL адреса:
data:application/pdf;base64,JVBERi0xLjQKJcfsj6IKNSAwIG9iago8PC9MZW5ndGggNiAwIFI...
Префиксът data:application/pdf;base64, указва на браузъра MIME типа и кодирането.
Можете да поставите този URL директно в адресната лента на модерен браузър, за да го отворите
PDF файла или го поставете в атрибута src на или
.
Конкретни случаи на употреба
- Електронни подписи: повечето API за подписи (DocuSign, Yousign и т.н.) приемат или изискват Base64 PDF в JSON тялото на заявката.
- Архивиране и архивиране: сериализирайте PDF в JSON експорт или файл текст с версии в git (да се избягва за големи обеми, но практично за фиксиране на тест).
- Автоматизирани тестове: интегрирайте референтен PDF директно в тест единица, без да зависи от външен файл.
- Клиентски експорти: генерирайте PDF от страната на сървъра, върнете го в Base64 в JSON отговор, клиентът го декодира и го изтегля без допълнително HTTP извикване.
Недостатъци, които трябва да знаете
- Разход за размер: Base64 добавя приблизително 33% към обема. 1 MB PDF става 1,37 MB низ в Base64.
- Няма HTTP кеш: PDF файл, вграден в Data URI в HTML страница, е изтегля се повторно при всяко зареждане, за разлика от файл, сервиран от класически URL адрес със заглавки на кеша.
- Ограничения на размера: памет на браузъра, максимален размер на POST страна
сървър (
upload_max_filesizeиpost_max_sizeв PHP) и квоти на базата данни (размер на ред в MySQL, например) може бързо да бъде надвишен на Голям PDF. - Не е подходящо за големи файлове: над няколко MB, предпочитайте съхранение предназначени (S3, диск) и предават URL вместо кодираното съдържание.
Как да използвате инструмента
- Щракнете върху полето за качване и изберете своя PDF файл.
- Инструментът кодира двоичното съдържание в Base64 и показва резултата.
- Можете да изберете дали да включите префикса
data:application/pdf;base64,в зависимост от вашия случай на използване (с префикс за URI на данни, без префикс за JSON полезен товар). - Копирайте низа и го поставете където имате нужда.
Често задавани въпроси
Какъв е максималният допустим размер на PDF?
Ограничението зависи от конфигурацията на сървъра. На практика останете под няколко MB, за да запазите безпроблемно изживяване. Освен това браузърът се забавя, клипбордът се насища и дестинации (имейл, JSON, база данни) могат да отхвърлят полезния товар.
подробности>Съвместим ли е Base64 PDF с имейл клиенти (Gmail, Outlook)?
Като вграден кодиран прикачен файл в MIME съобщение, да: това е дори механизмът
имейл стандарт. От друга страна, в Data URI в HTML тялото на съобщение
( или ), повечето клиенти
пощата блокира или пренаписва тези URL адреси от съображения за сигурност. Предпочитам прикачване
класически.
Каква е разликата с шифрования PDF?
Кодирането в Base64 не е криптирано: низът остава четим и тривиален за декодиране от всеки. Остава шифрован PDF (парола на собственик или потребител). криптирани дори след кодиране на Base64: кодирането и криптирането са две операции независима.
подробности>Мога ли да направя обратното?
Да: използвайте нашия Base64 PDF декодер за трансформирайте Base64 низ в PDF файл за изтегляне.
подробности>Изпраща ли се моят PDF до вашите сървъри?
Кодирането се обработва от страната на сървъра за времетраенето на заявката, след което файлът се освобождава. Няма не се извършва постоянно съхранение. За особено чувствителни PDF файлове изберете a локална обработка с офлайн инструмент.
подробности>Пример за заявка
curl -X POST https://cdrn.fr/api/v1/tools/base64-pdf-encoder/execute \
-F "file=@/path/to/file"
Входна схема
| Поле | Тип | Задължително | По подразбиране |
|---|---|---|---|
file |
file | ✓ | – |
този инструмент очаква файл - използвайте Content-Type multipart/form-data вместо application/json
Крайни точки
GET https://cdrn.fr/api/v1/tools- изброява всички достъпни инструментиGET https://cdrn.fr/api/v1/tools/base64-pdf-encoder- извлича схемата на този инструментPOST https://cdrn.fr/api/v1/tools/base64-pdf-encoder/execute- изпълнява този инструмент с JSON payload