Wählen Sie Ihren Weg

Auf einen Blick

NextPDF bietet mehrere Einstiege. Welcher der richtige ist, hängt davon ab, wo Ihr Code läuft und welche Art von Ausgabe Sie benötigen. Diese Seite klärt für Sie drei Entscheidungen: welche Distribution Sie installieren, welchen HTML-Renderer Sie nutzen und wann eine Arbeitslast Pro oder Enterprise erfordert.

Lesen Sie den Abschnitt, der Ihre Frage beantwortet, oder überfliegen Sie am Ende die Entscheidungsübersicht.

Eine Distribution wählen

Orientieren Sie sich daran, wie Ihre Anwendung die Engine aufruft. Die erste Zeile, die zu Ihrer Situation passt, ist Ihre Antwort.

Ihre Situation	Installieren	Warum
Ein reines PHP-Projekt, eine Bibliothek oder ein CLI-Tool	NextPDF core (`nextpdf/core`)	Die Engine allein. Sie trifft keine Framework-Annahmen und betreibt keinen Dienst.
Eine Laravel-, Symfony- oder CodeIgniter-Anwendung	Die passende Framework-Integration	Sie erhalten Container-Bindings, Response-Helper und Queue-Jobs auf Basis von core.
Ein Nicht-PHP-Dienst, ein Agent oder eine andere Laufzeitumgebung, die die Engine über ein Netzwerk aufrufen muss	NextPDF Server (`nextpdf/server`)	Ein einziger Dienst stellt die Engine über MCP, REST und gRPC bereit.
Python-Code, der PDFs von einem NextPDF Server braucht	Das Python-SDK (`pip install nextpdf`)	Ein typisierter Client für einen laufenden Server. Es bettet die Engine nicht ein.

Zwei Punkte sorgen oft für Verwirrung:

Eine Framework-Integration enthält core. Sie installieren nicht beide getrennt. Der Adapter deklariert und löst nextpdf/core für Sie auf.
Das Python-SDK ist ein Client, keine Engine. Es benötigt einen NextPDF Server-Endpunkt, mit dem es kommuniziert. Die PDF-Generierung erfolgt in PHP auf der Serverseite.

Einen HTML-Renderer wählen

NextPDF rendert HTML auf vier Arten zu PDF. Die eingebaute Pipeline deckt die meisten Dokumente ohne zusätzliche Einrichtung ab. Die drei Renderer-Pakete kommen zum Einsatz, wenn Sie Layout in Browser-Qualität benötigen oder einen bestehenden Dienst nutzen möchten.

Renderer	Paket	Wo es läuft	Wählen Sie ihn, wenn
Eingebautes `writeHtml()`	`nextpdf/core`	Im Prozess, reines PHP	Sie möchten eine unterstützte HTML- und CSS-Teilmenge ohne Browser und ohne Netzwerkaufruf.
Artisan	`nextpdf/artisan`	headless Chrome auf dem Host	Sie benötigen volles Chrome-Layout — Flexbox, Grid, komplexe Selektoren, Webfonts — mit markierbarem Text.
Cloudflare	`nextpdf/cloudflare`	Cloudflare Browser Rendering am Edge	Das Rendering gehört an den Edge, oder Sie möchten Browser-Prozesse von Ihren eigenen Hosts fernhalten.
Gotenberg	`nextpdf/gotenberg`	Ein Gotenberg-Dienst, den Sie betreiben	Sie konvertieren Office-Dokumente (DOCX, XLSX) oder HTML über ein bestehendes Gotenberg-Deployment.

So lesen Sie die Tabelle:

Verwenden Sie zuerst die eingebaute Pipeline. Sie ist der schnellste Weg und hat keine externe Abhängigkeit. Bevor Sie sich auf eine Eigenschaft verlassen, prüfen Sie sie anhand der CSS-Support-Matrix.
Wechseln Sie zu Artisan, wenn ein Layout über die unterstützte Teilmenge hinausgeht und das Rendering auf Ihrer eigenen Infrastruktur bleiben soll. Es startet einen Chrome-Prozess; planen Sie diesen Lebenszyklus entsprechend ein.
Wechseln Sie zu Cloudflare, wenn Sie dieselbe Browser-Treue möchten, aber lieber am Edge rendern, statt Browser lokal zu betreiben.
Wechseln Sie zu Gotenberg für die Konvertierung von Office-Dokumenten oder wenn Sie Gotenberg bereits betreiben und möchten, dass NextPDF es ansteuert.

Wann Sie Pro oder Enterprise benötigen

Die core-Engine erzeugt, rendert und untersucht PDFs kostenlos und ohne Lizenz. NextPDF Pro und NextPDF Enterprise sind die beiden lizenzierten Stufen des Pakets nextpdf/premium. Die Installation fügt Fähigkeiten hinzu, ändert aber keine core-API.

Sie müssen	Stufe	Fähigkeit
Ein PDF digital signieren (PAdES-Baseline)	Pro	Konkrete Implementierungen für die Signatur mit Software-Schlüsseln.
Archivfähige PDF/A-Ausgabe erzeugen	Pro	PDF/A-Konformität und Archivierungsprofile.
Eine elektronische Rechnung einbetten (Factur-X / ZUGFeRD)	Pro	Konkrete Implementierungen des E-Rechnungs-Vertrags.
Mit einem Hardware-Sicherheitsmodul (HSM) signieren	Enterprise	Hardwaregestützte Schlüsseloperationen.
Qualifizierte elektronische Signaturen ausstellen	Enterprise	Workflow für qualifizierte Signaturen und die vollständige Compliance-Oberfläche.

Zwei Regeln sorgen für eine klare Entscheidung:

Wenn Ihre Ausgabe aus unsignierten, nicht archivfähigen PDFs besteht, ist core vollständig. Sie benötigen keine Lizenz.
Wenn Sie nextpdf/premium installieren, wird es von den Framework-Integrationen und dem Server automatisch erkannt. Sie stellen die zusätzliche Fähigkeit über dieselben Container-Keys und denselben Tool-Katalog bereit. Ihre Anwendung benötigt keine Code-Änderung, um sie zu nutzen.

Entscheidungsübersicht

Distribution

Reines PHP → core. Eine Framework-App → die passende Integration. Netzwerkgrenze → der Server. Python-Client → das Python-SDK.

HTML-Renderer

Unterstützte Teilmenge, keine Abhängigkeit → writeHtml(). Browser-Treue auf Ihren Hosts → Artisan. Am Edge → Cloudflare. Office-Konvertierung → Gotenberg.

Lizenzierte Stufe

Unsignierte PDFs → core. Signieren, PDF/A, E-Rechnung → Pro. HSM oder qualifizierte Signaturen → Enterprise.

Immer noch unsicher?

Installieren Sie core, führen Sie Ihr erstes PDF aus und fügen Sie ein Paket erst hinzu, wenn ein konkreter Bedarf entsteht. Sie können all das später ändern.

Siehe auch

NextPDF installieren Der genaue Befehl für jede Distribution und jeden Renderer.

Dein erstes PDF Erzeuge ein PDF aus PHP und rendere HTML zu PDF.

Integrationen Die vollständige Erweiterungskarte, der Auswahlleitfaden und die Handbücher pro Paket.

Connect (Server) Betreibe die Engine als Netzwerkdienst über MCP, REST und gRPC.