指南
本节梳理 NextPDF 的概念文档与操作文档;NextPDF 是一套 headless 的 PHP 8.4 便携式文档格式 2.0(PDF 2.0)引擎。下方的每张卡片都指向一个章节入口,而非单个页面。用它找到正确的起点,再顺着该入口中的链接继续深入。
指南回答的是怎么做与为什么。如果你需要任务导向、可直接复制的 recipe(示例),请转到 Cookbook(示例指南)。如果你需要已验证的 API 接口与支持矩阵,请前往 Reference。
集成指南
标题为“集成指南”的章节NextPDF 扩展把核心引擎连接到应用程序框架、浏览器 renderer(渲染器)、边缘服务、构建工具,以及旧系统迁移。每个扩展章节都采用相同的手册结构:概述、安装、快速上手、配置、API、开发者指南、生产环境使用、安全性,以及故障排查。
集成 框架适配器(Laravel、Symfony、CodeIgniter)、渲染器桥接器(Artisan、Cloudflare、Gotenberg)、TCPDF 兼容 shim(兼容层),以及 Backport Builder。请先阅读扩展地图与选用指南。
迁移 把现有的代码库迁移到 NextPDF。提供 dompdf 与 mPDF 的逐个来源指南,外加每份指南共通的一条原则:行为兼容,而非字节级输出完全相同,差异均有文档记载。
服务器与 SDK
标题为“服务器与 SDK”的章节当你的调用方位于远端、使用另一种语言编写,或是人工智能(AI)系统需要工具 endpoint(而非 PHP 库)时,请使用这些指南。
NextPDF Connect(服务器) nextpdf/server 包:一个确定性的 PDF 工具注册表,通过 Model Context Protocol(MCP)、表述性状态转移(REST)与 gRPC 提供服务,并置于人为介入(human-in-the-loop)确认 gate 之后。可安装、配置与部署。
Python SDK 为 Python 应用程序、代理与命令行提供可供引用的 PDF 提取功能,背后由 NextPDF Connect endpoint 支持。以 pip install nextpdf 安装,再让客户端指向你的服务器。
标准与符合性
标题为“标准与符合性”的章节NextPDF Core 以各项标准要求的结构为目标。符合性本身则由外部验证器、检查器或接收方权责机构判定。每个符合性页面都会把它的主张追溯到某个条款,并明确标出这条界线。
符合性 NextPDF 所对应的标准配置文件:PDF 2.0(ISO 32000-2)、PDF/A-4(ISO 19005-4)归档、PDF/UA-2(ISO 14289-2)无障碍、PDF/X 印刷制作,以及 ZUGFeRD / Factur-X 电子发票。
PAdES 基准映射 NextPDF 如何映射到 ETSI EN 319 142 的 PAdES 基准级别 B-B、B-T、B-LT 与 B-LTA,并把 Core 的签名接口与 Premium 及 Enterprise 层级区分开来。
运维与扩展
标题为“运维与扩展”的章节这些指南涵盖如何在生产环境中安全运行 NextPDF、诊断失败,以及基于公开的扩展接口进行开发。
信任与安全性 核心引擎的工程姿态:威胁模型、签名与加密的安全模型、数据处理行为,以及漏洞披露政策,并标明各自的界线。
故障排查 针对签名、PDF/A、PDF/UA、字体、标记、加密与权限失败,提供从症状到解法的条目,并以引擎本身的异常分类为依据。
扩展开发 公开的服务提供者接口(SPI):你能扩展什么、其背后的稳定性承诺、自定义字体、自定义排版引擎、动作触发器,以及密钥管理服务(KMS)提供者契约。
Premium(Pro 与 Enterprise) NextPDF Pro 与 Enterprise 在开源核心之上额外加入的功能:能力矩阵、标准符合性、HSM 与 FIPS 验证,以及授权。采用商业版本不需要更改任何应用程序代码。
Insider_ 章节说明 NextPDF 为什么会这样运作。它以资深工程师的视角呈现整体设计,并按背后的证据类型标记每一项主张。
概念(Insider_) 设计理念、标准全貌、HTML 管线、签名与长期验证、字体、大批量生成,以及测试方法。从这里开始理解引擎的推理脉络。