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 richtet sich an genau eine moderne Laufzeitumgebung. Die folgenden Einschränkungen stammen direkt aus den composer.json-Dateien der Pakete.

Voraussetzung	Einschränkung	Hinweise
PHP	>=8.4 <9.0	Composer verweigert die Installation auf PHP 8.3 oder älter sowie auf PHP 9.
Composer	2.7 oder neuer	Abhängigkeitsauflöser und Autoloader-Generator.
ext-mbstring	Erforderlich	Multibyte-Zeichenkettenverarbeitung für das Text-Layout.
ext-zlib	Erforderlich	Stream-Komprimierung für PDF-Objekte.
Chrome oder Chromium	Optional	Nur für den Artisan-Renderer (writeHtmlChrome()).
Gotenberg-Dienst	Optional	Nur für Office- und HTML-Konvertierung über Gotenberg.
Python	3.10 oder neuer	Nur für das Python-SDK.

ext-mbstring und ext-zlib werden in jedem unterstützten PHP-Build aktiviert ausgeliefert. Integrationen prüfen sie beim Start und brechen mit einer klaren Meldung ab, wenn eine der Erweiterungen 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. Behandle HTML als nicht vertrauenswürdig und lies 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. Installiere 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 PDF Erzeuge ein PDF aus PHP und rendere HTML zu PDF.

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

Integrationen Die vollständige Erweiterungsübersicht und der Auswahlleitfaden.

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