Cloudflare 통합

한눈에 보기

렌더링을 엣지에서 수행해야 하거나, R2에 생성된 PDF를 저장해야 하거나, 워커 엔드포인트를 호출하기 전에 API 요청에 패키지 수준의 검증이 필요할 때는 nextpdf/cloudflare를 사용합니다.

섹션 맵

페이지	용도
개요	패키지 경계와 지원되는 워크플로입니다.
설치	Composer 설치와 Cloudflare 사전 요구 사항입니다.
빠른 시작	첫 번째 엣지 렌더링 PDF 흐름입니다.
구성	워커, API 보호 및 R2 구성 키입니다.
API	렌더러, 페이로드, 응답 파서, API 보호, R2 아카이브 및 고정된 전송 API입니다.
개발자 가이드	엣지 수명 주기, 요청 경계, 로컬 폴백 및 확장 지점입니다.
프로덕션 사용	배포 및 운영 패턴입니다.
보안 및 운영	워커 URL 검증, 크기 제한, 핀 및 R2 제어입니다.
문제 해결	일반적인 엣지 렌더링 및 아카이브 실패를 다룹니다.

주요 API

기호	역할
NextPDF\Cloudflare\CloudflareHtmlRenderer	HTML 렌더링 요청을 Cloudflare 워커로 전송합니다.
NextPDF\Cloudflare\CloudflareRendererConfig	불변 워커 렌더러 구성 객체입니다.
NextPDF\Cloudflare\ApiProtection	요청 크기, 클라이언트 및 API 키 게이트입니다.
NextPDF\Cloudflare\R2ArchiveManager	생성된 PDF 바이트를 업로드하고 서명된 URL을 생성합니다.
NextPDF\Cloudflare\Transport\PinnedCurlTransport	공개 키 고정을 지원하는 PSR-18 전송입니다.