Guías
De un vistazo
Sección titulada «De un vistazo»Estas guías conectan NextPDF con el entorno en el que se ejecuta el código. La sección empieza por la lista de verificación de operaciones en producción y a continuación abarca cinco áreas, en el orden habitual de adopción: integraciones con frameworks y renderers, el servidor NextPDF Connect, el SDK de Python, la creación de extensiones del motor y la resolución de problemas. Cada sección empieza por su hub y enumera las páginas que se usan con más frecuencia.
Para recetas orientadas a tareas y fáciles de copiar, consultar el Cookbook. Para revisar la superficie de API verificada y las matrices de compatibilidad, consultar la Referencia.
Integraciones
Sección titulada «Integraciones»Ocho paquetes conectan el motor principal con frameworks, renderers de navegador, servicios edge, herramientas de compilación y rutas de migración desde sistemas heredados. Cada sección de paquete 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. Una vez conocida una, la estructura de las demás resulta familiar.
| Página | Usar para |
|---|---|
| Integraciones | Mapa de extensiones y guía de selección. Leer primero para elegir un paquete. |
| Índice de API de integraciones | Identificar qué página de la API de extensión cubre cada superficie de framework, renderer, transporte y herramienta de compilación. |
| NextPDF para Laravel | Adaptador para el framework Laravel. |
| NextPDF para Symfony | Adaptador para el framework Symfony. |
| NextPDF para CodeIgniter | Adaptador para el framework CodeIgniter. |
| NextPDF Artisan | Puente con el renderer de Chrome para renderizar HTML con calidad de navegador. |
| NextPDF Cloudflare | Ruta de despliegue edge en Cloudflare. |
| NextPDF Gotenberg | Puente con el renderer Gotenberg. |
| Compatibilidad con TCPDF | Shim de compatibilidad para bases de código que migran desde TCPDF. |
| NextPDF Backport Builder | Herramienta de compilación orientada a runtimes de PHP más antiguos. |
NextPDF Connect
Sección titulada «NextPDF Connect»El paquete nextpdf/server ejecuta el motor como un servicio de larga duración: un registro determinista de herramientas servido mediante el Model Context Protocol (MCP), Representational State Transfer (REST) y gRPC, protegido por una barrera de confirmación con intervención humana para herramientas de alto riesgo.
| Página | Usar para |
|---|---|
| NextPDF Connect | Hub de la sección: conceptos, configuración y operaciones del servidor. |
| Descripción general de Connect | Alcance del paquete y sus tres transportes. |
| Inicio rápido con Connect | Primer handshake de MCP ejecutable y la solicitud de renderizado REST equivalente. |
| Configuración de Connect | Archivo YAML de MCP y variables de entorno NEXTPDF_*. |
| Referencia de la API de Connect | Consultar cada herramienta registrada, cada símbolo de gRPC, las entradas del modelo de errores y el límite de tasa. |
| Despliegue de Connect | Perfiles de workers de RoadRunner, Docker y almacenes respaldados por Redis. |
| Seguridad y operaciones en Connect | Autenticación, seguridad del transporte y modelo de amenazas. |
Cada transporte tiene su propia página de referencia.
| Página | Usar para |
|---|---|
| Transporte MCP | Delimitación de mensajes JSON-RPC 2.0 en la entrada y la salida estándar. |
| Transporte REST | Contrato de OpenAPI 3.1, autenticación con bearer y rutas restringidas por nivel. |
| Transporte gRPC | Servicio nextpdf.connect.v1, server streaming y autenticación por metadatos. |
SDK de Python
Sección titulada «SDK de Python»Extracción de PDF preparada para citas, pensada para aplicaciones de Python, agentes y la línea de comandos, respaldada por un endpoint de NextPDF Connect.
| Página | Usar para |
|---|---|
| SDK de Python | Hub de la sección para el paquete de Python nextpdf. |
| Descripción general del SDK de Python | Qué hace el SDK y cómo se relaciona con Connect. |
| Inicio rápido del SDK de Python | Instalar el paquete con pip install nextpdf y apuntar un cliente a un servidor propio. |
| Referencia de la API del SDK de Python | Clases de cliente, métodos y resultados tipados. |
| CLI de Python | Interfaz de línea de comandos para los flujos de extracción. |
| Servidor MCP de Python | Cómo exponer el SDK a agentes que se comunican mediante MCP. |
Extender el motor
Sección titulada «Extender el motor»La Service Provider Interface (SPI) pública permite añadir capacidades sin crear un fork: contratos para fuentes, motores de maquetación, escuchas de eventos y backends de firma, cada uno respaldado por una promesa de estabilidad explícita.
| Página | Usar para |
|---|---|
| Creación de extensiones | Qué se puede extender y la promesa de estabilidad que lo respalda. |
| Reglas de estabilidad de la SPI | Contrato de compatibilidad con versiones anteriores en el que una extensión puede apoyarse. |
| Fuentes personalizadas: el contrato FontRegistry | Registrar y distribuir fuentes propias. |
| Motores de layout personalizados e interceptación de texto | Reemplazar o interceptar el comportamiento de maquetación. |
| Disparadores de acciones y escuchas de eventos | Observar y reaccionar ante el ciclo de vida del documento. |
| Contrato del proveedor de KMS | Suministrar claves desde un Key Management Service (KMS) propio. |
Resolución de problemas
Sección titulada «Resolución de problemas»Entradas que llevan del síntoma a la solución, fundamentadas en la taxonomía de excepciones del propio motor. Empezar por lo que se observa, no por el nombre de una clase.
| Página | Usar para |
|---|---|
| Solución de problemas | Hub de la base de conocimiento: cómo se estructuran las entradas y dónde empezar. |
| Solución de problemas: fuentes y etiquetado | Fallos de incrustación de fuentes y de etiquetado de estructura. |
| Solución de problemas: cifrado y permisos | Fallos de cifrado, de contraseña y de permisos. |
| Resolución de problemas: memoria y rendimiento | Agotamiento de memoria y problemas de rendimiento. |
| Solución de problemas: validación de PDF/A y PDF/UA | Fallos de validación de archivado y de accesibilidad. |
| Resolución de problemas: firmas y marcas de tiempo | Fallos de validación de firma y de marca de tiempo. |
Véase también
Sección titulada «Véase también»- Cookbook — recetas orientadas a tareas para PHP, Connect e integraciones.
- Referencia — la superficie de API verificada, las matrices de compatibilidad y la referencia de errores.
- Migrar a NextPDF — cómo migrar desde otra biblioteca de PDF, en la sección Primeros pasos.
- NextPDF por dentro — los ensayos Insider_ sobre por qué el motor se comporta como lo hace.