Gotenberg 集成

概览

当你需要将转换任务委派给 Gotenberg 服务时，请使用 nextpdf/gotenberg。它尤其适合 office 文档，以及应在 PHP 进程之外执行的 HTML 转 PDF 流程。

章节地图

页面	适用场景
概览	包边界和支持的工作流程。
安装	Composer 安装和 Gotenberg 服务的前置条件。
快速上手	首次转换流程。
配置	endpoint、超时和安全性配置键。
API	桥接器、配置、payload、结果、parser、office 格式及固定版传输 API。
开发者指南	服务边界、payload 构建和扩展点。
生产环境使用	部署和运维模式。
安全性与运维	SSRF 管控、MIME 处理、大小限制和固定版传输。
故障排查	常见的转换和服务失败。

主要 API

符号	角色
NextPDF\Gotenberg\GotenbergBridge	通过 Gotenberg 服务转换输入内容。
NextPDF\Gotenberg\GotenbergConfig	不可变的服务配置对象。
NextPDF\Gotenberg\GotenbergConvertPayload	转换请求的 payload。
NextPDF\Gotenberg\GotenbergConvertResult	转换后的 PDF 字节和响应元数据。
NextPDF\Gotenberg\OfficeFormat	支持的 office 文档格式枚举（enum）。