NextPDF Connect installieren

Auf einen Blick

Installieren Sie nextpdf/server mit Composer. Führen Sie anschließend einen der drei Transporteinstiegspunkte aus. Die Core-Installation benötigt nur PHP 8.4 und die NextPDF-Engine. Redis und Premium sind optional.

Installation

composer require nextpdf/server

Dieser Befehl installiert nextpdf/core: ^3.0 als Abhängigkeit mit. Das Paket deklariert php: >=8.4 <9.0, sodass Composer die Installation unter PHP 8.3 oder älter sowie unter PHP 9 verweigert.

Konzeptioneller Überblick

Das Paket ist ein Composer-Paket des Typs library. Die Installation fügt vendor/bin/ vier Konsoleneinstiegspunkte hinzu:

• vendor/bin/nextpdf-mcp — der MCP-stdio-Server.
• vendor/bin/nextpdf-server — der REST-Server (RoadRunner-HTTP-Worker).
• vendor/bin/nextpdf-grpc — der gRPC-Server (RoadRunner-gRPC-Worker).
• vendor/bin/generate-skills — exportiert den Tool-Katalog als Agent-Skills.

Ein fünftes Skript, bin/nextpdf-prune, liegt dem Repository für Wartungsaufgaben bei. Rufen Sie es direkt auf, nicht über vendor/bin/.

Eine Registrierung über einen Service Provider, ein Bundle oder ein Framework ist nicht erforderlich. Der Server läuft als eigenständiger Prozess. Es handelt sich nicht um eine Bibliothek, die Sie in eine Host-Anwendung einbinden.

API-Oberfläche

Composer installiert außerdem die Laufzeitabhängigkeiten des Pakets. Zu diesen transitiven Abhängigkeiten gehört der HTTP- und gRPC-Stack:

• league/route und nyholm/psr7 — REST-Routing und PSR-7-Nachrichten.
• spiral/roadrunner-http und spiral/roadrunner-grpc — die RoadRunner-Worker-Laufzeit für die REST- und gRPC-Transporte.
• psr/http-server-middleware und psr/http-server-handler — die PSR-15-Middleware-Verträge, die von der REST-Pipeline implementiert werden.
• symfony/yaml — Parsen der Konfigurationsdatei.
• ramsey/uuid — Bezeichner für Requests und Ressourcen.

Diese installieren Sie nicht direkt. Composer löst sie für Sie aus nextpdf/server auf.

Codebeispiel — Schnellstart

Um die Installation zu prüfen, zeigen Sie den Tool-Katalog an, ohne einen Server zu starten:

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

Dieser Befehl startet die Registry, führt die Stufenerkennung aus und gibt die Tools aus, die diese Installation bereitstellt. Die Liste zeigt, welche optionalen Pakete vorhanden sind. Siehe /connect/tool-catalog/.

Codebeispiel — Produktion

Eine Produktionsinstallation fixiert die Abhängigkeit und überspringt das Entwicklungs-Tooling:

composer require nextpdf/server --no-dev
composer install --no-dev --optimize-autoloader --classmap-authoritative

Für die REST- und gRPC-Transporte installieren Sie zusätzlich das RoadRunner-Binary. RoadRunner ist der Prozess-Supervisor, dem der Worker-Pool gehört. Das PHP-Paket stellt den Worker bereit, nicht den Supervisor:

./vendor/bin/rr get-binary

Sonderfälle und Fallstricke

• Optionales Redis. Die Erweiterung ext-redis ist als suggest deklariert, nicht als require. Ohne sie verwendet der REST-Server In-Memory-Speicher für Rate-Limit, Idempotenz und Dokumente. Diese In-Memory-Speicher arbeiten für einen einzelnen Worker korrekt, werden aber in einem Multi-Worker-Pool nicht geteilt. Für Multi-Worker-Deployments installieren Sie ext-redis und setzen die Redis-Umgebungsvariablen. Siehe /connect/configuration/.

• Optionales Premium. nextpdf/premium ist ein suggest. Wenn Sie es zusammen mit dem Server installieren, finden die Stufenerkennungs-Probes der Registry dessen Provider-Klassen. Die Probes registrieren dann die zusätzlichen Pro- und Enterprise-Tools. Ohne dieses Paket wird nur der Core-Katalog ausgeliefert. Das ist eine Packaging-Entscheidung zum Zeitpunkt von composer require, kein Laufzeitschalter.

• Der MCP-Server benötigt kein RoadRunner. nextpdf-mcp ist ein einfacher PHP-Prozess, der JSON-RPC über stdio spricht. RoadRunner ist nur für die REST- und gRPC-Transporte erforderlich.

Performance

Die Abhängigkeitsauflösung durch Composer macht den größten Teil der Installationszeit aus. Verwenden Sie in Produktions-Images --prefer-dist und eine autoritative Classmap, um die Autoload-Zeit beim Kaltstart niedrig zu halten. Der servereigene Startaufwand besteht aus dem Registry-Scan und der Stufenerkennung. Das performance_budget auf dieser Seite begrenzt diesen Startaufwand.

Sicherheitshinweise

Installieren Sie ausschließlich aus dem offiziellen Packagist-Paket nextpdf/server. Fixieren Sie die Version in composer.json und committen Sie composer.lock, damit der ausgelieferte Tool-Katalog reproduzierbar ist. Netzwerk-Transporte verlangen einen API-Schlüssel, bevor sie einen anderen Endpunkt als die Health-Prüfung bedienen; siehe /connect/security-and-operations/.

Konformität

Diese Seite beschreibt ausschließlich die Mechanik der Installation. Belege zur Protokoll- und Sicherheitskonformität sind auf /transports/mcp/, /transports/rest/, /transports/grpc/ und /connect/security-and-operations/. verankert.

Kommerzieller Kontext

Die Core-Installation ist voll funktionsfähig. Sie übernimmt Dokumenterstellung, Inspektion und Diagnose über alle drei Transporte. Das Hinzufügen von nextpdf/premium erweitert den Katalog, ohne das Transport- oder Authentifizierungsmodell zu ändern.

Siehe auch

• /connect/overview/ — was das Paket bereitstellt
• /connect/quickstart/ — der erste lauffähige Austausch
• /connect/configuration/ — Umgebungsvariablen und die Konfigurationsdatei
• /connect/deployment/ — RoadRunner, Docker und Deployment mit kombiniertem Transport
• /connect/tool-catalog/ — welche Tools diese Installation bereitstellt