Начало работы с NextPDF

Коротко о главном

NextPDF — это движок на PHP 8.4, который создаёт и анализирует документы Portable Document Format (PDF) 2.0 — формат файлов, определённый стандартом ISO 32000-2. Документ создаётся через типизированный fluent API. Можно отрисовывать страницы из Hypertext Markup Language (HTML) и Cascading Style Sheets (CSS). Результат можно подписывать и архивировать, а структурированное содержимое — считывать обратно. Всё это работает на PHP, и для основных сценариев не нужны внешние исполняемые файлы.

Проект поставляется в четырёх дистрибутивах, включая программное обеспечение с открытым исходным кодом (OSS) и лицензируемые редакции. В их основе лежит один и тот же движок, поэтому установите тот, который подходит под ваш способ работы.

Дистрибутив	Пакет	Когда устанавливать
NextPDF Core — ядро (OSS)	`nextpdf/core`	Вы пишете на PHP и хотите получить прямой доступ к движку — с фреймворком или без него.
NextPDF Server — сервер (OSS)	`nextpdf/server`	Вам нужен отдельный сервис, который предоставляет движок через Model Context Protocol (MCP), Representational State Transfer (REST) и gRPC.
NextPDF Pro — редакция Pro	`nextpdf/premium` (редакция Pro)	Вам нужны цифровая подпись, архивирование в PDF/A или формирование электронных счетов.
NextPDF Enterprise — редакция Enterprise	`nextpdf/premium` (редакция Enterprise)	Вам нужны аппаратная подпись, квалифицированные подписи и полное покрытие требований соответствия.

NextPDF Pro и NextPDF Enterprise — это лицензируемые редакции одного и того же пакета nextpdf/premium. Основной движок ведёт себя одинаково независимо от того, установлен этот пакет или нет.

Установка в одну строку

В обычном PHP-проекте установите основной движок с помощью Composer.

composer require nextpdf/core

Этот единственный пакет создаёт и анализирует PDF без дополнительной настройки. Интеграции с фреймворками, обработчики HTML, сервер и комплект средств разработки (SDK) для Python добавляют поверх него по одному пакету. В руководстве по установке перечислены все команды.

Выберите свой путь

NextPDF вписывается в ваш существующий код. Выберите точку входа, подходящую для вашего стека, и откройте её карточку.

Установка Полная матрица установки: ядро, интеграции с фреймворками, обработчики HTML, сервер и SDK для Python.

Ваш первый PDF Короткое руководство, в котором сначала создаётся PDF из PHP, а затем HTML отрисовывается в PDF.

Выберите свой путь Руководство по выбору между ядром, фреймворком и сервером, а также по тому, какой обработчик HTML использовать.

Интеграции Адаптеры для фреймворков, браузерные обработчики, граничные сервисы и пакеты для миграции.

Что дальше

После того как создадите первый документ, обращайтесь к этим трём основным разделам документации.

Руководства и интеграции Работайте с пакетом, который соответствует вашему фреймворку, обработчику, среде выполнения или цели миграции — Laravel, Symfony, CodeIgniter, Artisan, Cloudflare и Gotenberg.

Справочник по API Проверенная поверхность движка: классы, методы, ключи конфигурации и матрица поддержки CSS.

Сборник рецептов Рецепты под конкретные задачи — отрисовка HTML в PDF, оформление через CSS, компоновка таблиц и разбиение длинного содержимого на страницы.

Зачем нужен отдельный сервер?

Установите NextPDF Server, когда сервису, написанному не на PHP, агенту или другой среде выполнения нужно вызывать движок по сетевому протоколу, а не подключаться к библиотеке. SDK для Python — это типизированный клиент для этого сервера.