Выберите подходящий путь

Кратко

NextPDF предлагает несколько точек входа. Правильный выбор зависит от того, где выполняется ваш код и какой результат в формате Portable Document Format (PDF) вам нужен. Используйте эту страницу, чтобы принять три решения: какой дистрибутив установить, какой обработчик Hypertext Markup Language (HTML) использовать и когда для вашей нагрузки нужен уровень Pro или Enterprise.

Прочитайте раздел, который соответствует вашему вопросу, или сразу посмотрите сводку решений в конце.

Выберите дистрибутив

Начните с того, как ваше приложение обращается к движку. Используйте первую строку, которая подходит для вашей ситуации.

Ваша ситуация	Установка	Почему
Обычный проект на PHP, библиотека или инструмент командной строки (CLI)	Ядро NextPDF (`nextpdf/core`)	Только движок. Он не делает предположений о фреймворке и не запускает службу.
Приложение на Laravel, Symfony или CodeIgniter	Соответствующая интеграция с фреймворком	Поверх ядра вы получаете привязки контейнера, помощники для ответов и задания для очереди.
Служба не на PHP, агент или другая среда выполнения, которым нужно обращаться к движку по сети	Сервер NextPDF (`nextpdf/server`)	Единая служба предоставляет доступ к движку по Model Context Protocol (MCP), REST и gRPC.
Код на Python, которому нужны файлы PDF от NextPDF Server	Python SDK (`pip install nextpdf`)	Типизированный клиент для запущенного сервера. Он не встраивает движок.

Два момента легко упустить:

Интеграция с фреймворком включает ядро. Вы не устанавливаете оба компонента по отдельности. Адаптер сам объявляет и разрешает nextpdf/core.
Python SDK — это клиент, а не движок. Он подключается к конечной точке NextPDF Server. Создание PDF происходит на PHP-сервере.

Выберите обработчик HTML

NextPDF может преобразовывать HTML в PDF четырьмя способами. Встроенный конвейер подходит для большинства документов без дополнительной настройки. Используйте три пакета обработчиков, когда вам нужна браузерная точность макета или нужно подключиться к существующей службе.

Обработчик	Пакет	Где выполняется	Когда выбирать
Встроенный `writeHtml()`	`nextpdf/core`	Внутри процесса, чистый PHP	Вам нужно поддерживаемое подмножество HTML и Cascading Style Sheets (CSS) без браузера и сетевых вызовов.
Artisan	`nextpdf/artisan`	Headless Chrome на хосте	Вам нужна полноценная раскладка Chrome — flexbox, grid, сложные селекторы, веб-шрифты — с выделяемым текстом.
Cloudflare	`nextpdf/cloudflare`	Cloudflare Browser Rendering на периферии сети	Отрисовка должна выполняться на периферии сети или вы не хотите запускать процессы браузера на собственных хостах.
Gotenberg	`nextpdf/gotenberg`	Управляемая вами служба Gotenberg	Вы преобразуете офисные документы (DOCX, XLSX) или HTML через существующее развёртывание Gotenberg.

Как читать таблицу:

Начните со встроенного конвейера. Это самый быстрый путь, и у него нет внешних зависимостей. Прежде чем полагаться на конкретное свойство, сверьте его с матрицей поддержки CSS.
Используйте Artisan, когда макет выходит за пределы поддерживаемого подмножества, а отрисовка должна оставаться в вашей инфраструктуре. Он запускает процесс Chrome, поэтому учитывайте его жизненный цикл.
Используйте Cloudflare, когда вам нужна та же точность браузера и вы предпочитаете отрисовку на периферии сети вместо локальных процессов браузера.
Используйте Gotenberg для преобразования офисных документов или когда вы уже используете Gotenberg и хотите, чтобы NextPDF управлял им.

Когда нужен уровень Pro или Enterprise

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

Что вам нужно	Уровень	Возможность
Наложить на PDF цифровую подпись с базовым профилем PDF Advanced Electronic Signatures (PAdES)	Pro (профессиональный)	Реализации подписания программным ключом.
Создавать архивный вывод PDF/A	Pro (профессиональный)	Соответствие PDF/A и архивные профили.
Встроить электронный счёт (Factur-X / ZUGFeRD)	Pro (профессиональный)	Реализации контракта для электронного счёта.
Подписать с помощью аппаратного модуля безопасности (HSM)	Enterprise (корпоративный)	Операции с ключами на аппаратной основе.
Выпускать квалифицированные электронные подписи	Enterprise (корпоративный)	Рабочий процесс квалифицированной подписи и полный набор средств для соответствия требованиям.

Два правила помогают выбрать без лишнего:

Если на выходе у вас неподписанные, неархивные PDF, ядра достаточно. Лицензия вам не нужна.
Когда вы устанавливаете nextpdf/premium, интеграции с фреймворками и сервер обнаруживают его автоматически. Они предоставляют дополнительные возможности через те же ключи контейнера и каталог инструментов. Чтобы начать пользоваться этими возможностями, менять код приложения не нужно.

Сводка решений

Дистрибутив

Обычный PHP → ядро. Приложение на фреймворке → соответствующая интеграция. Сетевая граница → сервер. Клиент на Python → Python SDK.

Обработчик HTML

Поддерживаемое подмножество, без зависимостей → writeHtml(). Точность браузера на ваших хостах → Artisan. На периферии сети → Cloudflare. Преобразование офисных документов → Gotenberg.

Лицензированный уровень

Неподписанные PDF → ядро. Подпись, PDF/A, электронный счёт → Pro. HSM или квалифицированные подписи → Enterprise.

Всё ещё сомневаетесь?

Установите ядро, пройдите Ваш первый PDF и добавляйте пакет только тогда, когда появится конкретная потребность. Всё это можно изменить позже.

См. также

Установить NextPDF Точная команда для каждого дистрибутива и обработчика.

Ваш первый PDF Создайте PDF из PHP и преобразуйте HTML в PDF.

Интеграции Полная карта расширений, руководство по выбору и руководства по каждому пакету.

Подключение (сервер) Запустите движок как сетевую службу по MCP, REST и gRPC.