Сборник рецептов

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

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

Если хотите понять, почему движок ведёт себя определённым образом, лучше откройте раздел “Руководства”. Чтобы изучить проверенный API, откройте раздел “Справочник”.

Один пример — одна среда выполнения

Каждый рецепт рассчитан на одну среду выполнения. Рецепты PHP вызывают основной движок внутри процесса. Рецепты Connect вызывают инструменты через транспорт. Рецепты интеграции встраивают NextPDF во фреймворк или серверную часть отрисовщика. Прежде чем адаптировать пример, прочитайте соответствующую страницу соглашений.

Рецепты PHP

Рецепты PHP запускают основной движок напрямую, внутри процесса. Каждый рецепт начинается с composer require nextpdf/core, а затем использует публичный API, чтобы создавать, подписывать, проверять или преобразовывать документы, включая Document::createStandalone() и writeHtml().

Рецепты PHP Карта всех нативных рецептов PHP: отрисовка HTML в PDF, вёрстка таблиц, встраивание шрифтов и создание их подмножеств, шифрование с помощью AES-256, подписание с помощью PAdES, формирование PDF/A-4 и тегированного PDF/UA-2, извлечение текста и проверка существующих файлов.

Рецепты Connect

Рецепты Connect вызывают NextPDF через серверный реестр инструментов по протоколу Model Context Protocol (MCP), Representational State Transfer (REST) или gRPC. Один и тот же вызов инструмента работает во всех трёх транспортах и проходит через шлюз подтверждения с участием человека.

Рецепты Connect Независимые от транспорта рецепты для сервера NextPDF Connect: hello world, таблицы HTML, встраивание изображений, цифровые подписи, проверки доступности и соответствия требованиям, редактирование с удалением данных, криминалистический анализ и наблюдаемость с помощью OpenTelemetry.

Рецепты интеграции

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

Рецепты интеграции Рецепты для пакетов экосистемы: выберите интеграцию, верните PDF из контроллера фреймворка, поставьте генерацию в очередь в фоновой задаче, отрисуйте HTML с помощью Artisan, преобразуйте файлы Office с помощью Gotenberg, выполняйте отрисовку на границе сети с помощью Cloudflare и следуйте пути миграции с TCPDF.

Соглашения по рецептам

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

Соглашения по рецептам интеграции Контракт, которому следует каждый исполняемый рецепт интеграции: примеры, подкреплённые исходным кодом, метаданные профиля воспроизводимости и шлюз публикации.

Соглашения по рецептам Connect Контракт, которому следует каждый рецепт Connect: независимые от транспорта вызовы инструментов, инструменты, зависящие от уровня, модель рисков и шлюз подтверждения, а также честная граница соответствия.

См. также

• Руководства — концептуальные и практические материалы.
• Справочник — проверенный API и матрица поддержки CSS.
• Выбор интеграции — матрица решений для сопоставления сценариев использования с интеграциями.