Integrazioni

In breve

Le estensioni NextPDF collegano il motore PDF di base ai framework applicativi, ai renderer basati su browser, ai servizi edge, agli strumenti di build e alle migrazioni di codice legacy. Ogni sezione dedicata a un’estensione segue la stessa struttura del manuale: panoramica, installazione, avvio rapido, configurazione, API, guida per sviluppatori, uso in produzione, sicurezza e risoluzione dei problemi.

Mappa delle estensioni

Estensione	Pacchetto	Quando usarla	Sezione principale
Laravel	nextpdf/laravel	Quando si sviluppano applicazioni Laravel e servono binding del container, una facade, risposte e job in coda.	Laravel
Symfony	nextpdf/symfony	Quando si sviluppano applicazioni Symfony e servono un bundle, l’integrazione con la DI, job Messenger e risposte HTTP.	Symfony
CodeIgniter	nextpdf/codeigniter	Quando si sviluppano applicazioni CodeIgniter 4 e servono servizi, un wrapper di libreria, risposte e job in coda.	CodeIgniter
Artisan	nextpdf/artisan	Quando servono rendering HTML tramite Chrome CDP, importazione di pagine o utilità di ispezione PDF di basso livello.	Artisan
Cloudflare	nextpdf/cloudflare	Quando il rendering avviene tramite Cloudflare Browser Rendering, va protetto l’accesso all’API oppure occorre archiviare PDF su R2.	Cloudflare
Gotenberg	nextpdf/gotenberg	Quando si convertono documenti d’ufficio o HTML tramite un servizio Gotenberg.	Gotenberg
Compatibilità TCPDF	nextpdf/compat-legacy	Quando si migra codice applicativo in stile TCPDF verso NextPDF senza una riscrittura completa.	Compatibilità TCPDF
Backport Builder	nextpdf/backport-builder	Quando si gestiscono artefatti di rilascio per runtime PHP meno recenti.	Backport Builder

Guida alla scelta

Esigenza	Punto di partenza	Nota operativa
Helper per le risposte del framework	Laravel, Symfony o CodeIgniter	Il pacchetto del framework gestisce l’integrazione con il container e con le risposte; il core gestisce la creazione dei documenti.
Rendering HTML orientato ai pixel	Artisan o Cloudflare	Scegliere Artisan per Chrome CDP eseguito sull’host; scegliere Cloudflare quando il rendering deve avvenire all’edge.
Conversione di documenti d’ufficio	Gotenberg	Considerare Gotenberg come un confine di servizio esterno, con controlli su timeout, dimensione e SSRF.
Migrazione da TCPDF legacy	Compatibilità TCPDF	Consultare la tabella di copertura dei metodi prima di dare per scontato che una chiamata legacy sia supportata.
Distribuzione PHP meno recente	Backport Builder	Solo strumento di build; non installare come dipendenza di runtime dell’applicazione.

Struttura del manuale

Ogni sezione dedicata a un’estensione contiene questi tipi di pagina:

Pagina	Scopo
overview	Confine del prodotto, pubblico di riferimento, flussi di lavoro supportati e limitazioni.
install	Comandi di installazione e dipendenze di runtime richieste.
quickstart	Flusso di lavoro minimo funzionante con un primo risultato copiabile.
configuration	Ogni chiave di configurazione supportata, variabile d’ambiente, valore predefinito ed effetto corrispondente.
api	Classi pubbliche, metodi, parametri, valori predefiniti, valori restituiti ed eccezioni.
developer-guide	Architettura dell’estensione, ciclo di vita, punti di estensione e organizzazione del codice.
production-usage	Distribuzione, affidabilità, prestazioni, sicurezza dei worker e osservabilità.
security-and-operations	Confini di fiducia, valori predefiniti sicuri, segreti, accesso ai file e controlli operativi.
troubleshooting	Sintomi, diagnostica, cause probabili e azioni correttive.

Convenzione delle tabelle API

In tutto il manuale le tabelle API usano le stesse colonne, così i lettori possono confrontare i pacchetti senza dover apprendere un nuovo layout.

Colonna	Significato
Simbolo	Classe, metodo, endpoint, comando CLI o oggetto di configurazione completamente qualificato.
Parametri	Nome, tipo, obbligatorietà, valore predefinito e valori accettati.
Comportamento predefinito	Cosa accade quando il chiamante omette un input facoltativo.
Valore restituito	Tipo restituito o artefatto di output.
Solleva o fallisce con	Tipo di eccezione, stato HTTP, errore di convalida o modalità di errore operativo.
Note	Dettagli su sicurezza, sicurezza dei worker, compatibilità o prestazioni.

Preparazione alla traduzione

Il testo sorgente in inglese è scritto in vista di una successiva localizzazione: sezioni brevi, intestazioni stabili, sostantivi espliciti, assenza di espressioni idiomatiche e tabelle per le strutture ripetute. Le nuove pagine API devono mantenere i nomi dei metodi, le chiavi di configurazione, i flag della CLI e i nomi delle eccezioni in formato codice, in modo che gli strumenti di traduzione li conservino.