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.

Bibliothèque ou service ?

Si ton application PHP peut intégrer la bibliothèque, préfère le core ou une intégration de framework. Cela fait un processus de moins à faire tourner et donne la latence la plus faible. Tourne-toi vers le serveur quand un composant non PHP a besoin du moteur, ou quand tu veux un service de rendu unique partagé entre de nombreux appelants.

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.

Les moteurs de rendu élargissent la surface de menace

Par défaut, le pipeline intégré n’exécute aucun script et ne récupère aucune ressource distante. Artisan, Cloudflare et Gotenberg s’appuient chacun sur un navigateur ou un service réseau pour le rendu. Considère le HTML comme non fiable, et lis la page de sécurité et d’exploitation de chaque package avant de transmettre une entrée influencée par l’utilisateur.

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 éditions sous licence de NextPDF Premium, la ligne payante. L’installer ajoute des capacités sans modifier aucune API du core.

Le core signe déjà avec des clés logicielles aux niveaux de référence B-B et B-T des signatures électroniques avancées PDF (PAdES). Les niveaux sous licence commencent là où ces niveaux de référence s’arrêtent.

Tu as besoin de	Niveau	Capacité
Exécuter des flux de signature avancés : signature distante, par cloud-KMS ou séquentielle	Pro	Implémentations concrètes de flux de signature au-dessus des niveaux de référence B-B / B-T du core.
Produire une sortie PDF/A d’archivage	Enterprise	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.
Conserver des signatures valides à long terme avec PAdES B-LT / B-LTA	Enterprise	Document Security Store et horodatages de document pour la validité d’archivage.
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.

Acheter Pro ou Enterprise

Lorsque tu as effectivement besoin d’un niveau sous licence, les licences commerciales sont vendues par l’intermédiaire de notre Merchant of Record — un revendeur agréé qui est le vendeur officiel de ta commande — et ta licence est accordée par PATEON au titre de l’End-User License Agreement (EULA). Tu commences au portail de licences et nous t’installons via le paiement de notre Merchant of Record, où le prix, toute taxe, et ta facture sont gérés.

Consulte Achat et licence pour la voie complète, le modèle à deux contrats (achat par rapport à licence), et qui contacter pour la facturation par rapport à l’aide produit.

Récapitulatif des décisions

Distribution

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

Moteur de rendu HTML

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

Niveau sous licence

PDF non signés → core. Signature, facture électronique → Pro. PDF/A, HSM ou signatures qualifiées → 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 NextPDFLa commande exacte pour chaque distribution et chaque moteur de rendu.

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

IntégrationsLa 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.