Questa sezione offre una mappa della documentazione concettuale e pratica di NextPDF, un motore headless Portable Document Format 2.0 (PDF 2.0) in PHP 8.4. Ogni riquadro sottostante rimanda a un hub di sezione, non a una singola pagina. Usare questa sezione per individuare il punto di partenza corretto, quindi seguire i collegamenti all’interno dell’hub scelto.
Le guide spiegano il come e il perché. Quando serve una ricetta operativa e copiabile, consultare invece il Cookbook. Quando servono la superficie API verificata e le matrici di supporto, consultare il Reference.
Le estensioni di NextPDF collegano il motore di base ai framework applicativi, ai renderer dei browser, ai servizi edge, agli strumenti di build e alle migrazioni da sistemi legacy. Ogni sezione dedicata a un’estensione segue la stessa struttura del manuale: panoramica, installazione, guida rapida, configurazione, API, guida per gli sviluppatori, utilizzo in produzione, sicurezza e risoluzione dei problemi.
IntegrazioniAdattatori per framework (Laravel, Symfony, CodeIgniter), bridge per renderer (Artisan, Cloudflare, Gotenberg), lo shim di compatibilità TCPDF e il Backport Builder. Leggere prima la mappa delle estensioni e la guida alla scelta.
MigrazioneTrasferire un codebase esistente a NextPDF. Guide specifiche per origine per dompdf e mPDF, oltre all'unica regola condivisa da ogni guida: comportamento compatibile, non output identico byte per byte, con differenze documentate.
Usare queste guide quando i chiamanti sono remoti, sono scritti in un altro linguaggio oppure sono sistemi di intelligenza artificiale (AI) che richiedono un endpoint di strumento anziché una libreria PHP.
NextPDF Connect (server)Il pacchetto nextpdf/server: un registro deterministico di strumenti PDF servito tramite Model Context Protocol (MCP), Representational State Transfer (REST) e gRPC, dietro un gate di conferma con intervento umano. Installazione, configurazione e distribuzione.
SDK PythonEstrazione di PDF pronta per le citazioni, destinata ad applicazioni Python, agenti e riga di comando, supportata da un endpoint NextPDF Connect. Installare con pip install nextpdf, quindi indirizzare un client al proprio server.
NextPDF Core mira alla struttura richiesta dagli standard. La conformità effettiva è stabilita da un validatore, un controllo o un’autorità ricevente esterni. Ogni pagina sulla conformità riconduce le proprie affermazioni a una clausola e mantiene esplicito tale limite.
ConformitàI profili standard a cui punta NextPDF: PDF 2.0 (ISO 32000-2), archiviazione PDF/A-4 (ISO 19005-4), accessibilità PDF/UA-2 (ISO 14289-2), produzione di stampa PDF/X e fatturazione elettronica ZUGFeRD / Factur-X.
Mappatura della baseline PAdESCome NextPDF si mappa ai livelli baseline ETSI EN 319 142 PAdES B-B, B-T, B-LT e B-LTA, separando la superficie di firma Core dai livelli Premium ed Enterprise.
Queste guide riguardano l’esecuzione sicura di NextPDF in produzione, la diagnosi degli errori e lo sviluppo sulla superficie pubblica di estensione.
Attendibilità e sicurezzaL'impostazione ingegneristica del motore di base: modello delle minacce, modello di sicurezza per firma e cifratura, comportamento nella gestione dei dati e criteri di divulgazione delle vulnerabilità, con il rispettivo limite per ciascuno.
Risoluzione dei problemiVoci da sintomo a risoluzione per errori di firma, PDF/A, PDF/UA, font, tagging, cifratura e autorizzazioni, basate sulla tassonomia delle eccezioni del motore stesso.
Creazione di estensioniLa Service Provider Interface (SPI) pubblica: cosa è possibile estendere, la garanzia di stabilità che la sostiene, font personalizzati, motori di layout personalizzati, trigger di azione e il contratto del provider Key Management Service (KMS).
Premium (Pro ed Enterprise)Ciò che NextPDF Pro ed Enterprise aggiungono rispetto al core open source: la matrice delle funzionalità, la conformità agli standard, la convalida HSM e FIPS e le licenze. L'adozione di un'edizione commerciale non richiede alcuna modifica al codice dell'applicazione.
La sezione Insider_ spiega perché NextPDF si comporta in questo modo. Offre il punto di vista di un ingegnere senior sulla progettazione, con ogni affermazione contrassegnata dal tipo di evidenza a supporto.
Concetti (Insider_)Filosofia di progettazione, panorama degli standard, pipeline HTML, firma e convalida a lungo termine, font, generazione ad alto volume e approccio ai test. Iniziare da qui per comprendere il ragionamento del motore.
