Intégration Cloudflare

En bref

Utilise nextpdf/cloudflare lorsque le rendu doit s’exécuter en périphérie, lorsque R2 doit stocker les PDF générés ou lorsque les requêtes API doivent être validées au niveau du package avant d’appeler un point de terminaison worker.

Plan des sections

Page	À utiliser pour
Vue d’ensemble	Périmètre du package et workflows pris en charge.
Installation	Installation avec Composer et prérequis Cloudflare.
Démarrage rapide	Premier flux de rendu de PDF en périphérie.
Configuration	Clés de configuration du worker, de la protection des API et de R2.
API	API du renderer, de la charge utile, du parseur de réponse, de la protection des API, de l’archivage R2 et du transport épinglé.
Guide du développeur	Cycle de vie en périphérie, limites des requêtes, repli local et points d’extension.
Utilisation en production	Schémas de déploiement et d’exploitation.
Sécurité et exploitation	Validation de l’URL du worker, limites de taille, épinglages et contrôles R2.
Dépannage	Échecs fréquents du rendu en périphérie et de l’archivage.

API principales

Symbole	Rôle
NextPDF\Cloudflare\CloudflareHtmlRenderer	Envoie les requêtes de rendu HTML à un worker Cloudflare.
NextPDF\Cloudflare\CloudflareRendererConfig	Objet de configuration immuable pour le renderer worker.
NextPDF\Cloudflare\ApiProtection	Contrôle la taille des requêtes, le client et la clé API.
NextPDF\Cloudflare\R2ArchiveManager	Téléverse les octets des PDF générés et crée des URL signées.
NextPDF\Cloudflare\Transport\PinnedCurlTransport	Transport PSR-18 prenant en charge l’épinglage de clé publique.