发行版
纯 PHP → 核心。框架应用程序 → 对应的集成包。网络边界 → 服务器。Python 客户端 → Python SDK。
选择适合你的入门路径
快速总览
标题为“快速总览”的章节NextPDF 提供多种入门方式。哪一种最适合，取决于你的代码在哪里运行，以及你需要哪一种输出。本页会帮你确定三件事：要安装哪个发行版、要使用哪套 HTML renderer，以及哪些工作负载需要 Pro 或 Enterprise 方案。
你可以直接阅读能回答问题的那一节，或快速浏览结尾的决策摘要。
选择发行版
标题为“选择发行版”的章节先看你的应用程序如何调用这个引擎。第一个符合你场景的行，就是你的答案。
| 你的情境 | 安装 | 原因 |
|---|---|---|
| 纯 PHP 项目、库或 CLI 工具 | NextPDF 核心（nextpdf/core） | 只包含引擎本身。它不对任何框架（Framework）做假设，也不运行任何服务。 |
| Laravel、Symfony 或 CodeIgniter 应用程序 | 对应的框架集成包 | 你会在核心之上获得容器绑定、响应辅助方法和队列任务。 |
| 必须通过网络调用引擎的非 PHP 服务、AI Agent（代理）或其他运行时 | NextPDF 服务器（nextpdf/server） | 通过单一服务，以 MCP、REST 与 gRPC 形式对外提供这个引擎。 |
| 需要从 NextPDF 服务器获取 PDF 的 Python 代码 | Python SDK 客户端（pip install nextpdf） | 面向运行中服务器的带类型客户端。它并不内嵌引擎。 |
有两点常造成混淆：
- 框架集成包已内含核心。你不需要分别安装两者。适配器会替你声明并 resolve（解析）
nextpdf/core。 - Python SDK 是客户端，不是引擎。它需要与一个 NextPDF 服务器 endpoint（端点）通信。PDF 的生成是在服务器端的 PHP 中完成的。
选择 HTML renderer
标题为“选择 HTML renderer”的章节NextPDF 提供四种把 HTML 渲染成 PDF 的方式。内置管线无需额外设置，就能覆盖大多数文档。另外三个 renderer 包，则适用于需要浏览器级布局，或想沿用既有服务的场景。
| renderer（渲染器） | 包 | 在哪里运行 | 何时选它 |
|---|---|---|---|
内置 writeHtml() | nextpdf/core | 进程内、纯 PHP | 你只需要支持的 HTML 与 CSS 子集，而且不需要浏览器或网络调用。 |
| Artisan | nextpdf/artisan | 主机上的 headless Chrome | 你需要完整的 Chrome 布局——flexbox、grid、复杂选择器、网页字体——而且文本需要可选取。 |
| Cloudflare | nextpdf/cloudflare | 边缘端的 Cloudflare Browser Rendering | 渲染应放在边缘端，或你不想在自己的主机上运行浏览器进程。 |
| Gotenberg | nextpdf/gotenberg | 由你自行运维的 Gotenberg 服务 | 你要通过既有的 Gotenberg 部署转换 Office 文档（DOCX、XLSX）或 HTML。 |
这张表怎么读：
- 请优先采用内置管线。它是最快的路径，而且没有外部依赖。在依赖某个属性之前，先对照 CSS 支持对照表确认它是否受支持。
- 当布局超出支持的子集，而且渲染应保留在你自己的基础设施内时，改用 Artisan。它会启动一个 Chrome 进程，所以要为这段生命周期做好规划。
- 当你需要同样的浏览器保真度，但更希望在边缘端渲染，而不是在本机运行浏览器时，改用 Cloudflare。
- 需要转换 Office 文档时改用 Gotenberg；或者在你已经运行 Gotenberg，并想让 NextPDF 驱动它时使用。
何时需要 Pro 或 Enterprise
标题为“何时需要 Pro 或 Enterprise”的章节核心引擎可以生成、渲染并检视 PDF，免费且不需要授权。NextPDF Pro 与 NextPDF Enterprise 是 nextpdf/premium 包的两个授权方案。安装它会增加功能，而且不会改动任何核心 API。
| 你需要 | 方案 | 功能 |
|---|---|---|
| 对 PDF 进行数字签名（PAdES baseline） | Pro（专业版） | 软件密钥签名的具体实现。 |
| 生成归档用的 PDF/A 输出 | 专业版 | PDF/A 一致性与归档配置文件。 |
| 内嵌电子发票（Factur-X/ZUGFeRD） | 专业版 | 电子发票合约的具体实现。 |
| 以硬件安全模块（HSM）签名 | Enterprise（企业版） | 由硬件支持的密钥操作。 |
| 签发合格电子签名 | 企业版 | 合格签名工作流程与完整的合规面。 |
有两条规则让这个决策保持务实：
- 如果你的输出是未签名、非归档的 PDF，核心就已足够。你不需要授权。
- 当你安装
nextpdf/premium后，框架集成包与服务器会自动检测到它。它们会通过同一组容器键与工具目录，对外提供这些额外功能。你的应用程序无需任何代码变更即可采用它。
决策摘要
标题为“决策摘要”的章节HTML renderer
支持的子集、无依赖 → writeHtml()。在你自己的主机上需要浏览器保真度 → Artisan。在边缘端 →
Cloudflare。Office 转换 → Gotenberg。
授权方案
未签名的 PDF → 核心。签名、PDF/A、电子发票 → Pro。HSM 或合格签名 → Enterprise。
还不确定吗？
先安装 核心，跑一遍 你的第一份 PDF，等到出现具体需求时，再加装包。这些之后都可以再改。
另请参阅
标题为“另请参阅”的章节 安装 NextPDF 各个发行版与 renderer 的确切安装命令。
你的第一份 PDF 用 PHP 生成 PDF，并把 HTML 渲染成 PDF。
集成 完整的扩展对照表、选择指南，以及各个包的操作手册。
连接（服务器） 以网络服务形式，通过 MCP、REST 与 gRPC 对外运行这个引擎。