Integración con Cloudflare

De un vistazo

Usar nextpdf/cloudflare cuando el renderizado deba ejecutarse en el edge, cuando los PDF generados deban archivarse en R2 o cuando las solicitudes de API requieran validación a nivel de paquete antes de invocar un endpoint del worker.

Mapa de secciones

Página	Úsalo para
Descripción general	Alcance del paquete y flujos de trabajo admitidos.
Instalación	Instalación con Composer y requisitos previos de Cloudflare.
Inicio rápido	Primer flujo para renderizar PDF en el edge.
Configuración	Claves de configuración para el worker, la protección de API y R2.
API	API del renderer, payload, parser de respuestas, protección de API, archivado en R2 y transporte con pinning.
Guía para desarrolladores	Ciclo de vida en el edge, límites de las solicitudes, fallback local y puntos de extensión.
Uso en producción	Patrones de despliegue y operación.
Seguridad y operaciones	Validación de URL del worker, límites de tamaño, pins y controles de R2.
Resolución de problemas	Fallos habituales del renderizado en el edge y del archivado.

API principales

Símbolo	Rol
NextPDF\Cloudflare\CloudflareHtmlRenderer	Envío de solicitudes de renderizado de HTML a un worker de Cloudflare.
NextPDF\Cloudflare\CloudflareRendererConfig	Objeto de configuración inmutable del renderer del worker.
NextPDF\Cloudflare\ApiProtection	Control del tamaño de solicitud, del cliente y de la clave de API.
NextPDF\Cloudflare\R2ArchiveManager	Subida de los bytes del PDF generado y creación de URL firmadas.
NextPDF\Cloudflare\Transport\PinnedCurlTransport	Transporte PSR-18 con compatibilidad con pinning de clave pública.