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.

Requisitos de tiempo de ejecución de NextPDF, leídos de los propios archivos composer.json de los paquetes

Requisito	Restricción	Estado	Notas
PHP	>=8.4 <9.0	Obligatorio	Composer se niega a instalarse en PHP 8.3 o versiones anteriores, o en PHP 9.
Composer	2.x	Obligatorio	Necesario para la resolución de dependencias y la generación del cargador automático.
ext-mbstring	—	Obligatorio	Gestión de cadenas multibyte para la disposición del texto.
ext-zlib	—	Obligatorio	Compresión de flujos para objetos de Portable Document Format (PDF).
ext-intl	—	Obligatorio	Servicios de International Components for Unicode (ICU): texto bidireccional, salto de línea y formato según la configuración regional.
ext-gd	—	Obligatorio	Decodificación y procesamiento de imágenes rasterizadas para imágenes incrustadas.
ext-curl	—	Obligatorio	Idas y vueltas de red: sellado de tiempo RFC 3161 y descargas de recursos remotos. La generación sin conexión no lo utiliza, pero Composer lo requiere igualmente.
ext-openssl	—	Obligatorio	Criptografía para firmas digitales, estructuras CMS y cifrado.
Chrome or Chromium	—	Opcional	Solo para el renderizador de Artisan (writeHtmlChrome()).
Gotenberg service	—	Opcional	Solo para la conversión de documentos de oficina y HTML a través de Gotenberg.
Python	3.10+	Opcional	Solo para el software development kit (SDK) de Python.

ext-mbstring y ext-zlib vienen habilitadas en la mayoría de los builds de PHP; ext-intl, ext-gd, ext-curl y ext-openssl varían según la distribución, por lo que conviene verificar las seis con php -m antes de instalar. Las integraciones comprueban las extensiones que necesitan al arrancar y se detienen con un mensaje claro si falta alguna.

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 PDFGenera un PDF desde PHP y renderiza HTML a PDF.

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

Compra y licenciamientoCompra una licencia Pro o Enterprise a través de nuestro comerciante de registro y, después, instala y activa.

IntegracionesEl 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.