Cookbook PHP

Questo indice raccoglie le recipe NextPDF native per PHP — pagine eseguibili, orientate alle attività, basate direttamente sull’API PHP del core. Il repository core nextpdf è responsabile di ogni recipe sotto docs/public/cookbook/php/ e la verifica. Ciascuna è supportata da uno script examples/*.php e da un harness di test tests/Cookbook/Php/. L’aggregatore importa poi ogni pagina in questo sito, mantenendone la provenienza originale.

Poiché questa pagina è un indice, non formula alcuna affermazione sul comportamento di alcuna recipe. Ogni riga riporta l’intento della recipe, il modulo core che esercita e il profilo di riproducibilità dichiarato. Il profilo e qualsiasi affermazione di conformità risiedono nella pagina della recipe stessa e derivano dal front-matter di quella pagina e dal suo test nel repository — non da questo indice. Per il cookbook delle integrazioni (framework / renderer / servizio), vedere Integration cookbook. Per il contratto che ogni recipe eseguibile rispetta, vedere Recipe conventions.

Come sono organizzati gli slug delle recipe

Ogni recipe è redatta nel repository core sotto docs/public/cookbook/php/ e pubblicata in questo sito dall’aggregatore. Lo slug segue una sola convenzione: un unico segmento.

/cookbook/php/<recipe>/

<recipe> indica l’intento della recipe in kebab-case (per esempio render-html-to-pdf, non il nome del modulo html). È in minuscolo, separato da trattini, privo di numeri di versione e termina con una sola barra finale.

Profilo di riproducibilità, in una riga

Ogni recipe dichiara il profilo più rigoroso che può soddisfare in modo veritiero:

• bitwise — byte-identico tra le esecuzioni (contenuto puramente deterministico, con tutta l’entropia fissata).
• structural — identico dopo aver normalizzato gli atomi volatili (il /ID del trailer, le date di creation/modification, i prefissi dei sottoinsiemi dei font — di fatto ogni PDF multi-oggetto).
• semantic — solo equivalenza dell’AST strutturale e dei metadati (output firmato o con marca temporale, oppure output per cui l’equivalenza non è intrinsecamente stabile a livello di byte).

Il profilo è una proprietà che la pagina della recipe dimostra con il proprio harness di test. Questo indice riporta solo il valore dichiarato dalla pagina.

Fondamenti

Costruire un documento, impaginarlo e applicargli uno stile.

Recipe	Cosa fa	Modulo	Profilo
render-html-to-pdf	Eseguire il rendering di un documento HTML in PDF	Html	structural
style-with-css	Applicare CSS a un rendering HTML	Html	structural
html-table-layout	Impaginare una tabella HTML	Html	structural
paginate-long-html	Impaginare un documento HTML lungo	Html	structural
paginate-large-html-tables	Impaginare una tabella HTML grande su più pagine	Html	structural
render-rtl-arabic-html	Eseguire il rendering di HTML arabo da destra a sinistra	Html	structural
compose-text-and-fonts	Comporre testo con controllo tipografico	Tipografia	structural
embed-and-subset-fonts	Incorporare i font e crearne sottoinsiemi	Font	structural
cjk-vertical-writing	Comporre testo CJK in modalità di scrittura verticale	Tipografia	structural
multi-page-document	Costruire un documento multipagina	Documento	structural
headers-and-footers	Aggiungere intestazioni e piè di pagina ricorrenti	Layout	structural

Grafica e contenuti

Vettori, immagini, livelli e spazio delle coordinate.

Recipe	Cosa fa	Modulo	Profilo
draw-vector-graphics	Disegnare grafica vettoriale	Grafica	structural
gradients-and-transparency	Applicare gradienti e trasparenza	Grafica	structural
embed-images	Incorporare immagini raster	Contenuti	structural
add-watermarks-and-backgrounds	Aggiungere filigrane o sfondi di testo e immagine alle pagine	Contenuti	structural
cmyk-spot-color-and-icc-profiles	Produrre CMYK e tinte piatte pronti per la stampa	Colore	structural
embed-file-attachments	Incorporare file e creare portfolio PDF	Contenuti	structural
optional-content-layers	Usare contenuti opzionali (livelli)	Grafica	structural
transform-coordinate-space	Trasformare lo spazio delle coordinate	Grafica	structural

Navigazione e moduli

Segnalibri, link, annotazioni e campi AcroForm.

Recipe	Cosa fa	Modulo	Profilo
bookmarks-and-toc	Costruire segnalibri e un indice dei contenuti	Navigazione	structural
generate-dynamic-table-of-contents	Generare un indice dei contenuti dinamico	Navigazione	structural
links-and-annotations	Aggiungere link e annotazioni	Navigazione	structural
generate-barcodes	Generare barcode	Barcode	bitwise
gs1-composite-barcodes	Generare barcode GS1 Composite (carrier CC-C)	Barcode	structural
fill-pdf-form	Compilare un AcroForm	Modulo	structural
flatten-form-fields	Appiattire i campi del modulo	Modulo	structural
form-field-validation-and-flatten-with-state	Validare i campi del modulo e appiattirli mantenendo lo stato	Modulo	structural

Informazioni del documento

Impostare i metadati e il comportamento del viewer.

Recipe	Cosa fa	Modulo	Profilo
set-document-metadata	Impostare i metadati del documento	Metadati	structural
set-viewer-preferences	Impostare le preferenze del viewer	Documento	structural

Operazioni sul documento

Assemblare, dividere e ottimizzare documenti esistenti.

Recipe	Cosa fa	Modulo	Profilo
merge-external-pdfs	Unire PDF esterni o accodare pagine	Documento	structural
split-and-extract-pages	Dividere un PDF ed estrarre intervalli di pagine	Documento	structural
optimize-pdf-file-size	Ridurre le dimensioni del file PDF con compressione e subsetting	Documento	structural

Sicurezza, firma e conformità

Cifratura, firma, accessibilità e output con profilo. Queste recipe riportano nella rispettiva pagina i confini supporto≠conformità e presenza≠validità.

Recipe	Cosa fa	Modulo	Profilo
encrypt-aes256	Cifrare con AES-256 e impostare i flag dei permessi	Sicurezza	structural
encrypt-with-permissions	Cifrare usando i flag dei permessi	Sicurezza	structural
sign-pades-b-b	Applicare una firma PAdES (B-B e B-T)	Sicurezza	semantic
inspect-existing-signature	Ispezionare una firma esistente	Ispezione	semantic
tagged-pdf-ua2	Emettere struttura taggata per PDF/UA-2	Accessibilità	semantic
accessible-pdfua2-from-html	Emettere la struttura taggata per la redazione accessibile in PDF/UA-2 da HTML	Accessibilità	semantic
pdf-a-4-output	Produrre output PDF/A-4	Conformità	semantic
pdfa4-conformance-gate	Produrre output PDF/A-4 e applicare un gate con un validatore esterno	Conformità	semantic
validate-conformance	Validare rispetto a un profilo di conformità	Compliance	semantic

Ispezione ed estrazione

Rileggere contenuto e struttura di un PDF.

Recipe	Cosa fa	Modulo	Profilo
extract-text-content	Estrarre contenuto testuale	Testo	semantic
multilingual-copy-paste-extraction	Rendere i PDF CJK e arabi corretti al copia-incolla	Testo	structural
parse-and-inspect-pdf	Analizzare e ispezionare un PDF	Ispezione	semantic
inspect-layout-boxes	Ispezionare i box di layout	Ispezione	semantic

Trasversali

Pattern comuni a più moduli.

Recipe	Cosa fa	Attraversa	Profilo
worker-safe-batch-rendering	Eseguire il rendering in sicurezza in un worker a esecuzione prolungata (registri condivisi, memoria limitata)	Core · Performance · Support	semantic
streaming-and-memory	Profilare streaming e uso della memoria	Performance	bitwise
exception-aware-error-handling	Gestire gli errori con la gerarchia delle eccezioni NextPDF	Exception · Contracts	structural
custom-error-recovery-patterns	Implementare strategie personalizzate di ripristino dagli errori e di retry	Exception	semantic
observe-with-opentelemetry	Osservare il rendering con OpenTelemetry	Observability · Telemetry · Event	semantic

Ogni recipe qui sopra è pubblicata con uno script examples/*.php di supporto e un harness di test tests/Cookbook/Php/ nel repository core. Quando una nuova recipe viene redatta upstream, compare qui non appena il suo esempio e il suo test vengono integrati.

Vedere anche

• Integration cookbook — l’indice delle integrazioni con framework, renderer e servizi.
• Recipe conventions — il contratto che ogni recipe eseguibile in questo cookbook rispetta.