Integrationen
Auf einen Blick
Abschnitt betitelt „Auf einen Blick“NextPDF-Erweiterungen verbinden die zentrale PDF-Engine mit Anwendungsframeworks, Browser-Renderern, Edge-Diensten, Build-Werkzeugen und Legacy-Migrationen. Jeder Erweiterungsabschnitt folgt demselben Aufbau des Handbuchs: Überblick, Installation, Schnellstart, Konfiguration, API, Entwicklerhandbuch, Produktionseinsatz, Sicherheit und Fehlerbehebung.
Erweiterungsübersicht
Abschnitt betitelt „Erweiterungsübersicht“| Erweiterung | Paket | Geeignet, wenn | Hauptabschnitt |
|---|---|---|---|
| Laravel | nextpdf/laravel | Sie entwickeln Laravel-Anwendungen und benötigen Container-Bindings, eine Facade, Responses und Queue-Jobs. | Laravel |
| Symfony | nextpdf/symfony | Sie entwickeln Symfony-Anwendungen und benötigen ein Bundle, DI-Verdrahtung, Messenger-Jobs und HTTP-Responses. | Symfony |
| CodeIgniter | nextpdf/codeigniter | Sie entwickeln CodeIgniter-4-Anwendungen und benötigen Services, einen Library-Wrapper, Responses und Queue-Jobs. | CodeIgniter |
| Artisan | nextpdf/artisan | Sie benötigen HTML-Rendering über Chrome CDP, Seitenimport oder Low-Level-Werkzeuge zur PDF-Inspektion. | Artisan |
| Cloudflare | nextpdf/cloudflare | Sie rendern mit Cloudflare Browser Rendering, schützen den API-Zugriff oder archivieren PDFs in R2. | Cloudflare |
| Gotenberg | nextpdf/gotenberg | Sie konvertieren Office-Dokumente oder HTML mit einem Gotenberg-Dienst. | Gotenberg |
| TCPDF-Kompatibilität | nextpdf/compat-legacy | Sie migrieren TCPDF-geprägten Anwendungscode zu NextPDF, ohne alles neu zu schreiben. | TCPDF-Kompatibilität |
| Backport Builder | nextpdf/backport-builder | Sie pflegen Release-Artefakte für ältere PHP-Laufzeitumgebungen. | Backport Builder |
Auswahlhilfe
Abschnitt betitelt „Auswahlhilfe“| Bedarf | Hier starten | Betriebshinweis |
|---|---|---|
| Framework-Response-Helfer | Laravel, Symfony oder CodeIgniter | Das Framework-Paket übernimmt die Container- und Response-Integration; der Core übernimmt die Dokumenterstellung. |
| Pixelgenaues HTML-Rendering | Artisan oder Cloudflare | Wählen Sie Artisan für Chrome CDP auf dem lokalen Host; wählen Sie Cloudflare, wenn das Rendering am Edge erfolgen soll. |
| Office-Konvertierung | Gotenberg | Behandeln Sie Gotenberg als externe Dienstgrenze mit Kontrollen für Timeout, Größe und SSRF. |
| Legacy-TCPDF-Migration | TCPDF-Kompatibilität | Lesen Sie die Tabelle zur Methodenabdeckung, bevor Sie annehmen, dass ein Legacy-Aufruf unterstützt wird. |
| Ältere PHP-Distribution | Backport Builder | Nur als Build-Werkzeug verwenden; installieren Sie es nicht als Laufzeitabhängigkeit Ihrer Anwendung. |
Aufbau des Handbuchs
Abschnitt betitelt „Aufbau des Handbuchs“Jeder Erweiterungsabschnitt enthält die folgenden Seitentypen:
| Seite | Zweck |
|---|---|
overview | Produktabgrenzung, Zielgruppe, unterstützte Workflows und Einschränkungen. |
install | Installationsbefehle und benötigte Laufzeitabhängigkeiten. |
quickstart | Minimaler funktionsfähiger Ablauf mit einem ersten kopierbaren Ergebnis. |
configuration | Alle unterstützten Konfigurationsschlüssel, Umgebungsvariablen, Standardwerte und ihre Wirkung. |
api | Öffentliche Klassen, Methoden, Parameter, Standardwerte, Rückgabewerte und Exceptions. |
developer-guide | Erweiterungsarchitektur, Lebenszyklus, Erweiterungspunkte und Code-Organisation. |
production-usage | Deployment, Zuverlässigkeit, Performance, Worker-Sicherheit und Observability. |
security-and-operations | Vertrauensgrenzen, sichere Standardwerte, Secrets, Dateizugriff und Betriebskontrollen. |
troubleshooting | Symptome, Diagnose, wahrscheinliche Ursachen und Behebungsmaßnahmen. |
Konvention der API-Tabellen
Abschnitt betitelt „Konvention der API-Tabellen“API-Tabellen verwenden im gesamten Handbuch dieselben Spalten, damit Sie Pakete vergleichen können, ohne sich in ein neues Layout einarbeiten zu müssen.
| Spalte | Bedeutung |
|---|---|
| Symbol | Vollständig qualifizierte Klasse, Methode, Endpunkt, CLI-Befehl oder Konfigurationsobjekt. |
| Parameter | Name, Typ, Erforderlichkeit, Standardwert und zulässige Werte. |
| Standardverhalten | Verhalten, wenn der Aufrufer optionale Eingaben weglässt. |
| Rückgabe | Rückgabetyp oder Ausgabeartefakt. |
| Wirft oder schlägt fehl mit | Exception-Typ, HTTP-Status, Validierungsfehler oder betrieblicher Fehlermodus. |
| Hinweise | Details zu Sicherheit, Worker-Sicherheit, Kompatibilität oder Performance. |
Übersetzungsbereitschaft
Abschnitt betitelt „Übersetzungsbereitschaft“Die englische Quelle ist für spätere Lokalisierung ausgelegt: kurze Abschnitte, stabile Überschriften, eindeutige Substantive, keine Idiome und Tabellen für wiederkehrende Strukturen. Neue API-Seiten sollten Methodennamen, Konfigurationsschlüssel, CLI-Flags und Exception-Namen in Code-Formatierung belassen, damit Übersetzungswerkzeuge sie unverändert erhalten.