Руководства

Краткий обзор

Эта страница поможет найти нужное руководство NextPDF. NextPDF — это headless-движок Portable Document Format 2.0 (PDF 2.0) на PHP 8.4. Каждая плитка открывает узел раздела, а не отдельную страницу. Выберите отправную точку, затем переходите по ссылкам внутри этого узла.

Руководства объясняют как и почему. Если нужен практический рецепт, готовый к копированию, используйте сборник рецептов. Для проверенной поверхности интерфейса прикладного программирования (API) и матриц поддержки используйте справочник.

Руководства по интеграции

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

Интеграции Адаптеры фреймворков (Laravel, Symfony, CodeIgniter), мосты отрисовщиков (Artisan, Cloudflare, Gotenberg), прослойка совместимости с TCPDF и Backport Builder. Сначала прочитайте карту расширений и руководство по выбору.

Миграция Перенос существующей кодовой базы на NextPDF. Отдельные руководства для dompdf и mPDF, а также единое правило, общее для всех руководств: совместимое поведение, а не побайтово идентичный вывод, с задокументированными различиями.

Сервер и SDK

Используйте эти руководства, когда вызывающие стороны находятся удалённо, написаны на другом языке или являются системами искусственного интеллекта (ИИ), которым нужна конечная точка инструмента вместо библиотеки PHP.

NextPDF Connect (сервер) Пакет nextpdf/server: детерминированный реестр PDF-инструментов, предоставляемый по протоколу Model Context Protocol (MCP), Representational State Transfer (REST) и gRPC за шлюзом подтверждения с участием человека. Установка, настройка и развёртывание.

Python SDK Готовое к цитированию извлечение данных из PDF для приложений на Python, агентов и командной строки на базе конечной точки NextPDF Connect. Установите с помощью pip install nextpdf, затем направьте клиента на свой сервер.

Стандарты и соответствие

NextPDF Core ориентируется на структуры, требуемые стандартами. Решение о соответствии принимает внешний валидатор, средство проверки или принимающий орган. Каждая страница о соответствии связывает свои утверждения с конкретным пунктом и явно обозначает эту границу.

Соответствие Стандартные профили, на которые ориентируется NextPDF: PDF 2.0 (ISO 32000-2), PDF/A-4 (ISO 19005-4) для архивного хранения, PDF/UA-2 (ISO 14289-2) для доступности, PDF/X для типографской печати и ZUGFeRD / Factur-X для электронного выставления счетов.

Сопоставление с базовыми уровнями PAdES Как NextPDF сопоставляется с базовыми уровнями ETSI EN 319 142 PAdES — B-B, B-T, B-LT и B-LTA, разделяя поверхность подписания Core и уровни Premium и Enterprise.

Эксплуатация и расширение

Используйте эти руководства, чтобы безопасно запускать NextPDF в рабочей среде, диагностировать сбои и создавать решения на основе публичной поверхности расширений.

Доверие и безопасность Инженерный подход основного движка к безопасности: модель угроз, модель безопасности подписи и шифрования, поведение при обработке данных и политика раскрытия уязвимостей, с обозначением границ каждого из них.

Устранение неполадок Записи в формате «симптом — решение» для сбоев подписи, PDF/A, PDF/UA, шрифтов, тегирования, шифрования и разрешений, основанные на собственной таксономии исключений движка.

Разработка расширений Публичный интерфейс поставщика услуг (Service Provider Interface, SPI): что можно расширять, какая гарантия стабильности за этим стоит, пользовательские шрифты, пользовательские движки макета, триггеры действий и контракт поставщика Key Management Service (KMS).

Premium (Pro и Enterprise) Что NextPDF Pro и Enterprise добавляют по сравнению с открытым ядром: матрица возможностей, соответствие стандартам, валидация HSM и FIPS, а также лицензирование. Переход на коммерческую редакцию не требует изменения кода приложения.

Концепции

Раздел Insider_ объясняет, почему NextPDF ведёт себя именно так. Он показывает архитектуру глазами ведущего инженера и помечает каждое утверждение по типу данных, которые его подтверждают.

Концепции (Insider_) Философия проектирования, ландшафт стандартов, конвейер обработки HTML, подписание и долгосрочная валидация, шрифты, генерация больших объёмов и подход к тестированию. Начните отсюда, чтобы понять логику работы движка.

См. также

Сборник рецептов — практические рецепты для PHP, Connect и интеграций, готовые к копированию.
Справочник — проверенная поверхность API и матрица поддержки Cascading Style Sheets (CSS).
Глоссарий — термины из этой документации с определениями в одном месте.