Cookbook

En bref

Le Cookbook est organisé par tâche. Chaque recipe résout un seul problème à partir d’un exemple copiable, adossé au code source. Les recipes se répartissent en trois familles, selon l’endroit où le travail s’exécute. Choisis la famille qui correspond à ta façon d’appeler NextPDF, puis le recipe qui convient dans cette famille.

Quand tu veux comprendre pourquoi le moteur se comporte d’une certaine manière, lis plutôt les Guides. Quand tu veux consulter la surface d’API vérifiée, lis la Reference.

Un seul exemple, un seul runtime

Chaque recipe cible un seul runtime. Les recipes PHP appellent le moteur central dans le même processus. Les recipes Connect appellent des outils via un transport. Les recipes d’intégration câblent NextPDF dans un framework ou un backend de rendu. Lis la page de conventions correspondante avant d’adapter un exemple.

Recipes PHP

Les recipes PHP utilisent directement le moteur central, dans le même processus. Chaque recipe part d’une installation composer require nextpdf/core, puis construit, signe, inspecte ou convertit des documents avec l’API publique, par exemple Document::createStandalone() et writeHtml().

Recipes PHP La carte de tous les recipes en PHP natif : convertir du HTML en PDF, mettre en page des tableaux, intégrer et sous-ensembler des polices, chiffrer en AES-256, signer avec PAdES, émettre du PDF/A-4 et du PDF/UA-2 balisé, extraire du texte et inspecter des fichiers existants.

Recipes Connect

Les recipes Connect appellent NextPDF via le registre d’outils du serveur, au moyen du Model Context Protocol (MCP), de REST (Representational State Transfer) ou de gRPC. Le même appel d’outil fonctionne avec les trois transports, derrière la barrière de confirmation human-in-the-loop.

Recipes Connect Des recipes indépendants du transport pour le serveur NextPDF Connect : hello world, tableaux HTML, intégration d'images, signatures numériques, vérifications d'accessibilité et de conformité, caviardage, analyse forensique et observabilité avec OpenTelemetry.

Recipes d’intégration

Les recipes d’intégration câblent NextPDF à un framework applicatif ou délèguent le rendu à un backend externe. Ils couvrent les adaptateurs de framework et les ponts de rendu, ainsi que le chemin de migration depuis une bibliothèque héritée.

Recipes d'intégration Des recipes pour les packages de l'écosystème : choisir une intégration, renvoyer un PDF depuis un contrôleur de framework, mettre la génération en file d'attente dans une tâche en arrière-plan, rendre du HTML avec Artisan, convertir des fichiers Office avec Gotenberg, faire le rendu en périphérie avec Cloudflare et suivre le chemin de migration TCPDF.

Conventions des recipes

Chaque recipe suit un contrat documenté : des exemples adossés au code source, un front-matter de profil de reproductibilité, une frontière de conformité honnête et le publish gate. Lis la page de conventions de la famille dans laquelle tu travailles avant d’adapter un exemple.

Conventions des recipes d'intégration Le contrat que suit chaque recipe d'intégration exécutable : des exemples adossés au code source, un front-matter de profil de reproductibilité et le publish gate.

Conventions des recipes Connect Le contrat que suit chaque recipe Connect : des appels d'outils indépendants du transport, des outils conditionnés par le niveau, le modèle de risque et la barrière de confirmation, ainsi que la frontière de conformité honnête.

Voir aussi

• Guides — la carte de la documentation conceptuelle et pratique.
• Reference — la surface d’API vérifiée et la matrice de prise en charge CSS.
• Choisir une intégration — une matrice de décision pour associer un cas d’usage à une intégration.