NextPDF installieren

Auf einen Blick

Jede NextPDF-Distribution installieren Sie mit einem einzigen Paketmanager-Befehl. PHP-Distributionen verwenden Composer, das Python-SDK verwendet pip. Wählen Sie den Tab, der zu Ihrer Arbeit passt, führen Sie den Befehl aus und bestätigen Sie das Ergebnis anschließend mit dem Verifizierungsschritt am Ende dieser Seite.

Eine Engine, mehrere Eingänge

Die Core-Engine ist nextpdf/core. Framework-Integrationen, HTML-Renderer, der Server und der Python-Client legen jeweils ein Paket obendrauf. Keine davon ersetzt die Core-Engine; alle ziehen sie automatisch mit ein.

Voraussetzungen

NextPDF ist auf genau eine moderne Laufzeitumgebung ausgelegt. Die folgenden Einschränkungen stammen direkt aus den composer.json-Dateien der Pakete.

NextPDF-Laufzeitanforderungen, ausgelesen aus den paketeigenen composer.json-Dateien

Anforderung	Einschränkung	Status	Hinweise
PHP	>=8.4 <9.0	Erforderlich	Composer verweigert die Installation unter PHP 8.3 oder älter sowie unter PHP 9.
Composer	2.x	Erforderlich	Erforderlich für die Auflösung von Abhängigkeiten und die Generierung des Autoloaders.
ext-mbstring	—	Erforderlich	Verarbeitung von Multibyte-Zeichenfolgen für das Textlayout.
ext-zlib	—	Erforderlich	Stream-Komprimierung für Objekte im Portable Document Format (PDF).
ext-intl	—	Erforderlich	Dienste der International Components for Unicode (ICU): bidirektionaler Text, Zeilenumbruch und gebietsschemaabhängige Formatierung.
ext-gd	—	Erforderlich	Decodierung und Verarbeitung von Rasterbildern für eingebettete Bilder.
ext-curl	—	Erforderlich	Netzwerk-Roundtrips: RFC 3161-Zeitstempelung und das Abrufen entfernter Assets. Bei der Offline-Generierung wird sie nicht verwendet. Composer benötigt sie jedoch trotzdem.
ext-openssl	—	Erforderlich	Kryptografie für digitale Signaturen, CMS-Strukturen und Verschlüsselung.
Chrome or Chromium	—	Optional	Nur für den Artisan-Renderer (writeHtmlChrome()).
Gotenberg service	—	Optional	Nur für die Office- und HTML-Konvertierung über Gotenberg.
Python	3.10+	Optional	Nur für das Python software development kit (SDK).

ext-mbstring und ext-zlib sind in den meisten PHP-Builds bereits aktiviert; ext-intl, ext-gd, ext-curl und ext-openssl variieren je nach Distribution — prüfen Sie daher vor der Installation alle sechs mit php -m. Integrationen prüfen die von ihnen benötigten Erweiterungen beim Start und brechen mit einer klaren Meldung ab, wenn eine davon fehlt.

Core installieren

Um PDFs aus PHP zu erzeugen und zu inspizieren, ist die Core-Engine das einzige Paket, das Sie benötigen.

composer require nextpdf/core

Committen Sie composer.lock, damit jeder ausgelieferte Worker dieselbe Engine-Version auflöst. Sobald die Installation abgeschlossen ist, fahren Sie mit Dein erstes PDF fort.

Eine Framework-Integration installieren

Installieren Sie einen Framework-Adapter, um Container-Bindings, Response-Helfer und Queue-Jobs zu erhalten. Jeder Adapter deklariert nextpdf/core und löst es automatisch auf.

Laravel

composer require nextpdf/laravel

Auto-Discovery registriert den Service-Provider und die Pdf-Facade. Veröffentlichen Sie anschließend die Konfigurationsdatei:

php artisan vendor:publish --tag=nextpdf-config

Siehe den Laravel-Installationsleitfaden und den Laravel-Schnellstart.

Symfony

composer require nextpdf/symfony

In einer Symfony-Flex-Anwendung registriert sich das Bundle selbst. In einer Nicht-Flex-Anwendung fügen Sie NextPDF\Symfony\NextPdfBundle selbst zu config/bundles.php hinzu. Siehe den Symfony-Installationsleitfaden.

CodeIgniter

composer require nextpdf/codeigniter

CodeIgniter 4 erkennt die Services-Klasse und den pdf()-Helfer automatisch, sodass keine manuelle Registrierung nötig ist. Siehe den CodeIgniter-Installationsleitfaden.

Einen Renderer oder Dienst installieren

NextPDF rendert HTML auf drei Wegen zu PDF. Installieren Sie die Variante, die dazu passt, wo das Rendering stattfinden soll. Keine davon ersetzt writeHtml(), die eingebaute, reine PHP-HTML-Pipeline in der Core-Engine.

Artisan (Chrome)

composer require nextpdf/artisan

Ergänzt Headless-Chrome-Rendering über das Chrome DevTools Protocol (CDP). Außerdem benötigen Sie eine auf dem Host erreichbare Chrome- oder Chromium-Binärdatei. Sobald die Installation abgeschlossen ist, rufen Sie writeHtmlChrome() auf einem Dokument auf. Siehe den Artisan-Schnellstart.

Cloudflare

composer require nextpdf/cloudflare guzzlehttp/guzzle

Rendert über Cloudflare Browser Rendering am Edge. Die Brücke hängt nur von den Verträgen PSR-18 und PSR-17 ab, sodass Sie Ihren eigenen HTTP-Client bereitstellen (hier mit Guzzle gezeigt). Siehe den Cloudflare-Installationsleitfaden.

Gotenberg

composer require nextpdf/gotenberg guzzlehttp/guzzle

Konvertiert Office-Dokumente und HTML über einen Gotenberg-Dienst. Sie stellen einen PSR-18-Client und eine erreichbare Gotenberg-Instanz bereit. Siehe den Gotenberg-Installationsleitfaden.

Renderer greifen über PHP hinaus

Artisan startet einen Browser-Prozess, und Cloudflare und Gotenberg rufen einen Netzwerkdienst auf. Behandeln Sie HTML als nicht vertrauenswürdig und lesen Sie die Security-and-Operations-Seite jedes Pakets, bevor Sie benutzerbeeinflusste Eingaben rendern.

Den Server installieren

NextPDF Server (auch Connect genannt) ist ein eigenständiger Dienst. Er stellt die Engine über MCP, REST und gRPC bereit.

composer require nextpdf/server

Das Paket fügt Konsolen-Einstiegspunkte zu vendor/bin/ hinzu, darunter vendor/bin/nextpdf-mcp (den MCP-stdio-Server) und vendor/bin/nextpdf-server (den REST-Server). Die REST- und gRPC-Transporte benötigen außerdem die RoadRunner-Binärdatei:

./vendor/bin/rr get-binary

Siehe den Connect-Installationsleitfaden und den Connect-Schnellstart.

Das Python-SDK installieren

Das Python-SDK ist der typisierte Client für einen laufenden NextPDF Server. Installieren Sie es aus PyPI:

pip install nextpdf

Das SDK benötigt Python 3.10 oder neuer und einen erreichbaren NextPDF Server-Endpunkt. Siehe den Python-SDK-Schnellstart.

Installation prüfen

Bestätigen Sie, dass jede Distribution aufgelöst wurde, bevor Sie mit dem Schreiben von Code beginnen.

Core / PHP

composer show nextpdf/core

Eine Versionszeile bestätigt, dass die Engine installiert und im Autoloader ist.

Laravel

php artisan package:discover --ansi

Die Ausgabe listet nextpdf/laravel unter den erkannten Paketen auf.

Symfony

php bin/console debug:container nextpdf

Der Container meldet den Alias nextpdf.document und den Dienst PdfFactory.

Server

./vendor/bin/generate-skills --dry-run --list-tools

Das bootet die Registry und gibt die Tools aus, die diese Installation bereitstellt, ohne tatsächlich einen Server zu starten.

Python

nextpdf version

Eine Versionszeichenkette bestätigt, dass sich das SDK sauber importieren lässt.

Siehe auch

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

Wähle deinen WegEntscheide, welche Distribution und welcher HTML-Renderer zu deiner Anwendung passen.

Kauf und LizenzierungErwirb eine Pro- oder Enterprise-Lizenz über unseren Merchant of Record, dann installiere und aktiviere sie.

IntegrationenDie vollständige Erweiterungsübersicht und der Auswahlleitfaden.

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