Installer NextPDF

En bref

Chaque distribution NextPDF s’installe avec une seule commande du gestionnaire de paquets. Les distributions PHP utilisent Composer ; le SDK Python utilise pip. Choisis l’onglet qui correspond à ce que tu construis, exécute la commande, puis confirme le résultat grâce à l’étape de vérification en bas de cette page.

Un seul moteur, plusieurs portes d'entrée

Le moteur principal est nextpdf/core. Les intégrations de framework, les renderers HTML, le serveur et le client Python s’appuient chacun sur lui avec un paquet dédié. Aucun d’eux ne remplace le moteur principal, et tous l’installent comme dépendance pour toi.

Prérequis

NextPDF cible un seul environnement d’exécution moderne. Les contraintes ci-dessous viennent directement des fichiers composer.json des paquets eux-mêmes.

Prérequis d'exécution de NextPDF, lus depuis les fichiers composer.json des paquets eux-mêmes

Prérequis	Contrainte	Statut	Notes
PHP	>=8.4 <9.0	Obligatoire	Composer refuse l'installation sur PHP 8.3 ou une version antérieure, ou sur PHP 9.
Composer	2.x	Obligatoire	Nécessaire pour la résolution des dépendances et la génération du chargeur automatique.
ext-mbstring	—	Obligatoire	Gestion des chaînes multi-octets pour la mise en page du texte.
ext-zlib	—	Obligatoire	Compression des flux pour les objets Portable Document Format (PDF).
ext-intl	—	Obligatoire	Services International Components for Unicode (ICU) : texte bidirectionnel, retour à la ligne et formatage selon les paramètres régionaux.
ext-gd	—	Obligatoire	Décodage et traitement des images matricielles pour les images incorporées.
ext-curl	—	Obligatoire	Allers-retours réseau : horodatage RFC 3161 et récupération de ressources distantes. La génération hors ligne ne l'utilise pas, mais Composer l'exige tout de même.
ext-openssl	—	Obligatoire	Cryptographie pour les signatures numériques, les structures CMS et le chiffrement.
Chrome or Chromium	—	Facultatif	Uniquement pour le moteur de rendu Artisan (writeHtmlChrome()).
Gotenberg service	—	Facultatif	Uniquement pour la conversion de documents bureautiques et HTML via Gotenberg.
Python	3.10+	Facultatif	Uniquement pour le software development kit (SDK) de Python.

ext-mbstring et ext-zlib sont activées dans la plupart des builds PHP ; ext-intl, ext-gd, ext-curl et ext-openssl varient selon la distribution, alors vérifie les six avec php -m avant de lancer l’installation. Les intégrations vérifient au démarrage les extensions dont elles ont besoin et échouent avec un message clair si l’une d’elles manque.

Installer le moteur principal

Pour générer et inspecter des PDF depuis PHP, le moteur principal est le seul paquet nécessaire.

composer require nextpdf/core

Versionne composer.lock pour que chaque worker déployé résolve exactement la même version du moteur. Une fois l’installation terminée, continue vers Ton premier PDF.

Installer une intégration de framework

Installe un seul adaptateur de framework pour obtenir les liaisons de conteneur, les helpers de réponse et les jobs de file d’attente. Chaque adaptateur déclare nextpdf/core comme dépendance et le résout pour toi.

Laravel

composer require nextpdf/laravel

L’auto-découverte enregistre le service provider et la facade Pdf. Publie ensuite le fichier de configuration :

php artisan vendor:publish --tag=nextpdf-config

Consulte le guide d’installation Laravel et le guide de démarrage rapide Laravel.

Symfony

composer require nextpdf/symfony

Dans une application Symfony Flex, le bundle s’enregistre lui-même. Dans une application sans Flex, ajoute toi-même NextPDF\Symfony\NextPdfBundle à config/bundles.php. Consulte le guide d’installation Symfony.

CodeIgniter

composer require nextpdf/codeigniter

CodeIgniter 4 découvre automatiquement la classe Services et le helper pdf(), donc aucun enregistrement manuel n’est requis. Consulte le guide d’installation CodeIgniter.

Installer un renderer ou un service

NextPDF convertit le HTML en PDF de trois façons. Installe le renderer ou le service qui correspond à l’endroit où tu veux exécuter le rendu. Aucun de ces paquets ne remplace writeHtml(), le pipeline HTML en PHP pur intégré au moteur principal.

Artisan (Chrome)

composer require nextpdf/artisan

Ajoute le rendu via Chrome headless avec le Chrome DevTools Protocol (CDP). Il te faut aussi un binaire Chrome ou Chromium accessible sur l’hôte. Une fois l’installation terminée, appelle writeHtmlChrome() sur un document. Consulte le guide de démarrage rapide Artisan.

Cloudflare

composer require nextpdf/cloudflare guzzlehttp/guzzle

Effectue le rendu via Cloudflare Browser Rendering en périphérie. L’adaptateur dépend uniquement des contrats PSR-18 et PSR-17 ; tu fournis donc ton propre client HTTP (Guzzle montré ici). Consulte le guide d’installation Cloudflare.

Gotenberg

composer require nextpdf/gotenberg guzzlehttp/guzzle

Convertit des documents bureautiques et du HTML via un service Gotenberg. Tu fournis un client PSR-18 et une instance Gotenberg accessible. Consulte le guide d’installation Gotenberg.

Les renderers sortent de PHP

Artisan lance un processus de navigateur ; Cloudflare et Gotenberg appellent un service réseau. Traite le HTML comme non fiable et lis la page de sécurité et d’exploitation de chaque paquet avant de faire le rendu d’une entrée influencée par l’utilisateur.

Installer le serveur

NextPDF Server (aussi appelé Connect) est un service autonome. Il expose le moteur via MCP, REST et gRPC.

composer require nextpdf/server

Le paquet ajoute des points d’entrée console à vendor/bin/, dont vendor/bin/nextpdf-mcp (le serveur MCP stdio) et vendor/bin/nextpdf-server (le serveur REST). Les transports REST et gRPC ont aussi besoin du binaire RoadRunner :

./vendor/bin/rr get-binary

Consulte le guide d’installation Connect et le guide de démarrage rapide Connect.

Installer le SDK Python

Le SDK Python est le client typé pour un NextPDF Server en cours d’exécution. Installe-le depuis PyPI :

pip install nextpdf

Le SDK a besoin de Python 3.10 ou plus récent et d’un endpoint NextPDF Server accessible. Consulte le guide de démarrage rapide du SDK Python.

Vérifier l’installation

Confirme que chaque distribution a bien été résolue avant de commencer à écrire du code.

Core / PHP

composer show nextpdf/core

Une ligne de version confirme que le moteur est installé et disponible dans l’autoloader.

Laravel

php artisan package:discover --ansi

La sortie liste nextpdf/laravel parmi les paquets découverts.

Symfony

php bin/console debug:container nextpdf

Le conteneur signale l’alias nextpdf.document et le service PdfFactory.

Server

./vendor/bin/generate-skills --dry-run --list-tools

Cela démarre le registre et affiche les outils exposés par cette installation, sans réellement lancer de serveur.

Python

nextpdf version

Une chaîne de version confirme que le SDK peut être importé correctement.

Voir aussi

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

Choisis ton parcoursDécide quelle distribution et quel renderer HTML conviennent à ton application.

Achat et licenceAchète une licence Pro ou Enterprise par l'intermédiaire de notre Merchant of Record, puis installe et active.

IntégrationsLa carte complète des extensions et le guide de sélection.

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