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

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

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

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

Частые задачи

Перейдите сразу на страницу нужной задачи:

Рецепты 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.
Выбор интеграции — матрица решений для сопоставления сценариев использования с интеграциями.