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

Кратко

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-сервере.

Библиотека или служба?

Если PHP-приложение может подключить библиотеку, используйте ядро или интеграцию с фреймворком. Так у вас на один процесс меньше и минимальная задержка. Используйте сервер, когда движок нужен коду не на 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 управлял им.

Обработчики расширяют поверхность угроз

По умолчанию встроенный конвейер не выполняет скрипты и не загружает удалённые ресурсы. Artisan, Cloudflare и Gotenberg выполняют отрисовку через браузер или сетевую службу. Считайте HTML недоверенным и прочитайте страницу о безопасности и эксплуатации каждого пакета, прежде чем передавать входные данные, на которые может влиять пользователь.

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

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

Ядро уже подписывает на базовых уровнях B-B и B-T стандарта PDF Advanced Electronic Signatures (PAdES) с помощью программных ключей. Лицензированные уровни начинаются там, где заканчиваются базовые.

Что вам нужно	Уровень	Возможность
Запускать продвинутые рабочие процессы подписания: удалённое, через облачный KMS или последовательное подписание	Pro (профессиональный)	Реализации рабочих процессов подписания поверх базовых уровней ядра B-B / B-T.
Создавать архивный вывод PDF/A	Enterprise (корпоративный)	Соответствие PDF/A и архивные профили.
Встроить электронный счёт (Factur-X / ZUGFeRD)	Pro (профессиональный)	Реализации контракта для электронного счёта.
Сохранять действительность подписей в долгосрочной перспективе с помощью PAdES B-LT / B-LTA	Enterprise (корпоративный)	Document Security Store и метки времени документа для архивной действительности.
Подписать с помощью аппаратного модуля безопасности (HSM)	Enterprise (корпоративный)	Операции с ключами на аппаратной основе.
Выпускать квалифицированные электронные подписи	Enterprise (корпоративный)	Рабочий процесс квалифицированной подписи и полный набор средств для соответствия требованиям.

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

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

Покупка Pro или Enterprise

Когда вам действительно нужен лицензированный уровень, коммерческие лицензии продаются через нашего Merchant of Record (продавца, официально оформляющего ваш заказ) — авторизованного реселлера, который выступает официальным продавцом по вашему заказу, — а лицензию предоставляет PATEON на условиях лицензионного соглашения с конечным пользователем (End-User License Agreement, EULA). Вы начинаете на портале лицензий, а мы подключаем вас через оформление покупки нашего Merchant of Record, где обрабатываются цена, любые налоги и ваш счёт.

Полный путь, модель из двух договоров (покупка и лицензия) и к кому обращаться по вопросам выставления счетов и по вопросам продукта см. в разделе Покупка и лицензирование.

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

Дистрибутив

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

Обработчик HTML

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

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

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

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

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

См. также

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

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

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

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