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 las dos ediciones con licencia de NextPDF Premium, la línea de pago. Instalarlo agrega funcionalidades y no cambia ninguna API de core.

Core ya firma en los niveles baseline B-B y B-T de PDF Advanced Electronic Signatures (PAdES) con claves de software. Los niveles con licencia empiezan donde terminan esos niveles.

Necesita	Nivel	Funcionalidad
Ejecutar flujos de trabajo de firma avanzados: firma remota, con KMS en la nube o secuencial	Pro	Implementaciones de flujos de trabajo de firma sobre el baseline B-B / B-T de core.
Producir salida PDF/A de archivo	Enterprise	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.
Mantener las firmas válidas a largo plazo con PAdES B-LT / B-LTA	Enterprise	Document Security Store y sellos de tiempo de documento para la validez de archivo.
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.

Comprar Pro o Enterprise

Cuando sí necesita un nivel con licencia, las licencias comerciales se venden a través de nuestro comerciante de registro —un revendedor autorizado que actúa como vendedor de registro de su pedido— y su licencia la concede PATEON en virtud del End-User License Agreement (EULA). Empieza en el portal de licencias y le damos de alta a través del proceso de compra de nuestro comerciante de registro, donde se gestionan el precio, los impuestos correspondientes y su factura.

Consulte Compra y licenciamiento para conocer la vía completa, el modelo de dos contratos (compra frente a licencia) y a quién dirigirse para cuestiones de facturación frente a ayuda sobre el producto.

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, factura electrónica → Pro. PDF/A, 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 NextPDFEl comando exacto para cada distribución y representador.

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

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