Cloudflare 統合

概要

エッジでレンダリングを実行する場合、生成した PDF を R2 に保存する場合、または worker エンドポイントを呼び出す前に API リクエストに対してパッケージレベルの検証が必要な場合は、nextpdf/cloudflare を使用します。

セクションマップ

ページ	用途
概要	パッケージの境界とサポート対象ワークフロー。
インストール	Composer でのインストールと Cloudflare の前提条件。
クイックスタート	エッジで PDF をレンダリングする初回フロー。
構成	worker、API 保護、R2 の構成キー。
API	レンダラー、ペイロード、レスポンスパーサー、API 保護、R2 アーカイブ、ピン留めされたトランスポートの各 API。
開発者ガイド	エッジのライフサイクル、リクエスト境界、ローカルフォールバック、拡張ポイント。
本番環境での利用	デプロイと運用パターン。
セキュリティと運用	worker URL の検証、サイズ制限、ピン留め、R2 の制御。
トラブルシューティング	エッジレンダリングとアーカイブでよく起きる障害。

主要な API

シンボル	役割
NextPDF\Cloudflare\CloudflareHtmlRenderer	Cloudflare worker への HTML レンダリングリクエスト送信。
NextPDF\Cloudflare\CloudflareRendererConfig	イミュータブルな worker レンダラー構成オブジェクト。
NextPDF\Cloudflare\ApiProtection	リクエストサイズ、クライアント、API キーのゲート。
NextPDF\Cloudflare\R2ArchiveManager	生成した PDF バイト列のアップロードと署名付き URL の作成。
NextPDF\Cloudflare\Transport\PinnedCurlTransport	公開鍵ピン留めをサポートする PSR-18 トランスポート。