NextPDF installeren

In één oogopslag

Je installeert elke NextPDF-distributie met één pakketbeheerderopdracht. PHP-distributies gebruiken Composer; de Python software development kit (SDK) gebruikt pip. Kies het tabblad dat past bij wat je bouwt, voer de opdracht uit en controleer daarna onderaan deze pagina het resultaat.

Eén engine, meerdere voordeuren

De core-engine is nextpdf/core. Framework-integraties, Hypertext Markup Language (HTML)-renderers, de server en de Python-client voegen daar elk één pakket bovenop toe. Ze vervangen de core-engine niet; ze installeren die voor je.

Vereisten

NextPDF richt zich op één moderne runtime. Deze beperkingen komen rechtstreeks uit de composer.json-bestanden van de pakketten zelf.

Vereiste	Beperking	Opmerkingen
PHP	>=8.4 <9.0	Composer weigert installatie op PHP 8.3 of lager, of op PHP 9.
Composer	2.7 of nieuwer	Nodig om afhankelijkheden op te lossen en de autoloader te genereren.
ext-mbstring	Vereist	Multibyte-tekenreeksverwerking voor tekstlay-out.
ext-zlib	Vereist	Streamcompressie voor Portable Document Format (PDF)-objecten.
Chrome of Chromium	Optioneel	Alleen voor de Artisan-renderer (writeHtmlChrome()).
Gotenberg-service	Optioneel	Alleen voor office- en HTML-conversie via Gotenberg.
Python	3.10 of nieuwer	Alleen voor de Python SDK.

ext-mbstring en ext-zlib zijn ingeschakeld in elke ondersteunde PHP-build. Integraties controleren dit tijdens het opstarten en stoppen met een duidelijke melding als er een ontbreekt.

Core installeren

Om PDF-bestanden vanuit PHP te genereren en te inspecteren, heb je alleen de core-engine nodig.

composer require nextpdf/core

Commit composer.lock, zodat elke gedeployde worker dezelfde engine-versie oplost. Ga na de installatie verder naar Je eerste PDF.

Een framework-integratie installeren

Installeer één framework-adapter voor container-bindings, response-helpers en wachtrijtaken. Elke adapter declareert nextpdf/core en lost die voor je op.

Laravel

composer require nextpdf/laravel

Auto-discovery registreert de service provider en de Pdf-facade. Publiceer vervolgens het configuratiebestand:

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

Zie de Laravel-installatiegids en de Laravel-snelstart.

Symfony

composer require nextpdf/symfony

In een Symfony Flex-applicatie registreert de bundle zichzelf. In een applicatie zonder Flex voeg je NextPDF\Symfony\NextPdfBundle zelf toe aan config/bundles.php. Zie de Symfony-installatiegids.

CodeIgniter

composer require nextpdf/codeigniter

CodeIgniter 4 detecteert de Services-klasse en de pdf()-helper automatisch, zodat je geen handmatige registratie nodig hebt. Zie de CodeIgniter-installatiegids.

Een renderer of service installeren

NextPDF rendert HTML naar PDF op drie manieren. Installeer de optie die past bij waar je de rendering wilt laten plaatsvinden. Geen van deze opties vervangt writeHtml(), de ingebouwde pure-PHP HTML-pijplijn van de core-engine.

Artisan (Chrome)

composer require nextpdf/artisan

Dit pakket voegt rendering met headless Chrome toe via het Chrome DevTools Protocol (CDP). Je hebt ook een Chrome- of Chromium-binary nodig die vanaf de host bereikbaar is. Roep na installatie writeHtmlChrome() aan op een document. Zie de Artisan-snelstart.

Cloudflare

composer require nextpdf/cloudflare guzzlehttp/guzzle

Rendering verloopt via Cloudflare Browser Rendering aan de edge. De bridge is alleen afhankelijk van de PHP Standards Recommendation (PSR)-contracten PSR-18 en PSR-17, dus je levert je eigen Hypertext Transfer Protocol (HTTP)-client aan (hier wordt Guzzle getoond). Zie de Cloudflare-installatiegids.

Gotenberg

composer require nextpdf/gotenberg guzzlehttp/guzzle

Dit pakket converteert office-documenten en HTML via een Gotenberg-service. Je levert een PSR-18-client en een bereikbare Gotenberg-instantie aan. Zie de Gotenberg-installatiegids.

Renderers reiken buiten PHP

Artisan start een browserproces; Cloudflare en Gotenberg roepen een netwerkservice aan. Behandel HTML als niet-vertrouwd. Lees de security-and-operations-pagina van elk pakket voordat je invoer rendert die door gebruikers kan worden beïnvloed.

De server installeren

NextPDF Server (ook Connect genoemd) is een standalone service. De service maakt de engine beschikbaar via Model Context Protocol (MCP), Representational State Transfer (REST) en gRPC.

composer require nextpdf/server

Het pakket voegt console-entrypoints toe aan vendor/bin/, waaronder vendor/bin/nextpdf-mcp (de MCP-stdio-server) en vendor/bin/nextpdf-server (de REST-server). Voor de REST- en gRPC-transports heb je ook de RoadRunner-binary nodig:

./vendor/bin/rr get-binary

Zie de Connect-installatiegids en de Connect-snelstart.

De Python SDK installeren

De Python SDK is de getypeerde client voor een actieve NextPDF Server. Installeer deze vanuit de Python Package Index (PyPI):

pip install nextpdf

De SDK heeft Python 3.10 of nieuwer nodig en een bereikbaar NextPDF Server-endpoint. Zie de Python SDK-snelstart.

De installatie verifiëren

Controleer of elke distributie correct is geïnstalleerd voordat je code gaat schrijven.

Core / PHP

composer show nextpdf/core

Een versieregel bevestigt dat de engine is geïnstalleerd en beschikbaar is voor de autoloader.

Laravel

php artisan package:discover --ansi

De uitvoer vermeldt nextpdf/laravel tussen de gedetecteerde pakketten.

Symfony

php bin/console debug:container nextpdf

De container toont de nextpdf.document-alias en de PdfFactory-service.

Server

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

Dit start het register op en print de tools die deze installatie beschikbaar stelt, zonder een server te starten.

Python

nextpdf version

Een versiestring bevestigt dat de SDK zonder fouten importeert.

Zie ook

Uw eerste PDF Genereer een PDF vanuit PHP en render HTML naar PDF.

Kies uw pad Bepaal welke distributie en HTML-renderer bij uw applicatie passen.

Integraties De volledige uitbreidingskaart en selectiegids.

Connect (server) Voer de engine uit als netwerkservice via MCP, REST en gRPC.