Integraciones

Visión general

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

Mapa de extensiones

Extensión	Paquete	Cuándo usarla	Sección principal
Laravel	nextpdf/laravel	Al crear aplicaciones Laravel que necesitan bindings de contenedor, una facade, respuestas y queue jobs.	Laravel
Symfony	nextpdf/symfony	Al crear aplicaciones Symfony que necesitan un bundle, cableado de DI, jobs de Messenger y respuestas HTTP.	Symfony
CodeIgniter	nextpdf/codeigniter	Al crear aplicaciones CodeIgniter 4 que necesitan servicios, un wrapper de biblioteca, respuestas y queue jobs.	CodeIgniter
Artisan	nextpdf/artisan	Cuando se necesita renderizado de HTML con Chrome CDP, importación de páginas o utilidades de inspección de PDF de bajo nivel.	Artisan
Cloudflare	nextpdf/cloudflare	Al renderizar a través de Cloudflare Browser Rendering, proteger el acceso a la API o archivar PDF en R2.	Cloudflare
Gotenberg	nextpdf/gotenberg	Al convertir documentos de Office o HTML a través de un servicio Gotenberg.	Gotenberg
Compatibilidad con TCPDF	nextpdf/compat-legacy	Al migrar hacia NextPDF código de aplicación con estructura de TCPDF sin una reescritura completa.	Compatibilidad con TCPDF
Backport Builder	nextpdf/backport-builder	Al mantener artefactos de versiones para runtimes de PHP más antiguos.	Backport Builder

Guía de selección

Necesidad	Punto de partida	Nota operativa
Helpers de respuesta del framework	Laravel, Symfony o CodeIgniter	El paquete del framework controla la integración del contenedor y de las respuestas; el núcleo controla la creación de documentos.
Renderizado de HTML orientado a píxeles	Artisan o Cloudflare	Usar Artisan para Chrome CDP local en el host; usar Cloudflare cuando el renderizado corresponda al edge.
Conversión de Office	Gotenberg	Tratar Gotenberg como un límite de servicio externo con controles de tiempo de espera, tamaño y SSRF.
Migración de TCPDF heredado	Compatibilidad con TCPDF	Usar la tabla de cobertura de métodos antes de suponer que una llamada heredada es compatible.
Distribución de PHP más antigua	Backport Builder	Solo herramientas de compilación; no instalarlo como dependencia de runtime de la aplicación.

Forma del manual

Cada sección de una extensión contiene estos tipos de página:

Página	Propósito
overview	Alcance del producto, público objetivo, flujos de trabajo compatibles y limitaciones.
install	Comandos de instalación y dependencias de runtime necesarias.
quickstart	Flujo de trabajo mínimo funcional con un primer resultado que se puede copiar.
configuration	Cada clave de configuración compatible, variable de entorno, valor predeterminado y efecto.
api	Clases públicas, métodos, parámetros, valores predeterminados, valores de retorno y excepciones.
developer-guide	Arquitectura de la extensión, ciclo de vida, puntos de extensión y organización del código.
production-usage	Despliegue, fiabilidad, rendimiento, seguridad de los workers y observabilidad.
security-and-operations	Límites de confianza, valores predeterminados seguros, secretos, acceso a archivos y controles operativos.
troubleshooting	Síntomas, diagnósticos, causas probables y acciones correctivas.

Convención de las tablas de API

Las tablas de API usan las mismas columnas en todo el manual para que los lectores puedan comparar paquetes sin tener que aprender una disposición nueva.

Columna	Significado
Símbolo	Clase, método, endpoint, comando de CLI u objeto de configuración totalmente cualificado.
Parámetros	Nombre, tipo, estado de obligatoriedad, valor predeterminado y valores aceptados.
Comportamiento predeterminado	Qué ocurre cuando se omite una entrada opcional.
Devuelve	Tipo de retorno o artefacto de salida.
Lanza o falla con	Tipo de excepción, estado HTTP, fallo de validación o modo de fallo operativo.
Notas	Detalles de seguridad, seguridad de los workers, compatibilidad o rendimiento.

Preparación para la traducción

El texto fuente en inglés está escrito pensando en una localización posterior: secciones cortas, encabezados estables, sustantivos explícitos, sin modismos y tablas para estructuras repetidas. Las nuevas páginas de API deben mantener los nombres de métodos, las claves de configuración, los flags de CLI y los nombres de excepciones en formato de código para que las herramientas de traducción los preserven.