Migreren naar NextPDF

NextPDF is een Portable Document Format (PDF) 2.0-engine voor PHP. Als u al PDF’s genereert met een andere bibliotheek, brengt een migratiehandleiding de application programming interface (API) van die bibliotheek in kaart op NextPDF en documenteert zij de gedragsverschillen die u tegenkomt. Deze repository-overstijgende index legt vast welke handleiding u vanaf welke bibliotheek laat overstappen, welke repository elke handleiding bezit en het gedeelde model dat elke handleiding gebruikt.

Omdat deze pagina een index is, doet zij geen gedragsuitspraak over enige handleiding. Elke handleiding hoort bij haar eigen repository, en de aggregator publiceert haar op deze site. Elke gedragsuitspraak staat in de handleiding zelf, onderbouwd door een test in de repository of een vastgepinde clausule van ISO 32000-2 / Cascading Style Sheets Working Group (CSS WG), niet hier.

Het ene migratiemodel

Elke NextPDF-migratiehandleiding gebruikt hetzelfde eerlijke model. Lees elke handleiding met dat model in gedachten:

Compatibel met, niet byte-identiek. NextPDF en de bibliotheek die u verlaat zijn onafhankelijke implementaties. Een gemigreerd document behoudt de functionele bedoeling, niet de identiteit op pixel- of byteniveau. Geen enkele handleiding claimt een directe vervanging of 100% compatibiliteit.
Dekking is een gemeten telling, geen bewering. Waar een handleiding een dekkingscijfer noemt, zoals het cijfer voor de TCPDF-adapter, is dat cijfer een metriek voor functionele volledigheid die is afgeleid van een matrix in de repository, in de zin van ISO/IEC 25023 clausule 43. Het is een gemeten telling van gedekte methoden, geen algemene garantie.
Elke handleiding vermeldt haar gedragsverschillen openlijk. Elke handleiding bevat een expliciete verschillentabel en een sectie „niet-ondersteund / geen direct equivalent”. Een verschil is een gedocumenteerde engine-eigenschap, geen defect.
Een wijziging van de renderer vereist een hernieuwde beoordeling. Migreren wijzigt code en vereist een nieuwe uitvoer-baseline. Elke handleiding beschrijft hoe u de migratie test; visuele acceptatie gebeurt per document en blijft de verantwoordelijkheid van de integrator.

De migratievormen

De handleidingen vallen uiteen in twee vormen. Elke vorm geeft aan hoeveel code er verandert.

API-herschrijfmigraties hebben geen compatibiliteitslaag: elke aanroepplek wordt herschreven met behulp van de werkwoordtoewijzing en optietoewijzing uit de handleiding. De migraties van Hypertext Markup Language (HTML)-naar-PDF-bibliotheken (dompdf, mpdf) gebruiken deze vorm; zij richten zich rechtstreeks op de NextPDF Html-pijplijn.
Drop-in-en-dan-migreren-migraties leveren een vrijwel broncompatibele adapter, zodat de eerste stap een minimale afhankelijkheidswissel is. Vanaf daar migreert u aanroepplekken stapsgewijs naar de moderne API en stoot u de adapter daarna af. De TCPDF-migratie gebruikt deze vorm, via de nextpdf/compat-legacy-adapter.

Referentie van handleiding en bezittende repository

Elke handleiding hieronder staat in de docs/public/ van de bezittende repository, en de aggregator haalt haar binnen op deze site. De bezittende repository is gezaghebbend voor de gedragsuitspraken van die handleiding; deze index legt uitsluitend de routering vast.

Vanaf	Handleiding	Vorm	Bezittende repository	Pagina
Dompdf	Dompdf → NextPDF Html-pijplijn	API-herschrijving	`nextpdf` (core)	Dompdf-handleiding
mPDF	mPDF → NextPDF core	API-herschrijving	`nextpdf` (core)	mPDF-handleiding
FPDF	FPDF → NextPDF core	API-herschrijving	`nextpdf` (core)	FPDF-handleiding
TCPDF 6.x	TCPDF → NextPDF via de compat-legacy-adapter	Drop-in-en-dan-migreren	`nextpdf-compat-tcpdf`-repo, pakket `nextpdf/compat-legacy`	TCPDF-handleiding

De handleidingen dompdf, mpdf en fpdf staan in de core-repository omdat zij zich richten op core-engine-API’s, en de examples/ van core ondersteunen hen. De handleiding tcpdf-compat staat in de compat-tcpdf-repository omdat het pakket nextpdf/compat-legacy het TCPDF-gedragsoppervlak en de adaptertests bezit die de handleiding ondersteunen. Deze index hoort van nature thuis in de docs-repository omdat zij meerdere repository’s omspant, en zij doet geen gedragsuitspraak over enige afzonderlijke handleiding.

Waar elke handleiding voor dient

Dompdf → NextPDF — voor codebases die dompdf/dompdf server-side gebruiken. Zij brengt loadHtml/render/output en de Options-sleutels in kaart op de NextPDF Html-pijplijn en verwijst CSS-functieverwachtingen door naar de Verified-only CSS-ondersteuningsmatrix. Er is geen Dompdf-classlaag; u herschrijft elke aanroepplek.
mPDF → NextPDF — voor codebases die mpdf/mpdf gebruiken. Zij brengt WriteHTML/Output/AddPage en de constructor-configuratie-array in kaart op de core-API, met één verschil in lettertypeverwerking: NextPDF verwerkt lettertypen via één enkele lettertypemap plus CSS-matching en maakt altijd subsets. Er is geen Mpdf-classlaag.
FPDF → NextPDF — voor codebases die de teken-API van FPDF rechtstreeks gebruiken. Zij brengt AddPage/SetFont/Cell/MultiCell/Write/Text/Image/Output en het handmatige cursormodel in kaart op de core-API en documenteert het verschil in eenheden. Er is geen FPDF-classlaag.
TCPDF → NextPDF (compat-legacy) — voor TCPDF 6.x-codebases die de kleinste eerste wijziging willen. Installeer de adapter, controleer uw werkelijke oppervlak met strikte modus tegen de dekkingsmatrix in de repository, migreer aanroepplekken van de adapter af en voeg vervolgens daarbovenop getagde structuur voor PDF/Universal Accessibility (PDF/UA-2) toe, een mogelijkheid die TCPDF nooit had. De adapter is een steiger, niet de bestemming, en hij is geen garantie voor directe vervanging.

Zie ook

CSS-ondersteuningsmatrix — de Verified-only autoriteit voor CSS-functieverwachtingen in de handleidingen dompdf en mpdf.
Integratiecookbook — de repository-overstijgende index voor integratiepakketten uit het ecosysteem. Het behandelt een ander aandachtspunt: de engine verbinden, niet ernaartoe migreren.