Cloudflare-Integration

Auf einen Blick

Verwenden Sie nextpdf/cloudflare, wenn das Rendering am Edge erfolgen soll, wenn R2 erzeugte PDFs speichern soll oder wenn API-Anfragen vor dem Aufruf eines Worker-Endpunkts eine Validierung auf Paketebene benötigen.

Abschnittsübersicht

Seite	Wofür Sie sie verwenden
Überblick	Paketgrenze und unterstützte Workflows.
Installation	Composer-Installation und Cloudflare-Voraussetzungen.
Schnellstart	Erster PDF-Ablauf mit Rendering am Edge.
Konfiguration	Konfigurationsschlüssel für Worker, API-Schutz und R2.
API	Renderer-, Payload-, Response-Parser-, API-Schutz- und R2-Archiv-APIs sowie APIs für gepinnte Transporte.
Entwicklerhandbuch	Edge-Lebenszyklus, Anfragegrenzen, lokaler Fallback und Erweiterungspunkte.
Produktiveinsatz	Deployment- und Betriebsmuster.
Sicherheit und Betrieb	Worker-URL-Validierung, Größenlimits, Pins und R2-Kontrollen.
Fehlerbehebung	Häufige Fehler beim Edge-Rendering und beim Archivieren.

Wichtigste APIs

Symbol	Rolle
NextPDF\Cloudflare\CloudflareHtmlRenderer	Sendet HTML-Rendering-Anfragen an einen Cloudflare-Worker.
NextPDF\Cloudflare\CloudflareRendererConfig	Unveränderliches Konfigurationsobjekt für den Worker-Renderer.
NextPDF\Cloudflare\ApiProtection	Gate für Anfragegröße, Client und API-Schlüssel.
NextPDF\Cloudflare\R2ArchiveManager	Lädt erzeugte PDF-Bytes hoch und erstellt signierte URLs.
NextPDF\Cloudflare\Transport\PinnedCurlTransport	PSR-18-Transport mit Public-Key-Pinning-Unterstützung.