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.

Bibliothek oder Dienst?

Wenn Ihre PHP-Anwendung die Bibliothek einbinden kann, verwenden Sie bevorzugt core oder eine Framework-Integration. Das bedeutet einen Prozess weniger und die geringste Latenz. Greifen Sie zum Server, wenn eine Nicht-PHP-Komponente die Engine benötigt, oder wenn Sie einen einzigen Rendering-Dienst möchten, den viele Aufrufer gemeinsam nutzen.

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.

Renderer vergrößern die Angriffsfläche

Standardmäßig führt die eingebaute Pipeline keine Skripte aus und holt keine entfernten Ressourcen. Artisan, Cloudflare und Gotenberg rendern jeweils über einen Browser oder einen Netzwerkdienst. Behandeln Sie HTML als nicht vertrauenswürdig und lesen Sie die Sicherheits- und Betriebsseite jedes Pakets, bevor Sie benutzerbeeinflusste Eingaben übergeben.

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 Editionen von NextPDF Premium, der bezahlten Produktlinie. Die Installation fügt Fähigkeiten hinzu, ändert aber keine core-API.

Core signiert bereits mit Software-Schlüsseln auf den Baseline-Ebenen B-B und B-T der PDF Advanced Electronic Signatures (PAdES). Die Stufen setzen dort an, wo diese Ebenen enden.

Sie müssen	Stufe	Fähigkeit
Erweiterte Signatur-Workflows ausführen: Remote-, Cloud-KMS- oder sequenzielles Signieren	Pro	Implementierungen von Signatur-Workflows auf Basis der core-Baseline B-B / B-T.
Archivfähige PDF/A-Ausgabe erzeugen	Enterprise	PDF/A-Konformität und Archivierungsprofile.
Eine elektronische Rechnung einbetten (Factur-X / ZUGFeRD)	Pro	Konkrete Implementierungen des E-Rechnungs-Vertrags.
Signaturen mit PAdES B-LT / B-LTA langfristig gültig halten	Enterprise	Document Security Store und Dokument-Zeitstempel für die Archivgültigkeit.
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.

Pro oder Enterprise kaufen

Wenn Sie tatsächlich eine lizenzierte Stufe benötigen, werden kommerzielle Lizenzen über unseren Merchant of Record verkauft – einen autorisierten Wiederverkäufer, der für Ihre Bestellung als Verkäufer (Seller of Record) auftritt – und Ihre Lizenz wird von PATEON gemäß dem End-User License Agreement (EULA) gewährt. Sie beginnen im Lizenzportal, und wir richten Sie über den Checkout unseres Merchant of Record ein, in dem der Preis, etwaige Steuern und Ihre Rechnung abgewickelt werden.

Den vollständigen Weg, das Zwei-Vertrags-Modell (Kauf versus Lizenz) sowie die zuständigen Ansprechpartner für Abrechnung versus Produktunterstützung finden Sie unter Kauf und Lizenzierung.

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, E-Rechnung → Pro. PDF/A, 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 installierenDer genaue Befehl für jede Distribution und jeden Renderer.

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

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

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