Introduzione a NextPDF

In breve

NextPDF è un motore per PHP 8.4 che genera e analizza documenti PDF 2.0, il formato di file definito da ISO 32000-2. Il documento viene costruito con un’API tipizzata e fluente. HTML e CSS possono essere renderizzati in pagine. L’output può essere firmato e archiviato, e i contenuti strutturati possono essere riletti. Tutto avviene in PHP e i percorsi principali non richiedono alcun binario esterno.

Il progetto è disponibile in quattro distribuzioni. Tutte condividono lo stesso motore di base: si installa quindi quella più adatta al proprio modo di lavorare.

Distribuzione	Pacchetto	Quando installarla
NextPDF core (OSS)	`nextpdf/core`	Si scrive PHP e si vuole usare il motore direttamente, con un framework o in modo autonomo.
NextPDF Server (OSS)	`nextpdf/server`	Serve un servizio autonomo che espone il motore tramite MCP, REST e gRPC.
NextPDF Pro	`nextpdf/premium` (tier Pro)	Servono firma digitale, archiviazione PDF/A o output di fatture elettroniche.
NextPDF Enterprise	`nextpdf/premium` (tier Enterprise)	Servono firma basata su hardware, firme qualificate e l’intera superficie di conformità.

NextPDF Pro e NextPDF Enterprise sono due tier con licenza dello stesso pacchetto nextpdf/premium. Il motore core funziona allo stesso modo, che quel pacchetto sia presente o meno.

Installazione in una riga

Per un progetto PHP semplice, installare il motore core con Composer.

composer require nextpdf/core

Questo singolo pacchetto genera e analizza PDF senza ulteriore configurazione. Le integrazioni con i framework, i renderer HTML, il server e lo SDK Python richiedono ciascuno un pacchetto aggiuntivo. La guida all’installazione elenca tutti i comandi.

Scegliere il percorso

NextPDF si integra nel codice esistente. Scegliere il punto di ingresso più adatto al proprio stack, quindi seguire il riquadro corrispondente.

Installazione La matrice completa di installazione: core, integrazioni con i framework, renderer HTML, server e SDK Python.

Il primo PDF Un breve tutorial che genera un PDF da PHP, quindi esegue il rendering di HTML in PDF.

Scegliere il percorso Una guida decisionale tra core, framework e server, e su quale renderer HTML utilizzare.

Integrazioni Adattatori per framework, renderer basati su browser, servizi edge e pacchetti di migrazione.

Come proseguire

Una volta generato il primo documento, queste sono le tre aree principali della documentazione.

Guide e integrazioni Utilizzare il pacchetto adatto al proprio framework, renderer, runtime o destinazione di migrazione: Laravel, Symfony, CodeIgniter, Artisan, Cloudflare e Gotenberg.

Riferimento API La superficie verificata del motore: classi, metodi, chiavi di configurazione e la matrice di supporto CSS.

Cookbook Ricette mirate alle attività: rendering di HTML in PDF, applicazione di stili con CSS, impaginazione di tabelle e suddivisione in pagine di contenuti estesi.

Perché un server separato?

Installare NextPDF Server quando un servizio non-PHP, un agente o un altro runtime deve richiamare il motore tramite un protocollo di rete, anziché collegare la libreria. Lo SDK Python è il client tipizzato per quel server.