Guides
En un coup d’œil
Section intitulée « En un coup d’œil »Les guides t’aident à utiliser NextPDF dans l’environnement d’exécution de ton code. Cet onglet commence par la liste de contrôle des opérations de production, puis couvre cinq domaines dans l’ordre d’adoption : les intégrations de frameworks et de renderers, le serveur NextPDF Connect, le SDK Python, la création d’extensions du moteur et le dépannage. Chaque section ci-dessous commence par son point d’entrée, puis répertorie les pages que tu consulteras le plus souvent.
Pour une recette orientée tâche et prête à copier, utilise le Cookbook. Pour la surface d’API vérifiée et les matrices de prise en charge, utilise la Référence.
Intégrations
Section intitulée « Intégrations »Huit packages relient le moteur central aux frameworks, aux renderers de navigateur, aux services edge, aux outils de build et aux parcours de migration hérités. Chaque section consacrée à un package suit la même structure de manuel — présentation, installation, démarrage rapide, configuration, API, guide du développeur, utilisation en production, sécurité et dépannage — si bien qu’une fois que tu en maîtrises une, les autres suivent le même schéma.
| Page | À utiliser pour |
|---|---|
| Intégrations | La vue d’ensemble des extensions et le guide de sélection. À consulter en premier pour choisir un package. |
| Index des API d’intégration | La référence d’API des extensions, qui couvre chaque surface de framework, de renderer, de transport et d’outil de build. |
| NextPDF pour Laravel | L’adaptateur pour le framework Laravel. |
| NextPDF pour Symfony | L’adaptateur pour le framework Symfony. |
| NextPDF pour CodeIgniter | L’adaptateur pour le framework CodeIgniter. |
| NextPDF Artisan | Le pont vers le renderer Chrome pour un rendu HTML de qualité navigateur. |
| NextPDF Cloudflare | Le parcours de déploiement edge sur Cloudflare. |
| NextPDF Gotenberg | Le pont vers le renderer Gotenberg. |
| Compatibilité TCPDF | Le shim de compatibilité pour les bases de code qui migrent depuis TCPDF. |
| NextPDF Backport Builder | L’outil de build qui cible les runtimes PHP plus anciens. |
NextPDF Connect
Section intitulée « NextPDF Connect »Le package nextpdf/server fait tourner le moteur comme un service de longue durée : un registre d’outils déterministe, exposé via le Model Context Protocol (MCP), le Representational State Transfer (REST) et gRPC, avec une confirmation human-in-the-loop pour les outils à haut risque.
| Page | À utiliser pour |
|---|---|
| NextPDF Connect | Le point d’entrée de la section : concepts, configuration et exploitation du serveur. |
| Présentation de Connect | Le périmètre du package et les trois transports. |
| Démarrage rapide de Connect | Un premier handshake MCP exécutable et la requête de rendu REST qui lui correspond. |
| Configuration de Connect | Le fichier YAML MCP et les variables d’environnement NEXTPDF_*. |
| Référence API de Connect | Tous les outils enregistrés, les symboles gRPC, les entrées du modèle d’erreurs et les limites de débit. |
| Déploiement de Connect | Les profils de workers RoadRunner, les profils Docker et les stores adossés à Redis. |
| Sécurité et exploitation de Connect | L’authentification, la sécurité des transports et le modèle de menace. |
Chaque transport a sa propre page de référence.
| Page | À utiliser pour |
|---|---|
| Transport MCP | Le cadrage JSON-RPC 2.0 sur l’entrée et la sortie standard. |
| NextPDF Connect — transport REST | Le contrat OpenAPI 3.1, l’authentification bearer et les routes réservées par palier. |
| NextPDF Connect — transport gRPC | Le service nextpdf.connect.v1, le streaming côté serveur et l’authentification par métadonnées. |
SDK Python
Section intitulée « SDK Python »Le SDK fournit une extraction de PDF prête pour la citation, destinée aux applications Python, aux agents et à la ligne de commande, adossée à un point de terminaison NextPDF Connect.
| Page | À utiliser pour |
|---|---|
| SDK Python | Le point d’entrée de la section pour le package Python nextpdf. |
| Présentation du SDK Python | Le rôle du SDK et la façon dont il s’articule avec Connect. |
| Démarrage rapide du SDK Python | Installe-le avec pip install nextpdf, puis pointe un client vers ton serveur. |
| Référence de l’API du SDK Python | Les classes clientes, les méthodes et les résultats typés. |
| CLI Python | L’interface en ligne de commande pour les workflows d’extraction. |
| Serveur MCP Python | Exposer le SDK aux agents qui parlent MCP. |
Étendre le moteur
Section intitulée « Étendre le moteur »L’interface publique de fournisseur de services (SPI) te permet d’ajouter des capacités sans forker : des contrats pour les polices, les moteurs de mise en page, les écouteurs d’événements et les back ends de signature, chacun assorti d’une promesse de stabilité explicite.
| Page | À utiliser pour |
|---|---|
| Créer une extension | Ce que tu peux étendre et la promesse de stabilité associée. |
| Règles de stabilité de la SPI | Le contrat de rétrocompatibilité sur lequel ton extension peut compter. |
| Polices personnalisées : le contrat FontRegistry | Enregistrer et distribuer tes propres polices. |
| Moteurs de mise en page personnalisés et interception du texte | Remplacer ou intercepter le comportement de mise en page. |
| Déclencheurs d’action et écouteurs d’événements | Observer le cycle de vie du document et y réagir. |
| Contrat de fournisseur KMS | Fournir des clés depuis ton propre service de gestion de clés (KMS). |
Dépannage
Section intitulée « Dépannage »Les entrées sont structurées du symptôme à la résolution et s’appuient sur la taxonomie d’exceptions propre au moteur. Pars de ce que tu observes, pas d’un nom de classe.
| Page | À utiliser pour |
|---|---|
| Dépannage | Le point d’entrée de la base de connaissances : comment les entrées sont structurées et par où commencer. |
| Dépannage : polices et balisage | Les échecs liés à l’intégration de polices et au balisage de structure. |
| Dépannage : chiffrement et permissions | Les échecs de chiffrement, de mot de passe et de permissions. |
| Dépannage : mémoire et performance | Les limites de mémoire et les problèmes de débit. |
| Dépannage : validation PDF/A et PDF/UA | Les échecs de validation d’archivage et d’accessibilité. |
| Dépannage : signatures et horodatages | Les échecs de validation de signature et d’horodatage. |
Voir aussi
Section intitulée « Voir aussi »- Cookbook — des recettes par tâche pour PHP, Connect et les intégrations.
- Référence — la surface d’API vérifiée, les matrices de prise en charge et la référence des erreurs.
- Migrer vers NextPDF — pour quitter une autre bibliothèque PDF, dans l’onglet Prise en main.
- Dans les coulisses de NextPDF — les essais Insider_ qui expliquent le comportement du moteur.