Primeros pasos con NextPDF

De un vistazo

NextPDF es un motor para PHP 8.4 que genera e inspecciona documentos PDF 2.0, el formato de archivo definido por ISO 32000-2. Permite construir documentos con una API tipada y fluida, renderizar HTML y CSS en páginas, firmar y archivar el resultado, y volver a leer su contenido estructurado. Todo se ejecuta en PHP, y las rutas principales del núcleo no requieren binarios externos.

El proyecto se ofrece en cuatro distribuciones. Todas comparten el mismo motor por debajo, así que conviene instalar la que mejor se ajuste a la forma de trabajo.

Distribución	Paquete	Cuándo instalarla
NextPDF núcleo (OSS)	`nextpdf/core`	Se escribe PHP y se quiere usar el motor directamente, ya sea con un framework o por cuenta propia.
NextPDF Server (OSS)	`nextpdf/server`	Se necesita un servicio independiente que exponga el motor a través de MCP, REST y gRPC.
NextPDF Pro	`nextpdf/premium` (nivel Pro)	Se necesita firma digital, archivado PDF/A o salida de factura electrónica.
NextPDF Enterprise	`nextpdf/premium` (nivel Enterprise)	Se necesita firma respaldada por hardware, firmas cualificadas y toda la superficie de cumplimiento.

NextPDF Pro y NextPDF Enterprise son dos niveles bajo licencia del mismo paquete nextpdf/premium. El motor del núcleo funciona igual tanto si ese paquete está presente como si no.

Instalar en una línea

En un proyecto de PHP sencillo, basta con instalar el motor del núcleo con Composer.

composer require nextpdf/core

Ese único paquete genera e inspecciona PDF sin configuración adicional. Las integraciones con frameworks, los renderers de HTML, el servidor y el SDK de Python se añaden como paquetes adicionales. La guía de instalación enumera todos los comandos.

Elige tu camino

NextPDF se adapta al código existente. Elegir el punto de entrada que se ajuste al stack y luego seguir su ficha.

Instalación La matriz de instalación completa: núcleo, integraciones de framework, renderers de HTML, el servidor y el SDK de Python.

Tu primer PDF Un tutorial breve que genera un PDF desde PHP y luego renderiza HTML a PDF.

Elige tu camino Una guía de decisión sobre el núcleo frente a un framework frente al servidor, y qué renderer de HTML usar.

Integraciones Adaptadores de framework, renderers de navegador, servicios de edge y paquetes de migración.

Adónde ir después

Una vez generado el primer documento, estas son las tres áreas principales de la documentación.

Guías e integraciones Opera el paquete que se ajuste a tu framework, renderer, runtime o destino de migración: Laravel, Symfony, CodeIgniter, Artisan, Cloudflare y Gotenberg.

Referencia de la API La superficie verificada del motor: clases, métodos, claves de configuración y la matriz de compatibilidad de CSS.

Cookbook Recipes centradas en tareas: renderizar HTML a PDF, dar estilo con CSS, maquetar tablas y paginar contenido largo.

¿Por qué un servidor aparte?

Instalar NextPDF Server cuando un servicio ajeno a PHP, un agente u otro runtime necesite llamar al motor a través de un protocolo de red, en lugar de vincular la biblioteca. El SDK de Python es el cliente tipado para ese servidor.