Handleidingen

In één oogopslag

Handleidingen laten zien hoe je NextPDF koppelt aan de omgeving waarin je code draait. Dit tabblad begint met de checklist voor operationeel beheer in productie en behandelt daarna vijf gebieden, in de volgorde waarin je ze doorgaans in gebruik neemt: integraties met frameworks en renderers, de NextPDF Connect-server, de Python-SDK, het schrijven van engine-extensies en probleemoplossing. Elke sectie hieronder begint met de bijbehorende hub en noemt daarna de pagina’s die je waarschijnlijk het vaakst gebruikt.

Gebruik het Cookbook voor een kopieerbaar, taakgericht recipe. Gebruik de Referentie voor het geverifieerde Application Programming Interface (API)-oppervlak en de ondersteuningsmatrices.

Integraties

Acht pakketten verbinden de kern-engine met frameworks, browserrenderers, edge-services, buildtools en migratiepaden voor verouderde systemen. Elke sectie over een pakket volgt dezelfde documentatiestructuur — overzicht, installatie, snelstart, configuratie, API, ontwikkelaarsgids, gebruik in productie, beveiliging en probleemoplossing — dus zodra je er één kent, ken je ze allemaal.

Pagina	Gebruik dit voor
Integraties	Het extensieoverzicht en de selectiehandleiding. Lees dit eerst om een pakket te kiezen.
Index van integratie-API’s	Welke extensie-API-pagina hoort bij welk framework, welke renderer, welk transport en welk buildtool-oppervlak.
NextPDF voor Laravel	De adapter voor het Laravel-framework.
NextPDF voor Symfony	De adapter voor het Symfony-framework.
NextPDF voor CodeIgniter	De adapter voor het CodeIgniter-framework.
NextPDF Artisan	De Chrome-rendererbrug voor HTML-rendering op browserniveau.
NextPDF Cloudflare	Het implementatiepad aan de edge op Cloudflare.
NextPDF Gotenberg	De Gotenberg-rendererbrug.
TCPDF-compatibiliteit	De compatibiliteitsshim voor codebases die overstappen vanaf TCPDF.
NextPDF Backport Builder	De buildtool voor oudere PHP-runtimes.

NextPDF Connect

Het nextpdf/server-pakket laat de engine draaien als een langlopende service: één deterministisch toolregister dat via het Model Context Protocol (MCP), Representational State Transfer (REST) en gRPC wordt aangeboden, achter een bevestigingspoort met human-in-the-loop-controle voor tools met een hoog risico.

Pagina	Gebruik dit voor
NextPDF Connect	De sectiehub: concepten, configuratie en serverbeheer.
Overzicht van Connect	De pakketgrens en de drie transporten.
Connect-snelstart	Een eerste werkende MCP-handshake en het bijbehorende REST-renderverzoek.
NextPDF Connect configureren	Het MCP-YAML-bestand en de `NEXTPDF_*`-omgevingsvariabelen.
NextPDF Connect API-referentie	Elke geregistreerde tool, elk gRPC-symbool, elke vermelding in het foutmodel en elke rate limit.
NextPDF Connect implementeren	RoadRunner-workerprofielen, Docker en stores met Redis-ondersteuning.
Beveiliging en operationeel beheer voor Connect	Authenticatie, transportbeveiliging en het dreigingsmodel.

Elk transport heeft een eigen referentiepagina.

Pagina	Gebruik dit voor
MCP-transport	JSON-RPC 2.0-framing via standaardinvoer en -uitvoer.
REST-transport	Het OpenAPI 3.1-contract, bearer-authenticatie en routes met niveaucontrole.
gRPC-transport	De service `nextpdf.connect.v1`, server-streaming en authenticatie via metadata.

Python-SDK

Citatieklare PDF-extractie voor Python-applicaties, agents en gebruik op de opdrachtregel, ondersteund door een NextPDF Connect-endpoint.

Pagina	Gebruik dit voor
Python-SDK	De sectiehub voor het Python-pakket `nextpdf`.
Overzicht van de Python-SDK	Wat de SDK doet en hoe die zich verhoudt tot Connect.
Snelstart voor de Python-SDK	Installeer met `pip install nextpdf` en configureer een client voor je server.
API-referentie voor de Python-SDK	De clientklassen, methoden en getypeerde resultaten.
Python-CLI	De opdrachtregelinterface voor extractieworkflows.
Python MCP-server	De SDK beschikbaar stellen aan agents die MCP spreken.

De engine uitbreiden

Met de publieke Service Provider Interface (SPI) kun je functionaliteit toevoegen zonder een fork te maken: contracten voor lettertypen, layout-engines, event listeners en signing-backends, elk met een expliciete stabiliteitsbelofte.

Pagina	Gebruik dit voor
Extensies schrijven	Wat je kunt uitbreiden en de stabiliteitsbelofte daarachter.
Stabiliteitsregels voor de SPI	Het contract voor achterwaartse compatibiliteit waarop je extensie kan voortbouwen.
Aangepaste lettertypen: het FontRegistry-contract	Je eigen lettertypen registreren en meeleveren.
Aangepaste layout-engines en tekst onderscheppen	Layoutgedrag vervangen of onderscheppen.
Action triggers en event listeners	De levenscyclus van het document observeren en erop reageren.
KMS-providercontract	Sleutels leveren vanuit je eigen Key Management Service (KMS).

Probleemoplossing

Kennisbankvermeldingen leiden je van symptoom naar oplossing en zijn gebaseerd op de eigen uitzonderingstaxonomie van de engine. Begin bij wat je waarneemt, niet bij een klassenaam.

Pagina	Gebruik dit voor
Problemen oplossen	De hub van de kennisbank: hoe vermeldingen zijn opgebouwd en waar je begint.
Problemen oplossen: lettertypen en tagging	Fouten bij het inbedden van lettertypen en het taggen van structuur.
Problemen oplossen: versleuteling en machtigingen	Fouten met versleuteling, wachtwoorden en machtigingen.
Problemen oplossen: geheugen en prestaties	Geheugenplafonds en doorvoerproblemen.
Problemen oplossen: PDF/A- en PDF/UA-validatie	Validatiefouten bij archivering en toegankelijkheid.
Problemen oplossen: handtekeningen en tijdstempels	Validatiefouten bij handtekeningen en tijdstempels.

Zie ook

Cookbook — taakgerichte recipes voor PHP, Connect en integraties.
Referentie — het geverifieerde API-oppervlak, de ondersteuningsmatrices en de foutreferentie.
Migreren naar NextPDF — overstappen van een andere PDF-bibliotheek, op het tabblad Aan de slag.
Binnen NextPDF — de Insider_-essays over waarom de engine zich zo gedraagt.