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.

Requisiti di runtime di NextPDF, letti dai file composer.json dei pacchetti stessi

Requisito	Vincolo	Stato	Note
PHP	>=8.4 <9.0	Obbligatorio	Composer rifiuta l'installazione su PHP 8.3 o versioni precedenti oppure su PHP 9.
Composer	2.x	Obbligatorio	Necessario per la risoluzione delle dipendenze e la generazione dell'autoloader.
ext-mbstring	—	Obbligatorio	Gestione delle stringhe multibyte per l'impaginazione del testo.
ext-zlib	—	Obbligatorio	Compressione dei flussi per gli oggetti Portable Document Format (PDF).
ext-intl	—	Obbligatorio	Servizi International Components for Unicode (ICU): testo bidirezionale, interruzione di riga e formattazione in base alle impostazioni locali.
ext-gd	—	Obbligatorio	Decodifica ed elaborazione delle immagini raster per le immagini incorporate.
ext-curl	—	Obbligatorio	Comunicazioni di rete: marcatura temporale RFC 3161 e recupero di risorse remote. La generazione offline non lo utilizza, ma Composer lo richiede comunque.
ext-openssl	—	Obbligatorio	Crittografia per firme digitali, strutture CMS e cifratura.
Chrome or Chromium	—	Facoltativo	Solo per il renderer Artisan (writeHtmlChrome()).
Gotenberg service	—	Facoltativo	Solo per la conversione di file office e HTML tramite Gotenberg.
Python	3.10+	Facoltativo	Solo per il software development kit (SDK) di Python.

ext-mbstring e ext-zlib sono abilitate nella maggior parte delle build PHP; ext-intl, ext-gd, ext-curl e ext-openssl variano a seconda della distribuzione, pertanto verificare tutte e sei con php -m prima di procedere all’installazione. Le integrazioni verificano all’avvio la presenza delle estensioni di cui hanno bisogno e si arrestano con un messaggio chiaro se una di esse 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 che l’utente può influenzare.

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 PDFGenerare un PDF da PHP ed eseguire il rendering da HTML a PDF.

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

Acquisto e licenzeAcquistare una licenza Pro o Enterprise tramite il nostro Merchant of Record, quindi installare e attivare.

IntegrazioniLa mappa completa delle estensioni e la guida alla selezione.

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