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 avec 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	Contrainte	Notes
PHP	>=8.4 <9.0	Composer refuse l’installation sur PHP 8.3 ou une version antérieure, ainsi que sur PHP 9.
Composer	2.7 ou plus récent	Utilisé par le résolveur de dépendances et le générateur d’autoloader.
ext-mbstring	Requis	Gestion des chaînes multi-octets pour la mise en page du texte.
ext-zlib	Requis	Compression de flux pour les objets PDF.
Chrome ou Chromium	Optionnel	Uniquement pour le renderer Artisan (writeHtmlChrome()).
Service Gotenberg	Optionnel	Uniquement pour la conversion de documents bureautiques et HTML via Gotenberg.
Python	3.10 ou plus récent	Uniquement pour le SDK Python.

ext-mbstring et ext-zlib sont activées dans toutes les builds PHP prises en charge. Les intégrations vérifient leur présence au démarrage 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 NextPDF\Symfony\NextPdfBundle à config/bundles.php toi-même. 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 PDF Génère un PDF depuis PHP et convertis du HTML en PDF.

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

Intégrations La 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.