Guías

De un vistazo

Esta sección traza el mapa de la documentación conceptual y práctica de NextPDF, un motor headless de Portable Document Format 2.0 (PDF 2.0) para PHP 8.4. Cada tarjeta de abajo apunta al hub de una sección, no a una página individual. Usa este mapa para encontrar el punto de partida adecuado y luego sigue los enlaces dentro de ese hub.

Las guías responden al cómo y al porqué. Si buscas una recipe orientada a tareas, accionable y copiable, consulta el Cookbook. Si necesitas la superficie de API verificada y las matrices de compatibilidad, consulta la Referencia.

Guías de integración

Las extensiones de NextPDF conectan el motor principal con frameworks de aplicaciones, renderers de navegador, servicios de edge, herramientas de compilación y migraciones desde sistemas heredados. Cada sección sobre extensiones sigue la misma estructura del manual: descripción general, instalación, inicio rápido, configuración, API, guía para desarrolladores, uso en producción, seguridad y resolución de problemas.

Integraciones Adaptadores de framework (Laravel, Symfony, CodeIgniter), puentes de renderer (Artisan, Cloudflare, Gotenberg), el shim de compatibilidad con TCPDF y el Backport Builder. Lee primero el mapa de extensiones y la guía de selección.

Migración Mueve una base de código existente a NextPDF. Guías por origen para dompdf y mPDF, además de la única regla que comparten todas las guías: comportamiento compatible, no salida idéntica byte a byte, con diferencias documentadas.

Servidor y SDK

Usa estas guías cuando los clientes que invocan NextPDF son remotos, están escritos en otro lenguaje o son sistemas de inteligencia artificial (IA) que necesitan un endpoint de herramientas en lugar de una biblioteca de PHP.

NextPDF Connect (servidor) El paquete nextpdf/server: un registro determinista de herramientas de PDF servido sobre el Model Context Protocol (MCP), Representational State Transfer (REST) y gRPC, detrás de una compuerta de confirmación con intervención humana. Instala, configura y despliega.

SDK de Python Extracción de PDF lista para citas, destinada a aplicaciones de Python, agentes y la línea de comandos, respaldada por un endpoint de NextPDF Connect. Instálalo con pip install nextpdf y luego apunta un cliente a tu servidor.

Estándares y conformidad

NextPDF Core apunta a la estructura exigida por los estándares. La conformidad en sí la determina un validador, comprobador o autoridad receptora externa. Cada página de conformidad vincula sus afirmaciones con una cláusula y mantiene explícito ese límite.

Conformidad Los perfiles de estándar a los que apunta NextPDF: PDF 2.0 (ISO 32000-2), archivado PDF/A-4 (ISO 19005-4), accesibilidad PDF/UA-2 (ISO 14289-2), producción de impresión PDF/X y facturación electrónica ZUGFeRD / Factur-X.

Asignación de líneas base de PAdES Cómo NextPDF se asigna a los niveles de línea base PAdES de ETSI EN 319 142 B-B, B-T, B-LT y B-LTA, separando la superficie de firma de Core de los niveles Premium y Enterprise.

Operar y extender

Estas guías explican cómo ejecutar NextPDF de forma segura en producción, diagnosticar fallos y construir sobre la superficie pública de extensión.

Confianza y seguridad La postura de ingeniería del motor principal: modelo de amenazas, modelo de seguridad de firma y cifrado, comportamiento en el manejo de datos y la política de divulgación de vulnerabilidades, con el límite de cada uno.

Resolución de problemas Entradas de síntoma a solución para fallos de firma, PDF/A, PDF/UA, fuentes, etiquetado, cifrado y permisos, fundamentadas en la propia taxonomía de excepciones del motor.

Creación de extensiones La Service Provider Interface (SPI) pública: lo que puedes extender, la promesa de estabilidad que la respalda, fuentes personalizadas, motores de maquetación personalizados, disparadores de acciones y el contrato del proveedor de Key Management Service (KMS).

Premium (Pro y Enterprise) Lo que NextPDF Pro y Enterprise añaden sobre el núcleo de código abierto: la matriz de capacidades, la conformidad con los estándares, la validación HSM y FIPS, y las licencias. Adoptar una edición comercial no requiere ningún cambio en el código de la aplicación.

Conceptos

La sección Insider_ explica por qué NextPDF se comporta como lo hace. Ofrece la perspectiva de un ingeniero sénior sobre el diseño, con cada afirmación etiquetada según el tipo de evidencia que la respalda.

Conceptos (Insider_) Filosofía de diseño, el panorama de los estándares, el pipeline HTML, la firma y la validación a largo plazo, las fuentes, la generación de alto volumen y el enfoque de pruebas. Empieza aquí para entender el razonamiento del motor.

Véase también

Cookbook — recipes orientadas a tareas, accionables y copiables para PHP, Connect e integraciones.
Referencia — la superficie de API verificada y la matriz de compatibilidad de CSS.
Glosario — los términos usados en esta documentación, definidos una sola vez.