Installare NextPDF

In breve

Ogni distribuzione di NextPDF si installa con un unico comando del gestore dei pacchetti. Le distribuzioni PHP usano Composer; l’SDK Python usa pip. Selezionare la scheda corrispondente al tipo di applicazione da realizzare, eseguire il comando e quindi confermare il risultato con il passaggio di verifica alla fine di questa pagina.

Un solo motore, diversi punti di accesso

Il motore di base è nextpdf/core. Le integrazioni con i framework, i renderer HTML, il server e il client Python aggiungono ciascuno un pacchetto su questa base. Nessuno di essi sostituisce il motore di base e tutti lo includono automaticamente.

Requisiti

NextPDF è pensato per un unico runtime moderno. I vincoli seguenti provengono direttamente dai file composer.json dei pacchetti stessi.

Requisito	Vincolo	Note
PHP	>=8.4 <9.0	Composer rifiuta l’installazione con PHP 8.3 o versioni precedenti, oppure con PHP 9.
Composer	2.7 o versioni successive	Risolutore delle dipendenze e generatore dell’autoloader.
ext-mbstring	Obbligatorio	Gestione delle stringhe multibyte per l’impaginazione del testo.
ext-zlib	Obbligatorio	Compressione dei flussi per gli oggetti PDF.
Chrome o Chromium	Facoltativo	Solo per il renderer Artisan (writeHtmlChrome()).
Servizio Gotenberg	Facoltativo	Solo per la conversione di documenti Office e HTML tramite Gotenberg.
Python	3.10 o versioni successive	Solo per l’SDK Python.

ext-mbstring e ext-zlib sono fornite già abilitate in ogni build PHP supportata. Le integrazioni ne verificano la presenza all’avvio e si arrestano con un messaggio chiaro se una delle due manca.

Installare il motore di base

Per generare e ispezionare file PDF da PHP, il motore di base è l’unico pacchetto necessario.

composer require nextpdf/core

Eseguire il commit di composer.lock affinché ogni worker distribuito risolva la stessa versione del motore. Una volta completata l’installazione, continuare con Il primo PDF.

Installare un’integrazione con un framework

Installare un adapter per il framework per ottenere binding del container, helper per le risposte e job in coda. Ogni adapter dichiara nextpdf/core e lo risolve automaticamente.

Laravel

composer require nextpdf/laravel

L’individuazione automatica registra il service provider e la facade Pdf. In seguito, pubblicare il file di configurazione:

php artisan vendor:publish --tag=nextpdf-config

Consultare la guida all’installazione di Laravel e la guida rapida di Laravel.

Symfony

composer require nextpdf/symfony

In un’applicazione Symfony Flex, il bundle si registra automaticamente. In un’applicazione non basata su Flex, aggiungere manualmente NextPDF\Symfony\NextPdfBundle a config/bundles.php. Consultare la guida all’installazione di Symfony.

CodeIgniter

composer require nextpdf/codeigniter

CodeIgniter 4 individua automaticamente la classe Services e l’helper pdf(), pertanto non è necessaria alcuna registrazione manuale. Consultare la guida all’installazione di CodeIgniter.

Installare un renderer o un servizio

NextPDF esegue il rendering da HTML a PDF in tre modi. Installare quello corrispondente al punto in cui deve avvenire il rendering. Nessuno di questi sostituisce writeHtml(), la pipeline HTML integrata in puro PHP del motore di base.

Artisan (Chrome)

composer require nextpdf/artisan

Aggiunge il rendering con Chrome headless tramite il Chrome DevTools Protocol (CDP). È inoltre necessario un binario di Chrome o Chromium raggiungibile sull’host. Una volta installato, richiamare writeHtmlChrome() su un documento. Consultare la guida rapida di Artisan.

Cloudflare

composer require nextpdf/cloudflare guzzlehttp/guzzle

Esegue il rendering tramite Cloudflare Browser Rendering a livello edge. Il bridge dipende solo dai contratti PSR-18 e PSR-17, pertanto è necessario fornire il proprio client HTTP (qui è mostrato Guzzle). Consultare la guida all’installazione di Cloudflare.

Gotenberg

composer require nextpdf/gotenberg guzzlehttp/guzzle

Converte i documenti Office e l’HTML tramite un servizio Gotenberg. È necessario fornire un client PSR-18 e un’istanza Gotenberg raggiungibile. Consultare la guida all’installazione di Gotenberg.

I renderer si estendono al di fuori di PHP

Artisan avvia un processo browser, mentre Cloudflare e Gotenberg richiamano un servizio di rete. Considerare l’HTML come non attendibile e leggere la pagina relativa a sicurezza e operazioni di ciascun pacchetto prima di eseguire il rendering di input influenzabile dall’utente.

Installare il server

NextPDF Server (chiamato anche Connect) è un servizio autonomo che espone il motore tramite MCP, REST e gRPC.

composer require nextpdf/server

Il pacchetto aggiunge entry point da console in vendor/bin/, tra cui vendor/bin/nextpdf-mcp (il server stdio MCP) e vendor/bin/nextpdf-server (il server REST). I trasporti REST e gRPC richiedono inoltre il binario RoadRunner:

./vendor/bin/rr get-binary

Consultare la guida all’installazione di Connect e la guida rapida di Connect.

Installare l’SDK Python

L’SDK Python è il client tipizzato per un’istanza in esecuzione di NextPDF Server. Installarlo da PyPI:

pip install nextpdf

L’SDK richiede Python 3.10 o versioni successive e un endpoint raggiungibile di NextPDF Server. Consultare la guida rapida dell’SDK Python.

Verificare l’installazione

Verificare che ogni distribuzione sia stata risolta correttamente prima di iniziare a scrivere codice.

Motore di base / PHP

composer show nextpdf/core

Una riga con la versione conferma che il motore è installato e presente nell’autoloader.

Laravel

php artisan package:discover --ansi

L’output elenca nextpdf/laravel tra i pacchetti individuati.

Symfony

php bin/console debug:container nextpdf

Il container segnala l’alias nextpdf.document e il servizio PdfFactory.

Server

./vendor/bin/generate-skills --dry-run --list-tools

Il comando avvia il registro e stampa gli strumenti esposti da questa installazione, senza avviare effettivamente un server.

Python

nextpdf version

Una stringa di versione conferma che l’SDK viene importato correttamente.

Vedere anche

Il primo PDF Generare un PDF da PHP ed eseguire il rendering da HTML a PDF.

Scegliere il percorso Decidere quale distribuzione e quale renderer HTML siano più adatti alla propria applicazione.

Integrazioni La mappa completa delle estensioni e la guida alla selezione.

Connect (server) Eseguire il motore come servizio di rete tramite MCP, REST e gRPC.