Migratiehandleidingen

Recepten en handleidingen verschijnen hier zodra upstream-repository's worden uitgebracht. Deze pagina verwijst u naar content die is geschreven in de bron- repository's (nextpdf, nextpdf-Laravel, nextpdf-Symfony en de overige ecosysteempakketten). Zie voor documentatie die vandaag beschikbaar is Insider_ (35 artikelen, alle 17 locales) of Een integratie kiezen.

Migratiehandleidingen

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. De aggregator haalt de handleiding binnen op deze site, en totdat de handleiding beschikbaar komt, verwijst de link ervan naar een tijdelijke aanduiding. 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 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 dompdf (gepland upstream)
mPDF	mPDF → NextPDF core	API-herschrijving	nextpdf (core)	mPDF-handleiding mpdf (gepland upstream)
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 tcpdf-compat (gepland upstream)

De handleidingen dompdf en mpdf 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 (dompdf (gepland upstream)) — 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 (mpdf (gepland upstream)) — 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.
• TCPDF → NextPDF (compat-legacy) (tcpdf-compat (gepland upstream)) — 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.

Hoe de handleidinglinks worden omgezet

Elke [[…]]-tijdelijke aanduiding hierboven verwijst vooruit naar een pagina die in de bezittende repository onder docs/public/migration/ staat, en de aggregator haalt die pagina binnen op deze site. De doel-slugs volgen één conventie:

/migration/<source>/

Het <source>-token is de korte naam van de bibliotheek waarvandaan u migreert: een van dompdf, mpdf of tcpdf-compat, zoals vermeld in de handleidingreferentietabel hierboven. Totdat een doelpagina is geaggregeerd, blijft de link ervan een tijdelijke aanduiding en wordt deze niet omgezet. Deze index doet geen gedragsuitspraak over enige doelhandleiding; zij legt uitsluitend de routering en het gedeelde migratiemodel vast.

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.