Cloudflare 整合

概覽

需要在邊緣（edge）執行算繪（render）工作、需要將產生的 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（傳輸層）。