Intégrations
Les extensions NextPDF font le lien entre le moteur PDF central et les frameworks applicatifs, les renderers de navigateur, les services edge, les outils de build et les migrations d’applications legacy. Chaque section consacrée à une extension suit la même structure de manuel : présentation, installation, démarrage rapide, configuration, API, guide du développeur, usage en production, sécurité et dépannage.
Carte des extensions
Section intitulée « Carte des extensions »| Extension | Package | À utiliser quand | Section principale |
|---|---|---|---|
| Laravel | nextpdf/laravel | Tu développes des applications Laravel et tu veux des liaisons de conteneur, une facade, des réponses et des jobs de queue. | Laravel |
| Symfony | nextpdf/symfony | Tu développes des applications Symfony et tu veux un bundle, du câblage DI, des jobs Messenger et des réponses HTTP. | Symfony |
| CodeIgniter | nextpdf/codeigniter | Tu développes des applications CodeIgniter 4 et tu veux des services, un wrapper de bibliothèque, des réponses et des jobs de queue. | CodeIgniter |
| Artisan | nextpdf/artisan | Tu as besoin du rendu HTML via Chrome CDP, de l’import de pages ou d’utilitaires d’inspection PDF de bas niveau. | Artisan |
| Cloudflare | nextpdf/cloudflare | Tu effectues le rendu via Cloudflare Browser Rendering, tu protèges l’accès à l’API ou tu archives des PDF sur R2. | Cloudflare |
| Gotenberg | nextpdf/gotenberg | Tu convertis des documents bureautiques ou du HTML via un service Gotenberg. | Gotenberg |
| Compatibilité TCPDF | nextpdf/compat-legacy | Tu migres du code applicatif de style TCPDF vers NextPDF sans réécriture complète. | Compatibilité TCPDF |
| Backport Builder | nextpdf/backport-builder | Tu maintiens des artefacts de release pour des runtimes PHP plus anciens. | Backport Builder |
Guide de sélection
Section intitulée « Guide de sélection »| Besoin | Commence ici | Note opérationnelle |
|---|---|---|
| Helpers de réponse de framework | Laravel, Symfony ou CodeIgniter | Le package de framework gère l’intégration du conteneur et des réponses ; le cœur gère la création du document. |
| Rendu HTML au pixel près | Artisan ou Cloudflare | Choisis Artisan pour un Chrome CDP local sur l’hôte ; choisis Cloudflare quand le rendu doit se faire à l’edge. |
| Conversion bureautique | Gotenberg | Traite Gotenberg comme une frontière de service externe avec des contrôles de timeout, de taille et de SSRF. |
| Migration TCPDF legacy | Compatibilité TCPDF | Consulte le tableau de couverture des méthodes avant de supposer qu’un appel legacy est pris en charge. |
| Distribution PHP plus ancienne | Backport Builder | Outil de build uniquement ; ne l’installe pas comme dépendance de runtime applicatif. |
Structure du manuel
Section intitulée « Structure du manuel »Chaque section consacrée à une extension contient ces types de pages :
| Page | Objet |
|---|---|
overview | Périmètre du produit, public cible, workflows pris en charge et limitations. |
install | Commandes d’installation et dépendances de runtime requises. |
quickstart | Flux de travail minimal fonctionnel, avec un premier résultat que tu peux copier. |
configuration | Chaque clé de configuration prise en charge, variable d’environnement, valeur par défaut et effet. |
api | Classes publiques, méthodes, paramètres, valeurs par défaut, valeurs de retour et exceptions. |
developer-guide | Architecture de l’extension, cycle de vie, points d’extension et organisation du code. |
production-usage | Déploiement, fiabilité, performances, sûreté des workers et observabilité. |
security-and-operations | Frontières de confiance, valeurs par défaut sûres, secrets, accès aux fichiers et contrôles opérationnels. |
troubleshooting | Symptômes, diagnostics, causes probables et actions correctives. |
Convention des tableaux d’API
Section intitulée « Convention des tableaux d’API »Les tableaux d’API utilisent les mêmes colonnes dans tout le manuel afin que les lecteurs puissent comparer les packages sans apprendre une nouvelle disposition.
| Colonne | Signification |
|---|---|
| Symbole | Classe, méthode, endpoint, commande CLI ou objet de configuration pleinement qualifié. |
| Paramètres | Nom, type, statut requis, valeur par défaut et valeurs acceptées. |
| Comportement par défaut | Ce qui se passe quand l’appelant omet une entrée optionnelle. |
| Retourne | Type de retour ou artefact de sortie. |
| Lève ou échoue avec | Type d’exception, statut HTTP, échec de validation ou mode de défaillance opérationnel. |
| Notes | Détail de sécurité, de sûreté des workers, de compatibilité ou de performance. |
Préparation à la traduction
Section intitulée « Préparation à la traduction »La source anglaise est rédigée en prévision d’une localisation ultérieure : sections courtes, titres stables, noms explicites, aucun idiome et tableaux pour les structures répétées. Les nouvelles pages d’API doivent conserver les noms de méthodes, les clés de configuration, les drapeaux de CLI et les noms d’exceptions au format code afin que les outils de traduction les préservent.