Instalar NextPDF Connect

Resumen rápido

Instala nextpdf/server con Composer. Luego ejecuta uno de los tres puntos de entrada de transporte. La instalación base solo requiere PHP 8.4 y el motor NextPDF. Redis y Premium son opcionales.

Instalación

composer require nextpdf/server

Este comando incorpora nextpdf/core: ^3.0. El paquete declara php: >=8.4 <9.0, por lo que Composer rechaza la instalación en PHP 8.3 o versiones anteriores, o en PHP 9.

Visión conceptual

Es un paquete de Composer de tipo library. Al instalarlo, se añaden cuatro puntos de entrada de consola a vendor/bin/:

• vendor/bin/nextpdf-mcp — el servidor MCP sobre stdio.
• vendor/bin/nextpdf-server — el servidor REST (worker HTTP de RoadRunner).
• vendor/bin/nextpdf-grpc — el servidor gRPC (worker gRPC de RoadRunner).
• vendor/bin/generate-skills — exporta el catálogo de herramientas como skills de agente.

Un quinto script, bin/nextpdf-prune, se incluye en el repositorio para tareas de mantenimiento. Se ejecuta directamente, en lugar de hacerlo a través de vendor/bin/.

No interviene ningún service provider, bundle ni registro de framework. El servidor es un proceso independiente. No es una biblioteca para conectar a una aplicación anfitriona.

Superficie de la API

Composer también instala las dependencias de ejecución del paquete. Estas dependencias transitivas incluyen la pila HTTP y gRPC:

• league/route y nyholm/psr7 — enrutamiento REST y mensajes PSR-7.
• spiral/roadrunner-http y spiral/roadrunner-grpc — el entorno de ejecución de workers de RoadRunner para los transportes REST y gRPC.
• psr/http-server-middleware y psr/http-server-handler — los contratos de middleware PSR-15 que implementa la canalización REST.
• symfony/yaml — análisis de archivos de configuración.
• ramsey/uuid — identificadores de solicitudes y recursos.

No hace falta instalar estas dependencias directamente. Composer las resuelve automáticamente a partir de nextpdf/server.

Ejemplo de código — Inicio rápido

Para comprobar la instalación, lista el catálogo de herramientas sin iniciar un servidor:

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

Este comando inicializa el registro, ejecuta la detección de nivel e imprime las herramientas que expone esta instalación. La lista refleja qué paquetes opcionales están presentes. Consulta /connect/tool-catalog/.

Ejemplo de código — Producción

Una instalación de producción fija la dependencia y omite las herramientas de desarrollo:

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

Para los transportes REST y gRPC, instala también el binario de RoadRunner. RoadRunner es el supervisor de procesos que controla el grupo de workers. El paquete PHP proporciona el worker, no el supervisor:

./vendor/bin/rr get-binary

Casos límite y puntos problemáticos

• Redis opcional. La extensión ext-redis es un suggest, no un require. Sin ella, el servidor REST usa almacenes en memoria para el límite de tasa, la idempotencia y los documentos. Esos almacenes en memoria son correctos para un solo worker, pero no se comparten dentro de un grupo de varios workers. Para despliegues con varios workers, instala ext-redis y define las variables de entorno de Redis. Consulta /connect/configuration/.

• Premium opcional. nextpdf/premium es un suggest. Cuando se instala junto con el servidor, las sondas de detección de nivel del registro encuentran sus clases de proveedor. Entonces las sondas registran las herramientas adicionales de Pro y Enterprise. Sin él, solo se expone el catálogo base. Esta es una decisión de empaquetado que se toma en el momento del composer require, no un interruptor en tiempo de ejecución.

• El servidor MCP no necesita RoadRunner. nextpdf-mcp es un proceso PHP normal que se comunica mediante JSON-RPC sobre stdio. RoadRunner solo se requiere para los transportes REST y gRPC.

Rendimiento

La resolución de dependencias de Composer representa la mayor parte del tiempo de instalación. En las imágenes de producción, usa --prefer-dist y un classmap autoritativo para mantener bajo el tiempo de autoload en arranque en frío. El costo propio del arranque del servidor proviene del escaneo del registro y de la detección de nivel. El performance_budget de esta página acota ese costo de arranque.

Notas de seguridad

Instala únicamente desde el paquete oficial de Packagist nextpdf/server. Fija la versión en composer.json y confirma composer.lock para que el catálogo de herramientas desplegado sea reproducible. Los transportes en red requieren una clave de API antes de servir cualquier endpoint que no sea un endpoint de estado; consulta /connect/security-and-operations/.

Conformidad

Esta página describe únicamente la mecánica de instalación. Las citas de conformidad de protocolo y seguridad están fijadas en /transports/mcp/, /transports/rest/, /transports/grpc/ y /connect/security-and-operations/.

Contexto comercial

La instalación base es totalmente funcional. Gestiona la creación, inspección y diagnóstico de documentos a través de los tres transportes. Añadir nextpdf/premium amplía el catálogo sin cambiar el modelo de transporte ni de autenticación.

Consulta también

• /connect/overview/ — qué proporciona el paquete
• /connect/quickstart/ — primer intercambio ejecutable
• /connect/configuration/ — variables de entorno y el archivo de configuración
• /connect/deployment/ — RoadRunner, Docker y despliegue de transportes combinados
• /connect/tool-catalog/ — qué herramientas expone esta instalación