Instalacja NextPDF Connect

W skrócie

Zainstaluj nextpdf/server za pomocą Composera. Następnie uruchom jeden z trzech punktów wejścia dla transportu. Instalacja podstawowa wymaga tylko PHP 8.4 i silnika NextPDF. Redis oraz Premium są opcjonalne.

Instalacja

composer require nextpdf/server

To polecenie instaluje nextpdf/core: ^3.0. Pakiet deklaruje php: >=8.4 <9.0, więc Composer nie zainstaluje go na PHP 8.3 lub starszym ani na PHP 9.

Przegląd koncepcyjny

To pakiet Composera typu library. Jego instalacja dodaje cztery konsolowe punkty wejścia do vendor/bin/:

• vendor/bin/nextpdf-mcp — serwer stdio protokołu Model Context Protocol (MCP).
• vendor/bin/nextpdf-server — serwer Representational State Transfer (REST) (worker HTTP RoadRunner).
• vendor/bin/nextpdf-grpc — serwer gRPC (worker gRPC RoadRunner).
• vendor/bin/generate-skills — eksportuje katalog narzędzi jako umiejętności agenta.

Piąty skrypt, bin/nextpdf-prune, jest dostępny w repozytorium i służy do zadań konserwacyjnych. Uruchamiaj go bezpośrednio, nie przez vendor/bin/.

Nie potrzebujesz dostawcy usług, bundle ani rejestracji we frameworku. Serwer działa jako samodzielny proces. To nie jest biblioteka podpinana do aplikacji hostującej.

Powierzchnia API

Composer instaluje również zależności wymagane w czasie działania. Te zależności przechodnie obejmują stos Hypertext Transfer Protocol (HTTP) i gRPC:

• league/route i nyholm/psr7 — routing REST oraz komunikaty PHP Standard Recommendation (PSR)-7.
• spiral/roadrunner-http i spiral/roadrunner-grpc — środowisko wykonawcze workera RoadRunner dla transportów REST i gRPC.
• psr/http-server-middleware i psr/http-server-handler — kontrakty middleware PSR-15 implementowane przez potok REST.
• symfony/yaml — parsowanie pliku konfiguracyjnego.
• ramsey/uuid — identyfikatory żądań i zasobów.

Nie instaluj tych pakietów bezpośrednio. Composer rozwiązuje je automatycznie na podstawie nextpdf/server.

Przykład kodu — szybki start

Aby sprawdzić instalację, wyświetl katalog narzędzi bez uruchamiania serwera:

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

To polecenie uruchamia rejestr, przeprowadza wykrywanie poziomu i wypisuje narzędzia udostępniane przez tę instalację. Lista odzwierciedla zainstalowane pakiety opcjonalne. Zobacz /connect/tool-catalog/.

Przykład kodu — produkcja

Instalacja produkcyjna przypina zależność i pomija narzędzia deweloperskie:

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

Dla transportów REST i gRPC zainstaluj również plik binarny RoadRunner. RoadRunner to nadzorca procesów, który zarządza pulą workerów. Pakiet PHP dostarcza workera, a nie nadzorcę:

./vendor/bin/rr get-binary

Przypadki brzegowe i pułapki

• Opcjonalny Redis. Rozszerzenie ext-redis jest pozycją suggest, a nie require. Bez niego serwer REST korzysta z magazynów limitów żądań, idempotentności i dokumentów przechowywanych w pamięci. Te magazyny w pamięci działają poprawnie z pojedynczym workerem, ale nie są współdzielone między workerami w puli. W przypadku wdrożeń z wieloma workerami zainstaluj ext-redis i ustaw zmienne środowiskowe Redis. Zobacz /connect/configuration/.

• Opcjonalny Premium. nextpdf/premium jest pozycją suggest. Po zainstalowaniu go obok serwera sondy wykrywania poziomu w rejestrze znajdują jego klasy dostawcy i rejestrują dodatkowe narzędzia Pro i Enterprise. Bez niego udostępniany jest tylko katalog podstawowy. To decyzja dotycząca pakowania podejmowana w czasie composer require, a nie przełącznik w czasie działania.

• Serwer MCP nie potrzebuje RoadRunnera. nextpdf-mcp to zwykły proces PHP, który komunikuje się za pomocą JavaScript Object Notation Remote Procedure Call (JSON-RPC) przez standardowe wejście i wyjście (stdio). RoadRunner jest wymagany tylko dla transportów REST i gRPC.

Wydajność

Większość czasu instalacji pochłania rozwiązywanie zależności przez Composer. W obrazach produkcyjnych użyj --prefer-dist oraz autorytatywnej mapy klas, aby utrzymać krótki czas autoładowania przy zimnym starcie. Własny koszt rozruchu serwera to skanowanie rejestru i wykrywanie poziomu. Wartość performance_budget na tej stronie ogranicza ten koszt rozruchu.

Uwagi dotyczące bezpieczeństwa

Instaluj wyłącznie z oficjalnego pakietu nextpdf/server w Packagist. Przypnij wersję w composer.json i zatwierdź composer.lock, aby wdrożony katalog narzędzi był odtwarzalny. Transporty sieciowe wymagają klucza application programming interface (API), zanim obsłużą jakikolwiek punkt końcowy inny niż health; zobacz /connect/security-and-operations/.

Zgodność

Ta strona opisuje wyłącznie mechanikę instalacji. Odwołania dotyczące zgodności protokołu i bezpieczeństwa są przypięte na stronach /transports/mcp/, /transports/rest/, /transports/grpc/ oraz /connect/security-and-operations/.

Kontekst komercyjny

Instalacja podstawowa jest w pełni funkcjonalna. Obsługuje tworzenie, inspekcję i diagnostykę dokumentów we wszystkich trzech transportach. Dodanie nextpdf/premium rozszerza katalog bez zmiany transportu ani modelu uwierzytelniania.

Zobacz także

• /connect/overview/ — co oferuje pakiet
• /connect/quickstart/ — pierwsza uruchamialna wymiana
• /connect/configuration/ — zmienne środowiskowe i plik konfiguracyjny
• /connect/deployment/ — RoadRunner, Docker oraz wdrożenie z połączonymi transportami
• /connect/tool-catalog/ — jakie narzędzia udostępnia ta instalacja