Guide
In breve
Sezione intitolata “In breve”Le guide spiegano come collegare NextPDF all’ambiente in cui il codice viene eseguito. Questa sezione si apre con la checklist per le operazioni in produzione, quindi copre cinque aree nell’ordine tipico di adozione: integrazioni con framework e renderer, server NextPDF Connect, SDK Python, creazione di estensioni del motore e risoluzione dei problemi. Ogni area parte dal proprio hub e poi elenca le pagine consultate più spesso.
Per ricette orientate alle attività e pronte da copiare, consultare il Cookbook. Per la superficie API verificata e le matrici di supporto delle Application Programming Interface (API), consultare i Riferimenti.
Integrazioni
Sezione intitolata “Integrazioni”Otto pacchetti collegano il motore di base a framework, renderer browser, servizi edge, strumenti di build e percorsi di migrazione da sistemi legacy. Ogni sezione dedicata a un pacchetto segue la stessa struttura del manuale — panoramica, installazione, guida rapida, configurazione, API, guida per gli sviluppatori, utilizzo in produzione, sicurezza e risoluzione dei problemi — in modo che, dopo averne consultata una, le altre risultino familiari.
| Pagina | Da usare per |
|---|---|
| Integrazioni | Mappa delle estensioni e guida alla scelta. Da leggere per prima per scegliere il pacchetto corretto. |
| Indice delle API per le integrazioni | Individuare la pagina delle API di estensione che copre ogni superficie di framework, renderer, trasporto e strumento di build. |
| NextPDF per Laravel | L’adattatore per il framework Laravel. |
| NextPDF per Symfony | L’adattatore per il framework Symfony. |
| NextPDF per CodeIgniter | L’adattatore per il framework CodeIgniter. |
| NextPDF Artisan | Il bridge verso il renderer Chrome per il rendering HTML a livello browser. |
| NextPDF Cloudflare | Il percorso di distribuzione all’edge su Cloudflare. |
| NextPDF Gotenberg | Il bridge per il renderer Gotenberg. |
| Compatibilità con TCPDF | Lo shim di compatibilità per codebase che migrano da TCPDF. |
| NextPDF Backport Builder | Lo strumento di build destinato a runtime PHP meno recenti. |
NextPDF Connect
Sezione intitolata “NextPDF Connect”Il pacchetto nextpdf/server esegue il motore come servizio a esecuzione prolungata: offre un unico registro deterministico di strumenti, esposto tramite Model Context Protocol (MCP), Representational State Transfer (REST) e gRPC, con un gate di conferma a intervento umano per gli strumenti ad alto rischio.
| Pagina | Da usare per |
|---|---|
| NextPDF Connect | L’hub della sezione: concetti, configurazione e gestione operativa del server. |
| Panoramica di Connect | L’ambito del pacchetto e i tre trasporti. |
| Guida rapida a Connect | Un primo handshake MCP eseguibile e la richiesta di rendering REST corrispondente. |
| Configurazione di Connect | Il file YAML di MCP e le variabili d’ambiente NEXTPDF_*. |
| Riferimento API di Connect | Ogni strumento registrato, simbolo gRPC, voce del modello di errore e limite di frequenza. |
| Distribuzione di Connect | Profili per worker RoadRunner, Docker e store basati su Redis. |
| Sicurezza e operazioni di Connect | Autenticazione, sicurezza del trasporto e modello delle minacce. |
Ogni trasporto ha la propria pagina di riferimento.
| Pagina | Da usare per |
|---|---|
| Trasporto MCP | Framing JSON-RPC 2.0 su standard input e standard output. |
| Trasporto REST | Il contratto OpenAPI 3.1, l’autenticazione bearer e le rotte soggette a restrizioni in base al piano. |
| Trasporto gRPC | Il servizio nextpdf.connect.v1, lo streaming lato server e l’autenticazione tramite metadati. |
SDK Python
Sezione intitolata “SDK Python”Estrazione da PDF pronta per citazioni, destinata ad applicazioni Python, agenti e riga di comando, con il supporto di un endpoint NextPDF Connect.
| Pagina | Da usare per |
|---|---|
| SDK Python | L’hub della sezione per il pacchetto Python nextpdf. |
| Panoramica dell’SDK Python | Cosa fa l’SDK e come si integra con Connect. |
| Guida rapida all’SDK Python | Installare con pip install nextpdf e configurare un client per il proprio server. |
| Riferimento API dell’SDK Python | Le classi client, i metodi e i risultati tipizzati. |
| CLI Python | L’interfaccia a riga di comando per i flussi di lavoro di estrazione. |
| Server MCP Python | Esporre l’SDK agli agenti che usano MCP. |
Estendere il motore
Sezione intitolata “Estendere il motore”La Service Provider Interface (SPI) pubblica consente di aggiungere funzionalità senza creare un fork: contratti per font, motori di layout, listener di eventi e back end di firma, ciascuno con una garanzia di stabilità esplicita.
| Pagina | Da usare per |
|---|---|
| Creazione di estensioni | Cosa è possibile estendere e la garanzia di stabilità su cui si basa. |
| Regole di stabilità per la SPI | Il contratto di retrocompatibilità su cui può fare affidamento la propria estensione. |
| Font personalizzati: il contratto FontRegistry | Registrare e distribuire i propri font. |
| Motori di impaginazione personalizzati e intercettazione del testo | Sostituire o intercettare il comportamento del layout. |
| Trigger di azione e listener di eventi | Osservare e reagire al ciclo di vita del documento. |
| Contratto del provider KMS | Fornire chiavi dal proprio Key Management Service (KMS). |
Risoluzione dei problemi
Sezione intitolata “Risoluzione dei problemi”Voci organizzate dal sintomo alla risoluzione, basate sulla tassonomia delle eccezioni del motore. Partire da ciò che si osserva, non dal nome di una classe.
| Pagina | Da usare per |
|---|---|
| Risoluzione dei problemi | L’hub della knowledge base: struttura delle voci e punto di partenza. |
| Risoluzione dei problemi: font e tagging | Errori di incorporamento dei font e di tagging della struttura. |
| Risoluzione dei problemi: cifratura e permessi | Errori di cifratura, password e permessi. |
| Risoluzione dei problemi: memoria e prestazioni | Limiti di memoria e problemi di throughput. |
| Risoluzione dei problemi: convalida PDF/A e PDF/UA | Errori di convalida per l’archiviazione e l’accessibilità. |
| Risoluzione dei problemi: firme e marche temporali | Errori di convalida di firme e marche temporali. |
Vedere anche
Sezione intitolata “Vedere anche”- Cookbook — ricette orientate alle attività per PHP, Connect e integrazioni.
- Riferimenti — superficie API verificata, matrici di supporto e riferimento degli errori.
- Migrare a NextPDF — come migrare da un’altra libreria PDF, nella sezione Per iniziare.
- NextPDF visto dall’interno — gli approfondimenti Insider_ sul perché il motore si comporta così.