NextPDF 入门

概览

NextPDF 是一套 PHP 8.4 引擎，用于生成并检查 PDF 2.0 文档，即 ISO 32000-2 所定义的文件格式。你可以通过强类型、流畅的 API 构建文档，将 HTML 与 CSS 渲染为页面，为输出添加签名并归档，也可以读回结构化内容。这一切都在 PHP 中运行，核心路径不需要任何外部可执行文件。

NextPDF 提供四种发行版本。它们底层共用同一套引擎，所以你只需要安装最符合自己工作方式的那一个。

发行版本	软件包	适用情境
NextPDF 核心（OSS）	`nextpdf/core`	你使用 PHP 编写应用，并希望直接使用引擎，无论搭配框架还是单独使用都可以。
NextPDF Server 服务器（OSS）	`nextpdf/server`	你想要一个独立服务，通过 MCP、REST 与 gRPC 对外开放引擎。
NextPDF Pro 专业版	`nextpdf/premium`（Pro 层级）	你需要数字签名、PDF/A 归档，或电子发票输出。
NextPDF Enterprise 企业版	`nextpdf/premium`（Enterprise 层级）	你需要硬件支持的签名、合格签名，以及完整的合规覆盖范围。

NextPDF Pro 与 NextPDF Enterprise 是同一个 nextpdf/premium 软件包的两个授权层级。无论该软件包是否存在，核心引擎都会以相同方式运行。

一行命令完成安装

如果是普通 PHP 项目，请用 Composer 安装核心引擎。

composer require nextpdf/core

仅凭这一个软件包，无需任何额外设置，就能生成并检查 PDF。框架集成、HTML 渲染器、服务器以及 Python SDK，各自再额外加上一个软件包。安装指南一节列出了每一条命令。

挑选你的路径

NextPDF 可以融入你既有的代码。请选择符合你技术栈的入口点，再按对应卡片继续操作。

安装完整的安装矩阵：核心、框架集成、HTML 渲染器、服务器，以及 Python SDK。

你的第一份 PDF 一篇简短教程，先用 PHP 生成 PDF，再把 HTML 渲染成 PDF。

选择你的路径一份决策指南：核心、框架，还是服务器，以及该用哪一个 HTML 渲染器。

集成框架适配器、浏览器渲染器、边缘服务，以及迁移软件包。

接下来该看哪里

生成第一份文档之后，可以继续查看文档的三大主要区块。

指南与集成操作符合你框架、渲染器、运行时或迁移目标的软件包 —— Laravel、Symfony、CodeIgniter、Artisan、Cloudflare 与 Gotenberg。

API 参考经过验证的引擎接口：类、方法、配置键，以及 CSS 支持矩阵。

Cookbook（实例指南）以任务为中心的实例 —— 把 HTML 渲染成 PDF、用 CSS 设置样式、排版表格，以及为长内容分页。

为什么要有独立的服务器？

当非 PHP 服务、AI 代理或其他运行时需要通过网络协议调用引擎，而不是以库的形式链接它时，就适合安装 NextPDF Server。 Python SDK 则是该服务器的强类型客户端。