Cookbook

De un vistazo

El cookbook está organizado por tareas. Cada recipe resuelve un problema concreto con un ejemplo copiable y respaldado por el código fuente. Las recipes se dividen en tres familias, agrupadas según dónde se ejecuta el trabajo. Para empezar, conviene elegir la familia que coincida con la forma de invocar NextPDF y, después, escoger una recipe dentro de ella.

Para entender por qué el motor se comporta de cierta manera, consultar en su lugar las Guides. Para revisar la superficie de la API verificada, consultar la Reference.

Un ejemplo, un runtime

Cada recipe apunta a un único runtime. Las recipes de PHP invocan el motor central en el mismo proceso. Las recipes de Connect invocan herramientas a través de un transporte. Las recipes de integración conectan NextPDF con un framework o un backend de renderizado. Antes de adaptar un ejemplo, leer la página de convenciones correspondiente.

Recipes de PHP

Las recipes de PHP usan directamente el motor central, en el mismo proceso. Cada una parte de una instalación con composer require nextpdf/core y, a continuación, construye, firma, inspecciona o convierte documentos mediante la API pública, por ejemplo Document::createStandalone() y writeHtml().

Recipes de PHP El mapa de cada recipe nativa de PHP: renderizar HTML a PDF, maquetar tablas, incrustar y subdividir fuentes, cifrar con AES-256, firmar con PAdES, emitir PDF/A-4 y PDF/UA-2 etiquetado, extraer texto e inspeccionar archivos existentes.

Recipes de Connect

Las recipes de Connect invocan NextPDF a través del registro de herramientas del servidor mediante el Model Context Protocol (MCP), Representational State Transfer (REST) o gRPC. La misma llamada de herramienta funciona en los tres transportes, tras la compuerta de confirmación con intervención humana.

Recipes de Connect Recipes independientes del transporte para el servidor NextPDF Connect: hello world, tablas HTML, incrustación de imágenes, firmas digitales, comprobaciones de accesibilidad y cumplimiento, redacción, análisis forense y observabilidad con OpenTelemetry.

Recipes de integración

Las recipes de integración conectan NextPDF con un framework de aplicación o delegan el renderizado en un backend externo. Cubren los adaptadores de frameworks y los puentes de renderers, además de la ruta de migración desde una biblioteca heredada.

Recipes de integración Recipes para los paquetes del ecosistema: elegir una integración, devolver un PDF desde un controlador de framework, encolar la generación en un trabajo en segundo plano, renderizar HTML con Artisan, convertir archivos de Office con Gotenberg, renderizar en el edge con Cloudflare y seguir la ruta de migración de TCPDF.

Convenciones de recipes

Cada recipe sigue un contrato documentado: ejemplos respaldados por el código fuente, front-matter de perfil de reproducibilidad, un límite de conformidad honesto y el publish gate. Antes de adaptar un ejemplo, leer la página de convenciones de la familia correspondiente.

Convenciones de las recipes de integración El contrato que sigue cada recipe de integración ejecutable: ejemplos respaldados por el código fuente, front-matter de perfil de reproducibilidad y el publish gate.

Convenciones de las recipes de Connect El contrato que sigue cada recipe de Connect: llamadas de herramientas independientes del transporte, herramientas condicionales al nivel, el modelo de riesgo y la compuerta de confirmación, y el límite de conformidad honesto.

Consulta también

• Guides: el mapa de la documentación conceptual y procedimental.
• Reference: la superficie de la API verificada y la matriz de compatibilidad de CSS.
• Elegir una integración: una matriz de decisión que relaciona cada caso de uso con una integración.