Choisis ton parcours

En bref

NextPDF propose plusieurs points d’entrée. Le bon choix dépend de l’endroit où ton code s’exécute et du type de sortie dont tu as besoin. Cette page clarifie trois décisions : quelle distribution installer, quel moteur de rendu HTML utiliser, et quand une charge de travail nécessite le niveau Pro ou Enterprise.

Lis la section qui répond à ta question, ou consulte le récapitulatif des décisions à la fin.

Choisir une distribution

Pars de la manière dont ton application appelle le moteur. La première ligne qui correspond à ta situation te donne la réponse.

Ta situation	Installer	Pourquoi
Un projet PHP simple, une bibliothèque ou un outil CLI	NextPDF core (`nextpdf/core`)	Le moteur seul. Il ne présuppose aucun framework et n’exécute aucun service.
Une application Laravel, Symfony ou CodeIgniter	L’intégration de framework correspondante	Tu obtiens des liaisons de conteneur, des assistants de réponse et des tâches de file d’attente au-dessus du core.
Un service non-PHP, un agent ou un autre runtime qui doit appeler le moteur via le réseau	NextPDF Server (`nextpdf/server`)	Un seul service expose le moteur via MCP, REST et gRPC.
Du code Python qui a besoin de PDF générés par un NextPDF Server	Le SDK Python (`pip install nextpdf`)	Un client typé pour un serveur en cours d’exécution. Il n’embarque pas le moteur.

Deux points prêtent souvent à confusion :

Une intégration de framework inclut le core. Tu n’installes pas les deux séparément. L’adaptateur déclare et résout nextpdf/core pour toi.
Le SDK Python est un client, pas un moteur. Il a besoin d’un point de terminaison NextPDF Server avec lequel dialoguer. La génération du PDF se fait en PHP, côté serveur.

Choisir un moteur de rendu HTML

NextPDF rend le HTML en PDF de quatre façons. Le pipeline intégré couvre la plupart des documents sans configuration supplémentaire. Les trois packages de moteur de rendu servent aux cas où tu as besoin d’une mise en page de qualité navigateur ou veux utiliser un service existant.

Moteur de rendu	Package	Où il s’exécute	Choisis-le quand
Intégré `writeHtml()`	`nextpdf/core`	En cours de processus, PHP pur	Tu veux un sous-ensemble HTML et CSS pris en charge, sans navigateur et sans appel réseau.
Artisan	`nextpdf/artisan`	headless Chrome sur l’hôte	Tu as besoin d’une mise en page Chrome complète — flexbox, grid, sélecteurs complexes, polices web — avec du texte sélectionnable.
Cloudflare	`nextpdf/cloudflare`	Cloudflare Browser Rendering en périphérie	Le rendu doit se faire en périphérie, ou tu veux garder les processus de navigateur hors de tes propres hôtes.
Gotenberg	`nextpdf/gotenberg`	Un service Gotenberg que tu exploites	Tu convertis des documents bureautiques (DOCX, XLSX) ou du HTML via un déploiement Gotenberg existant.

Comment lire le tableau :

Tourne-toi d’abord vers le pipeline intégré. C’est l’option la plus rapide et elle n’a aucune dépendance externe. Avant de t’appuyer sur une propriété, vérifie sa prise en charge dans la matrice de prise en charge CSS.
Passe à Artisan quand une mise en page dépasse le sous-ensemble pris en charge et que le rendu doit rester sur ta propre infrastructure. Il lance un processus Chrome, alors prévois son cycle de vie.
Passe à Cloudflare quand tu veux la même fidélité qu’un navigateur mais que tu préfères faire le rendu en périphérie plutôt que d’exécuter des navigateurs en local.
Passe à Gotenberg pour la conversion de documents bureautiques, ou quand tu exécutes déjà Gotenberg et que tu veux que NextPDF le pilote.

Quand tu as besoin de Pro ou Enterprise

Le moteur core génère, rend et inspecte les PDF gratuitement et sans licence. NextPDF Pro et NextPDF Enterprise sont les deux niveaux sous licence du package nextpdf/premium. L’installer ajoute des capacités sans modifier aucune API du core.

Tu as besoin de	Niveau	Capacité
Signer numériquement un PDF (référentiel PAdES)	Pro	Implémentations concrètes de signature par clé logicielle.
Produire une sortie PDF/A d’archivage	Pro	Conformité PDF/A et profils d’archivage.
Intégrer une facture électronique (Factur-X / ZUGFeRD)	Pro	Implémentations concrètes du contrat de facture électronique.
Signer avec un module de sécurité matériel (HSM)	Enterprise	Opérations de clé adossées au matériel.
Émettre des signatures électroniques qualifiées	Enterprise	Flux de signature qualifiée et toute la surface de conformité.

Deux règles permettent de garder une décision nette :

Si tu produis des PDF non signés et non archivistiques, le core est complet. Tu n’as pas besoin de licence.
Quand tu installes nextpdf/premium, les intégrations de framework et le serveur le détectent automatiquement. Ils exposent la capacité supplémentaire via les mêmes clés de conteneur et le même catalogue d’outils. Ton application n’a besoin d’aucune modification de code pour en bénéficier.

Récapitulatif des décisions

Distribution

PHP simple &rarr ; core. Une application de framework &rarr ; l’intégration correspondante. Une frontière réseau &rarr ; le serveur. Client Python &rarr ; le SDK Python.

Moteur de rendu HTML

Sous-ensemble pris en charge, aucune dépendance &rarr ; writeHtml(). Fidélité navigateur sur tes hôtes &rarr ; Artisan. En périphérie &rarr ; Cloudflare. Conversion bureautique &rarr ; Gotenberg.

Niveau sous licence

PDF non signés &rarr ; core. Signature, PDF/A, facture électronique &rarr ; Pro. HSM ou signatures qualifiées &rarr ; Enterprise.

Encore un doute ?

Installe le core, suis Ton premier PDF, et ajoute un package seulement quand un besoin concret apparaît. Tu peux changer tout ça plus tard.

Voir aussi

Installer NextPDF La commande exacte pour chaque distribution et chaque moteur de rendu.

Ton premier PDF Génère un PDF depuis PHP et restitue du HTML en PDF.

Intégrations La carte complète des extensions, le guide de sélection et les manuels par package.

Se connecter (serveur) Exécute le moteur comme un service réseau via MCP, REST et gRPC.