Cookbook（示例指南）

速览

本 Cookbook 面向具体任务编排。每则示例都用一个可直接复制、并由源码支撑的样例解决单一问题。这些示例按执行位置分为三大类。请先根据你调用 NextPDF 的方式选择对应类别，再从中选取一则示例。

如果你想了解引擎为什么会表现出某种行为，请改读 Guides（指南）。如果你需要经过验证的 API 接口，请阅读 Reference（参考文档）。

一则样例，一种运行时

每则示例都只面向一种运行时。PHP 示例在进程内直接调用核心引擎。Connect 示例通过某种 transport（传输）调用工具。集成示例则把 NextPDF 接入某个 framework 或 renderer backend（后端）。在你改写某个样例之前，请先阅读对应的约定页。

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 示例通过服务器工具注册表，以 Model Context Protocol（MCP）、Representational State Transfer（REST）或 gRPC 调用 NextPDF。同一个工具调用在这三种 transport 上行为一致，并且都受人在回路确认门（gate）的保护。

Connect 示例 供 NextPDF Connect 服务器使用、与 transport 无关的示例：hello world、HTML 表格、图像嵌入、数字签名、无障碍与合规检查、涂黑 (redaction)、取证分析，以及用 OpenTelemetry 做的可观测性。

集成示例

集成示例把 NextPDF 接入某个应用程序 framework，或把渲染工作委派给外部 backend。它们涵盖各类 framework 适配器、renderer 桥接器，以及从旧有库迁移过来的路径。

集成示例 生态系统包的示例：选择一种集成方式、从 framework 控制器返回 PDF、在后台作业中排入生成任务、用 Artisan 渲染 HTML、用 Gotenberg 转换 Office 文件、用 Cloudflare 在边缘渲染，以及遵循 TCPDF 迁移路径。

示例约定

每则示例都遵循一份明示契约：由源码支撑的样例、可复现性配置文件中的 front-matter、如实标示的符合性边界，以及发布门。在你改写某个样例之前，请先阅读所用类别对应的约定页。

集成示例约定 每则可运行的集成示例都遵循的契约：有源码佐证的样例、可复现性配置文件的 front-matter，以及发布门。

Connect 示例约定 每则 Connect 示例都遵循的契约：与 transport 无关的工具调用、按方案层级而定的工具、风险模型与确认门，以及诚实标示的符合性边界。

另请参阅

• Guides — 概念与操作指南的索引。
• Reference — 经过验证的 API 接口与 CSS 支持对照表。
• 选择一种集成方式 — 将使用场景映射到集成方式的决策表。