Elegir la ruta adecuada

De un vistazo

NextPDF ofrece varias maneras de empezar. La adecuada depende de dónde se ejecute su código y del tipo de salida que necesite. Esta página resuelve por usted tres decisiones: qué distribución instalar, qué representador de HTML usar y cuándo una carga de trabajo requiere el nivel Pro o Enterprise.

Lea la sección que responde a su pregunta o eche un vistazo al resumen de decisión del final.

Elegir una distribución

Empezar por la forma en que la aplicación llama al motor. La primera fila que coincida con la situación es la respuesta.

Su situación	Instalación	Por qué
Un proyecto PHP simple, una biblioteca o una herramienta de CLI	NextPDF core (nextpdf/core)	Solo el motor. No presupone ningún framework ni ejecuta ningún servicio.
Una aplicación de Laravel, Symfony o CodeIgniter	La integración de framework correspondiente	Aporta enlaces de contenedor, ayudantes de respuesta y trabajos de cola sobre core.
Un servicio que no es PHP, un agente u otro entorno de ejecución que deba llamar al motor a través de una red	NextPDF Server (nextpdf/server)	Un único servicio expone el motor mediante MCP, REST y gRPC.
Código de Python que necesita PDF de un NextPDF Server	El SDK de Python (pip install nextpdf)	Un cliente tipado para un servidor en ejecución. No incorpora el motor.

Dos puntos suelen causar confusión:

• Una integración de framework incluye core. No instale ambos por separado. El adaptador declara y resuelve nextpdf/core por usted.
• El SDK de Python es un cliente, no un motor. Necesita un punto de conexión de NextPDF Server con el que comunicarse. La generación de PDF ocurre en PHP en el lado del servidor.

¿Biblioteca o servicio?

Si la aplicación PHP puede enlazar la biblioteca, conviene preferir core o una integración de framework. Es un proceso menos que ejecutar y ofrece menor latencia. Conviene recurrir al servidor cuando algo que no es PHP necesita el motor, o cuando se quiere un único servicio de representación compartido entre muchos invocadores.

Elegir un representador de HTML

NextPDF representa HTML a PDF de cuatro maneras. La canalización integrada cubre la mayoría de los documentos sin configuración adicional. Los tres paquetes de representador están pensados para cuando hace falta un diseño con calidad de navegador o se quiere usar un servicio existente.

Representador	Paquete	Dónde se ejecuta	Elíjalo cuando
Integrado writeHtml()	nextpdf/core	En el proceso, PHP puro	Se necesita un subconjunto admitido de HTML y CSS sin navegador y sin llamadas de red.
Artisan	nextpdf/artisan	Chrome sin interfaz en el host	Necesita el diseño completo de Chrome —flexbox, grid, selectores complejos, fuentes web— con texto seleccionable.
Cloudflare	nextpdf/cloudflare	Cloudflare Browser Rendering en el perímetro	La representación pertenece al perímetro, o se quieren mantener los procesos de navegador fuera de los hosts propios.
Gotenberg	nextpdf/gotenberg	Un servicio de Gotenberg que usted opera	Convierte documentos de oficina (DOCX, XLSX) o HTML mediante una implementación de Gotenberg existente.

Cómo leer la tabla:

• Recurra primero a la canalización integrada. Es la ruta más rápida y no tiene ninguna dependencia externa. Antes de depender de una propiedad, confírmela en la matriz de compatibilidad de CSS.
• Pase a Artisan cuando un diseño supere el subconjunto admitido y la representación deba permanecer en la infraestructura propia. Inicia un proceso de Chrome, así que hay que planificar ese ciclo de vida.
• Pase a Cloudflare cuando se quiera la misma fidelidad de navegador, pero se prefiera representar en el perímetro en lugar de ejecutar navegadores localmente.
• Pase a Gotenberg para la conversión de documentos de oficina, o cuando ya se ejecute Gotenberg y se quiera que NextPDF lo controle.

Los representadores amplían la superficie de amenaza

De forma predeterminada, la canalización integrada no ejecuta scripts ni obtiene recursos remotos. Artisan, Cloudflare y Gotenberg representan cada uno mediante un navegador o un servicio de red. Trate el HTML como no confiable y lea la página de seguridad y operaciones de cada paquete antes de pasar entradas influidas por el usuario.

Cuándo hace falta Pro o Enterprise

El motor core genera, representa e inspecciona PDF sin coste y sin licencia. NextPDF Pro y NextPDF Enterprise son los dos niveles con licencia del paquete nextpdf/premium. Instalarlo agrega funcionalidades y no cambia ninguna API de core.

Necesita	Nivel	Funcionalidad
Firmar digitalmente un PDF (PAdES baseline)	Pro	Implementaciones concretas de firma con clave de software.
Producir salida PDF/A de archivo	Pro	Conformidad con PDF/A y perfiles de archivo.
Incrustar una factura electrónica (Factur-X / ZUGFeRD)	Pro	Implementaciones concretas del contrato de factura electrónica.
Firmar con un módulo de seguridad de hardware (HSM)	Enterprise	Operaciones de clave respaldadas por hardware.
Emitir firmas electrónicas cualificadas	Enterprise	Flujo de trabajo de firma cualificada y la superficie completa de conformidad.

Dos reglas mantienen honesta la decisión:

• Si su salida son PDF sin firmar y no destinados a archivo, core es suficiente. No necesita una licencia.
• Cuando se instala nextpdf/premium, las integraciones de framework y el servidor lo detectan automáticamente. Exponen la funcionalidad adicional a través de las mismas claves de contenedor y el mismo catálogo de herramientas. La aplicación no necesita ningún cambio de código para adoptarla.

Resumen de decisión

Distribución

PHP simple → core. Una aplicación con framework → la integración correspondiente. Un límite de red → el servidor. Cliente de Python → el SDK de Python.

Representador de HTML

Subconjunto admitido, sin dependencia → writeHtml(). Fidelidad de navegador en sus hosts → Artisan. En el perímetro → Cloudflare. Conversión de Office → Gotenberg.

Nivel con licencia

PDF sin firmar → core. Firma, PDF/A, factura electrónica → Pro. HSM o firmas cualificadas → Enterprise.

¿Aún no lo tiene claro?

Instale core, ejecute Su primer PDF y agregue un paquete solo cuando aparezca una necesidad concreta. Puede cambiar cualquiera de estas opciones más adelante.

Consulte también

Instalar NextPDF El comando exacto para cada distribución y representador.

Su primer PDF Genere un PDF desde PHP y represente HTML a PDF.

Integraciones El mapa completo de extensiones, la guía de selección y los manuales por paquete.

Conectar (servidor) Ejecute el motor como servicio de red a través de MCP, REST y gRPC.