Integrazione con Cloudflare

Panoramica

Usare nextpdf/cloudflare quando il rendering deve avvenire sull’edge, quando R2 deve archiviare i PDF generati o quando le richieste API richiedono una convalida a livello di pacchetto prima di chiamare un endpoint worker.

Mappa delle sezioni

Pagina	Utilizzo
Panoramica	Confini del pacchetto e flussi di lavoro supportati.
Installazione	Installazione tramite Composer e prerequisiti di Cloudflare.
Avvio rapido	Primo flusso di generazione di PDF sull’edge.
Configurazione	Chiavi di configurazione per worker, protezione delle API e R2.
API	API per renderer, payload, parser delle risposte, protezione delle API, archivio R2 e transport con pinning.
Guida per gli sviluppatori	Ciclo di vita sull’edge, confini delle richieste, fallback locale e punti di estensione.
Utilizzo in produzione	Modelli di distribuzione e gestione operativa.
Sicurezza e operazioni	Convalida degli URL dei worker, limiti di dimensione, pin e controlli R2.
Risoluzione dei problemi	Errori comuni di rendering sull’edge e di archiviazione.

API principali

Simbolo	Ruolo
NextPDF\Cloudflare\CloudflareHtmlRenderer	Invia richieste di rendering HTML a un worker Cloudflare.
NextPDF\Cloudflare\CloudflareRendererConfig	Oggetto di configurazione immutabile del renderer del worker.
NextPDF\Cloudflare\ApiProtection	Gate per dimensione delle richieste, client e chiave API.
NextPDF\Cloudflare\R2ArchiveManager	Carica i byte dei PDF generati e crea URL firmati.
NextPDF\Cloudflare\Transport\PinnedCurlTransport	Transport PSR-18 con supporto per il pinning delle chiavi pubbliche.