Cloudflare 集成

概览

如果渲染（render）工作需要在边缘（edge）执行、生成的 PDF 需要存储到 R2，或 API 请求在调用 worker endpoint 前需要进行包级别校验，请使用 nextpdf/cloudflare。

章节地图

页面	适用场景
总览	包边界和支持的工作流程。
安装	Composer 安装和 Cloudflare 前置要求。
快速上手	首次在边缘渲染 PDF 的流程。
配置	Worker、API 保护和 R2 配置键。
API	renderer（渲染器）、payload、响应 parser（解析器）、API 保护、R2 归档，以及固定版本的 transport（传输）API。
开发者指南	边缘生命周期、请求边界、本地回退以及扩展点。
生产环境使用	部署和运维模式。
安全与运维	Worker URL 校验、大小上限、固定项以及 R2 控制项。
故障排查	常见的边缘渲染和归档失败情况。

主要 API

符号	角色
NextPDF\Cloudflare\CloudflareHtmlRenderer	将 HTML 渲染请求发送到 Cloudflare worker。
NextPDF\Cloudflare\CloudflareRendererConfig	不可变的 worker renderer 配置对象。
NextPDF\Cloudflare\ApiProtection	请求大小、客户端和 API 密钥的 gate（网关）。
NextPDF\Cloudflare\R2ArchiveManager	上传生成的 PDF 字节，并创建签名 URL。
NextPDF\Cloudflare\Transport\PinnedCurlTransport	支持公钥固定的 PSR-18 transport（传输层）。