Download the PHP package phpsoftbox/pdf without Composer
On this page you can find all versions of the php package phpsoftbox/pdf. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download phpsoftbox/pdf
More information about phpsoftbox/pdf
Files in phpsoftbox/pdf
Package pdf
Short Description PDF rendering component for the PhpSoftBox framework
License MIT
Informations about the package pdf
PhpSoftBox Pdf
Компонент генерации PDF для PhpSoftBox.
Назначение
- рендерить HTML в PDF через Chromium (Gotenberg);
- задавать точные размеры страницы (в т.ч. термоэтикетки);
- отделить движок рендера интерфейсом
PdfRendererInterface; - отдавать PDF и для просмотра в браузере (
inline), и для скачивания (attachment).
Почему Gotenberg
Gotenberg это HTTP-сервис, который использует Chromium для печати HTML в PDF.
Плюсы для нашего кейса:
- современный рендер CSS/HTML (включая
@page, print-стили); - точные размеры листа/этикетки, поля, масштаб;
- отдельный процесс/контейнер, не нагружает PHP-процесс браузерным runtime;
- хорошо масштабируется горизонтально под batch-задачи.
В пакете реализован адаптер:
PhpSoftBox\Pdf\Gotenberg\GotenbergHtmlPdfRenderer- endpoint по умолчанию:
/forms/chromium/convert/html
Зависимости
Пакет зависит только от интерфейсов PSR-18/PSR-17. Реализации — например, phpsoftbox/http-client и
phpsoftbox/http-message (перечислены в suggest).
Безопасность HTML
Chromium в Gotenberg загружает всё, на что ссылается HTML: <img src>, <link href>, <iframe>, fetch() из
скриптов. Если в HTML попадают пользовательские данные без экранирования, через документ можно запросить внутренние
адреса сети (SSRF) или локальные файлы контейнера Gotenberg (file://). Поэтому:
- экранируйте все данные в шаблонах (
html()/htmlspecialchars), не вставляйте пользовательские URL вsrc/hrefбез проверки схемы и хоста; - ограничьте Gotenberg на уровне сервиса:
--chromium-deny-list(по умолчанию запрещаетfile://кроме/tmp),--chromium-allow-listс нужными адресами, при необходимости--chromium-disable-javascript=true; держите Gotenberg в изолированной сети без доступа к внутренним сервисам; - ресурсы (шрифты, изображения, CSS) лучше встраивать в HTML (
data:URI, inline-стили).
Текст ошибки Gotenberg (тело ответа) попадает в сообщение PdfRenderException.
Быстрый старт
Хелпер для этикеток:
Возврат PDF в HTTP-ответ
Для этого есть PdfHttpResponder.
Компонент сам выставляет:
Content-Type;Content-Length;Content-Disposition(inlineилиattachment);Cache-Control.
Большие batch-задачи (1000+ страниц)
Рекомендуемая стратегия:
- Генерировать PDF в фоне через очередь (
Queue), не в HTTP-запросе. - Делить задание на чанки по страницам/этикеткам.
- Сохранять каждый чанк как отдельный PDF в Storage.
- По завершении формировать индекс/архив или выдавать ссылки на части.
Для разбиения по диапазонам страниц есть:
PdfChunkPlanner::split(totalPages, pagesPerChunk).
Пример:
Тестовые артефакты PDF
В пакете предусмотрен каталог для артефактов интеграционных тестов:
local/tests/pdf
Он уже настроен через .gitignore, поэтому бинарные PDF не попадут в git.
Чтобы включить сохранение артефактов в интеграционных тестах:
Рекомендации для термопечати
- Всегда явно задавайте
PdfPageSizeиPdfMargins. - Отключайте лишние отступы в CSS и используйте print-стили.
- Для пиксельной точности этикеток тестируйте шаблон на целевом принтере.
All versions of pdf with dependencies
psr/http-client Version ^1.0
psr/http-factory Version ^1.0
psr/http-message Version ^2.0