Cookbook

Panoramica

Questo cookbook è organizzato per attività. Ogni ricetta risolve un singolo problema con un esempio copiabile, basato sul codice sorgente. Le ricette sono suddivise in tre famiglie, raggruppate in base al punto in cui viene eseguito il lavoro. Scegliere la famiglia corrispondente alla modalità con cui si chiama NextPDF, quindi selezionare una ricetta al suo interno.

Per capire perché il motore si comporta in un determinato modo, leggere invece le Guide. Per consultare la superficie API verificata, leggere il Riferimento.

Un esempio, un runtime

Ogni ricetta è destinata a un solo runtime. Le ricette PHP chiamano il motore principale nello stesso processo. Le ricette Connect chiamano gli strumenti tramite un trasporto. Le ricette di integrazione collegano NextPDF a un framework o a un backend di rendering. Prima di adattare un esempio, leggere la pagina delle convenzioni corrispondente.

Ricette PHP

Le ricette PHP usano direttamente il motore principale, nello stesso processo. Ciascuna parte da un’installazione composer require nextpdf/core, quindi crea, firma, ispeziona o converte documenti tramite l’API pubblica, ad esempio Document::createStandalone() e writeHtml().

Ricette PHP La mappa di ogni ricetta PHP nativa: eseguire il rendering di HTML in PDF, impaginare tabelle, incorporare e creare subset di font, cifrare con AES-256, firmare con PAdES, generare PDF/A-4 e PDF/UA-2 con tag, estrarre testo e ispezionare file esistenti.

Ricette Connect

Le ricette Connect chiamano NextPDF tramite il registro degli strumenti del server su Model Context Protocol (MCP), Representational State Transfer (REST) o gRPC. La stessa chiamata allo strumento funziona con tutti e tre i trasporti e resta soggetta al gate di conferma con intervento umano.

Ricette Connect Ricette indipendenti dal trasporto per il server NextPDF Connect: hello world, tabelle HTML, incorporamento di immagini, firme digitali, controlli di accessibilità e conformità, redazione, analisi forense e osservabilità con OpenTelemetry.

Ricette di integrazione

Le ricette di integrazione collegano NextPDF a un framework applicativo oppure delegano il rendering a un backend esterno. Coprono gli adapter dei framework e i bridge dei renderer, oltre al percorso di migrazione da una libreria legacy.

Ricette di integrazione Ricette per i pacchetti dell'ecosistema: scegliere un'integrazione, restituire un PDF da un controller di framework, accodare la generazione in un processo in background, eseguire il rendering di HTML con Artisan, convertire file Office con Gotenberg, eseguire il rendering all'edge con Cloudflare e seguire il percorso di migrazione TCPDF.

Convenzioni delle ricette

Ogni ricetta segue un contratto documentato: esempi basati sul codice sorgente, front-matter con profilo di riproducibilità, un confine di conformità trasparente e il gate di pubblicazione. Prima di adattare un esempio, leggere la pagina delle convenzioni della famiglia con cui si lavora.

Convenzioni delle ricette di integrazione Il contratto seguito da ogni ricetta di integrazione eseguibile: esempi basati sul codice sorgente, front-matter con profilo di riproducibilità e il gate di pubblicazione.

Convenzioni delle ricette Connect Il contratto seguito da ogni ricetta Connect: chiamate agli strumenti indipendenti dal trasporto, strumenti condizionati al tier, il modello di rischio e il gate di conferma, e il confine di conformità trasparente.

Vedere anche

• Guide — la mappa della documentazione concettuale e procedurale.
• Riferimento — la superficie API verificata e la matrice di supporto CSS.
• Scegliere un’integrazione — una matrice decisionale dal caso d’uso all’integrazione.