Kies je pad

In één oogopslag

NextPDF biedt verschillende instaproutes. De juiste keuze hangt af van waar je code draait en welk soort Portable Document Format (PDF)-uitvoer je nodig hebt. Gebruik deze pagina om drie keuzes te maken: welke distributie je installeert, welke Hypertext Markup Language (HTML)-renderer je gebruikt en wanneer een werklast Pro of Enterprise vereist.

Lees het gedeelte dat bij je vraag past, of loop aan het einde de beslissingssamenvatting kort door.

Kies een distributie

Begin met de manier waarop je applicatie de engine aanroept. Gebruik de eerste rij die bij je situatie past.

Je situatie	Installeren	Waarom
Een eenvoudig PHP-project, een library of een command-line interface (CLI)-tool	NextPDF core (`nextpdf/core`)	Alleen de engine. Die doet geen aannames over een framework en draait geen service.
Een Laravel-, Symfony- of CodeIgniter-applicatie	De bijbehorende framework-integratie	Je krijgt container bindings, response helpers en queue jobs bovenop core.
Een niet-PHP-service, een agent of een andere runtime die de engine over een netwerk moet aanroepen	NextPDF Server (`nextpdf/server`)	Eén enkele service stelt de engine beschikbaar via Model Context Protocol (MCP), REST en gRPC.
Python-code die PDF-bestanden van een NextPDF Server nodig heeft	De Python Software Development Kit (SDK) (`pip install nextpdf`)	Een getypeerde client voor een draaiende server. Die bevat de engine niet.

Twee punten worden vaak over het hoofd gezien:

Een framework-integratie bevat core. Je installeert ze niet allebei afzonderlijk. De adapter declareert en resolvet nextpdf/core voor je.
De Python SDK is een client, geen engine. Die maakt verbinding met een NextPDF Server-endpoint. De PDF-generatie vindt plaats in PHP op de server.

Kies een HTML-renderer

NextPDF kan HTML op vier manieren naar PDF renderen. De ingebouwde pipeline dekt de meeste documenten zonder extra configuratie. Gebruik de drie renderer-packages wanneer je lay-out op browserniveau nodig hebt of verbinding moet maken met een bestaande service.

Renderer	Package	Waar het draait	Kies hiervoor wanneer
Ingebouwde `writeHtml()`	`nextpdf/core`	In-process, pure PHP	Je wilt een ondersteunde subset van HTML en Cascading Style Sheets (CSS) zonder browser en zonder netwerkaanroep.
Artisan	`nextpdf/artisan`	Headless Chrome op de host	Je hebt volledige Chrome-lay-out nodig — flexbox, grid, complexe selectors, webfonts — met selecteerbare tekst.
Cloudflare	`nextpdf/cloudflare`	Cloudflare Browser Rendering aan de edge	Renderen hoort aan de edge thuis, of je wilt browserprocessen van je eigen hosts weghouden.
Gotenberg	`nextpdf/gotenberg`	Een Gotenberg-service die je zelf beheert	Je converteert officedocumenten (DOCX, XLSX) of HTML via een bestaande Gotenberg-deployment.

Zo lees je de tabel:

Begin met de ingebouwde pipeline. Dit is het snelste pad en heeft geen externe afhankelijkheid. Controleer ondersteuning voor een eigenschap in de CSS-ondersteuningsmatrix voordat je erop vertrouwt.
Gebruik Artisan wanneer een lay-out buiten de ondersteunde subset valt en het renderen op je eigen infrastructuur moet blijven. Het start een Chrome-proces, dus houd rekening met die levenscyclus.
Gebruik Cloudflare wanneer je dezelfde browsergetrouwheid wilt en renderen aan de edge verkiest boven lokale browserprocessen.
Gebruik Gotenberg voor het converteren van officedocumenten, of wanneer je Gotenberg al draait en wilt dat NextPDF het aanstuurt.

Wanneer je Pro of Enterprise nodig hebt

De core engine genereert, rendert en inspecteert PDF’s kosteloos en zonder licentie. NextPDF Pro en NextPDF Enterprise zijn de twee gelicentieerde niveaus van het nextpdf/premium-package. De installatie ervan voegt mogelijkheden toe zonder de core API te wijzigen.

Je moet	Tier	Mogelijkheid
Een PDF digitaal ondertekenen met een PDF Advanced Electronic Signatures (PAdES)-baseline	Pro	Implementaties voor ondertekening met softwaresleutels.
Archiveerbare PDF/A-uitvoer produceren	Pro	PDF/A-conformiteit en archiveringsprofielen.
Een elektronische factuur insluiten (Factur-X / ZUGFeRD)	Pro	Implementaties van e-factuurcontracten.
Ondertekenen met een hardware security module (HSM)	Enterprise	Hardware-ondersteunde sleutelbewerkingen.
Gekwalificeerde elektronische handtekeningen uitgeven	Enterprise	Workflow voor gekwalificeerde handtekeningen en het volledige compliance-oppervlak.

Twee regels houden de beslissing helder:

Als je uitvoer bestaat uit niet-ondertekende, niet-archiveerbare PDF’s, dan is core compleet. Je hebt geen licentie nodig.
Wanneer je nextpdf/premium installeert, detecteren de framework-integraties en de server het automatisch. Ze stellen de extra mogelijkheden beschikbaar via dezelfde container keys en tool catalog. Je applicatie hoeft geen codewijzigingen door te voeren om ze in gebruik te nemen.

Beslissingssamenvatting

Distributie

Eenvoudig PHP → core. Framework-app → de bijbehorende integratie. Netwerkgrens → de server. Python-client → de Python SDK.

HTML-renderer

Ondersteunde subset, geen afhankelijkheid → writeHtml(). Browser- getrouwheid op je hosts → Artisan. Aan de edge → Cloudflare. Office-conversie → Gotenberg.

Gelicentieerde niveau

Niet-ondertekende PDF’s → core. Ondertekenen, PDF/A, e-factuur → Pro. HSM of gekwalificeerde handtekeningen → Enterprise.

Nog twijfel?

Installeer core, doorloop Je eerste PDF, en voeg pas een package toe wanneer er een concrete behoefte ontstaat. Je kunt dit alles later wijzigen.

Zie ook

NextPDF installeren Het exacte commando voor elke distributie en renderer.

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

Integraties De volledige uitbreidingskaart, selectiegids en handleidingen per package.

Verbinden (server) Draai de engine als netwerkservice via MCP, REST en gRPC.