Instalar NextPDF

En resumen

Cada distribución de NextPDF se instala con un solo comando del gestor de paquetes. Las distribuciones para PHP usan Composer; el SDK de Python usa pip. Basta con elegir la pestaña que corresponda a lo que se está construyendo, ejecutar el comando y, después, confirmar el resultado con el paso de verificación del final de esta página.

Un motor, varias puertas de entrada

El motor principal es nextpdf/core. Las integraciones con frameworks, los renderers de HTML, el servidor y el cliente de Python añaden, cada uno, un paquete adicional. Ninguno de ellos reemplaza el motor principal; todos lo incorporan automáticamente.

Requisitos

NextPDF está orientado a un único entorno de ejecución moderno. Las restricciones siguientes provienen directamente de los archivos composer.json de los paquetes.

Requisito	Restricción	Notas
PHP	>=8.4 <9.0	Composer rechaza la instalación en PHP 8.3 o inferior, o en PHP 9.
Composer	2.7 o posterior	El resolvedor de dependencias y el generador del autoloader.
ext-mbstring	Obligatorio	Manejo de cadenas multibyte para la composición del texto.
ext-zlib	Obligatorio	Compresión de flujos para los objetos del PDF.
Chrome o Chromium	Opcional	Solo para el renderer de Artisan (writeHtmlChrome()).
Servicio de Gotenberg	Opcional	Solo para la conversión de documentos de Office y de HTML mediante Gotenberg.
Python	3.10 o posterior	Solo para el SDK de Python.

ext-mbstring y ext-zlib están habilitadas en cada build de PHP compatible. Las integraciones las comprueban al arrancar y se detienen con un mensaje claro si falta alguna de las dos.

Instalar el motor principal

Para generar e inspeccionar PDF desde PHP, el motor principal es el único paquete necesario.

composer require nextpdf/core

Confirmar composer.lock en el control de versiones asegura que cada worker desplegado resuelva la misma versión del motor. Una vez instalado, se puede continuar con Tu primer PDF.

Instalar una integración con un framework

Instalar un adaptador de framework permite obtener bindings del contenedor, helpers de respuesta y jobs de cola. Cada adaptador declara nextpdf/core y lo resuelve automáticamente.

Laravel

composer require nextpdf/laravel

El autodescubrimiento registra el service provider y el facade Pdf. Luego, se publica el archivo de configuración:

php artisan vendor:publish --tag=nextpdf-config

Consultar la guía de instalación de Laravel y la guía rápida de Laravel.

Symfony

composer require nextpdf/symfony

En una aplicación con Symfony Flex, el bundle se registra automáticamente. En una aplicación sin Flex, añadir NextPDF\Symfony\NextPdfBundle a config/bundles.php manualmente. Consultar la guía de instalación de Symfony.

CodeIgniter

composer require nextpdf/codeigniter

CodeIgniter 4 descubre automáticamente la clase Services y el helper pdf(), por lo que no se requiere ningún registro manual. Consultar la guía de instalación de CodeIgniter.

Instalar un renderer o servicio

NextPDF renderiza HTML a PDF de tres maneras. Instalar la opción que corresponda al lugar donde deba realizarse el renderizado. Ninguna de ellas reemplaza a writeHtml(), la pipeline de HTML en PHP puro integrada en el motor principal.

Artisan (Chrome)

composer require nextpdf/artisan

Este paquete añade renderizado con headless Chrome a través del Chrome DevTools Protocol (CDP). También se necesita un binario de Chrome o Chromium accesible en el host. Una vez instalado, llamar a writeHtmlChrome() en un documento. Consultar la guía rápida de Artisan.

Cloudflare

composer require nextpdf/cloudflare guzzlehttp/guzzle

Renderiza a través de Cloudflare Browser Rendering en el edge. El puente depende únicamente de los contratos PSR-18 y PSR-17, por lo que se proporciona un cliente HTTP propio (aquí se muestra Guzzle). Consultar la guía de instalación de Cloudflare.

Gotenberg

composer require nextpdf/gotenberg guzzlehttp/guzzle

Convierte documentos de Office y HTML a través de un servicio de Gotenberg. Es necesario proporcionar un cliente PSR-18 y una instancia de Gotenberg accesible. Consultar la guía de instalación de Gotenberg.

Los renderers salen fuera de PHP

Artisan lanza un proceso de navegador, y Cloudflare y Gotenberg llaman a un servicio de red. Tratar el HTML como no confiable y leer la página de seguridad y operaciones de cada paquete antes de renderizar entrada influida por el usuario.

Instalar el servidor

NextPDF Server (también llamado Connect) es un servicio independiente. Expone el motor a través de MCP, REST y gRPC.

composer require nextpdf/server

El paquete añade puntos de entrada de consola a vendor/bin/, incluidos vendor/bin/nextpdf-mcp (el servidor MCP por stdio) y vendor/bin/nextpdf-server (el servidor REST). Los transportes REST y gRPC también necesitan el binario de RoadRunner:

./vendor/bin/rr get-binary

Consultar la guía de instalación de Connect y la guía rápida de Connect.

Instalar el SDK de Python

El SDK de Python es el cliente tipado para un NextPDF Server en ejecución. Se instala desde PyPI:

pip install nextpdf

El SDK necesita Python 3.10 o posterior y un endpoint accesible de NextPDF Server. Consultar la guía rápida del SDK de Python.

Verificar la instalación

Confirmar que cada distribución se haya resuelto antes de empezar a escribir código.

Core / PHP

composer show nextpdf/core

Una línea con la versión confirma que el motor está instalado y en el autoloader.

Laravel

php artisan package:discover --ansi

La salida lista nextpdf/laravel entre los paquetes descubiertos.

Symfony

php bin/console debug:container nextpdf

El contenedor muestra el alias nextpdf.document y el servicio PdfFactory.

Servidor

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

Este comando arranca el registro e imprime las herramientas que expone esta instalación, sin iniciar realmente un servidor.

Python

nextpdf version

Una cadena con la versión confirma que el SDK se importa correctamente.

Véase también

Tu primer PDF Genera un PDF desde PHP y renderiza HTML a PDF.

Elige tu camino Decide qué distribución y qué renderer de HTML se ajustan a tu aplicación.

Integraciones El mapa completo de extensiones y la guía de selección.

Connect (servidor) Ejecuta el motor como un servicio de red a través de MCP, REST y gRPC.