NextPDF Connect installeren

In een oogopslag

Installeer nextpdf/server met Composer. Start daarna een van de drie transporttoegangspunten. De core-installatie vereist alleen PHP 8.4 en de NextPDF-engine. Redis en Premium zijn optioneel.

Installeren

composer require nextpdf/server

Deze opdracht installeert nextpdf/core: ^3.0. Het pakket declareert php: >=8.4 <9.0, waardoor Composer de installatie weigert op PHP 8.3 of lager, of op PHP 9.

Conceptueel overzicht

Het pakket is een Composer-pakket van het type library. Bij installatie voegt het vier consoletoegangspunten toe aan vendor/bin/:

• vendor/bin/nextpdf-mcp — de stdio-server voor het Model Context Protocol (MCP).
• vendor/bin/nextpdf-server — de Representational State Transfer (REST)-server (RoadRunner HTTP-worker).
• vendor/bin/nextpdf-grpc — de gRPC-server (RoadRunner gRPC-worker).
• vendor/bin/generate-skills — exporteert de tool-catalogus als agent-skills.

Een vijfde script, bin/nextpdf-prune, wordt voor onderhoudstaken meegeleverd in de repository. Voer het rechtstreeks uit in plaats van via vendor/bin/.

U hebt geen service provider, bundle of frameworkregistratie nodig. De server draait als zelfstandig proces. Het is geen library die u in een hosttoepassing inbouwt.

API-oppervlak

Composer installeert ook de runtime-afhankelijkheden van het pakket. Onder deze transitieve afhankelijkheden vallen de Hypertext Transfer Protocol (HTTP)- en gRPC-stack:

• league/route en nyholm/psr7 — REST-routering en PHP Standard Recommendation (PSR)-7-berichten.
• spiral/roadrunner-http en spiral/roadrunner-grpc — de RoadRunner-worker-runtime voor de REST- en gRPC-transporten.
• psr/http-server-middleware en psr/http-server-handler — de PSR-15-middleware-contracten die de REST-pipeline implementeert.
• symfony/yaml — het parsen van configuratiebestanden.
• ramsey/uuid — request- en resource-identifiers.

Installeer deze pakketten niet rechtstreeks. Composer lost ze voor u op via nextpdf/server.

Codevoorbeeld — snelstart

Controleer de installatie door de tool-catalogus te tonen zonder een server te starten:

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

Deze opdracht start het register, voert niveaudetectie uit en toont de tools die deze installatie beschikbaar stelt. De lijst weerspiegelt de optionele pakketten die aanwezig zijn. Zie /connect/tool-catalog/.

Codevoorbeeld — productie

Een productie-installatie legt de afhankelijkheid vast en slaat ontwikkeltooling over:

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

Installeer voor de REST- en gRPC-transporten ook de RoadRunner-binary. RoadRunner is de process supervisor die de worker-pool beheert. Het PHP-pakket levert de worker, niet de supervisor:

./vendor/bin/rr get-binary

Randgevallen en valkuilen

• Optionele Redis. De ext-redis-extensie is een suggest, geen require. Zonder die extensie gebruikt de REST-server in-memory stores voor rate-limiting, idempotentie en documenten. Die in-memory stores zijn correct voor één worker, maar worden niet gedeeld tussen meerdere workers in een pool. Installeer voor implementaties met meerdere workers ext-redis en stel de Redis-omgevingsvariabelen in. Zie /connect/configuration/.

• Optionele Premium. nextpdf/premium is een suggest. Wanneer u het naast de server installeert, vinden de niveaudetectieprobes van het register de providerklassen ervan en registreren ze de aanvullende Pro- en Enterprise-tools. Zonder dat pakket wordt alleen de core-catalogus aangeboden. Dit is een packagingbeslissing die op het moment van composer require wordt genomen, geen runtime-schakelaar.

• De MCP-server heeft geen RoadRunner nodig. nextpdf-mcp is een eenvoudig PHP-proces dat JavaScript Object Notation Remote Procedure Call (JSON-RPC) spreekt via standaardinvoer en -uitvoer (stdio). RoadRunner is alleen vereist voor de REST- en gRPC-transporten.

Prestaties

Het oplossen van afhankelijkheden door Composer bepaalt grotendeels de installatiekosten. Gebruik in productie-images --prefer-dist en een authoritative classmap om de cold-boot-autoloadtijd laag te houden. De eigen opstartkosten van de server bestaan uit de registerscan en de niveaudetectie. Het performance_budget op deze pagina begrenst die opstartkosten.

Beveiligingsnotities

Installeer uitsluitend vanuit het officiële Packagist-pakket nextpdf/server. Leg de versie vast in composer.json en commit composer.lock zodat de uitgerolde tool-catalogus reproduceerbaar is. Netwerktransporten vereisen een application programming interface (API)-sleutel voordat ze welk non-health-endpoint dan ook bedienen; zie /connect/security-and-operations/.

Conformiteit

Deze pagina beschrijft uitsluitend hoe de installatie werkt. Conformiteitscitaten voor protocol en beveiliging zijn vastgelegd op /transports/mcp/, /transports/rest/, /transports/grpc/ en /connect/security-and-operations/.

Commerciële context

De core-installatie is volledig functioneel. Deze verzorgt het maken, inspecteren en diagnosticeren van documenten via alle drie de transporten. Het toevoegen van nextpdf/premium breidt de catalogus uit zonder het transport- of authenticatiemodel te wijzigen.

Zie ook

• /connect/overview/ — wat het pakket biedt
• /connect/quickstart/ — eerste uitvoerbare uitwisseling
• /connect/configuration/ — omgevingsvariabelen en het configuratiebestand
• /connect/deployment/ — RoadRunner, Docker en gecombineerde-transport-implementatie
• /connect/tool-catalog/ — welke tools deze installatie beschikbaar stelt