Converti PHP in PDF

È necessaria una copia a layout fisso quando una pagina generata da PHP deve essere stampata, inviata, condivisa o archiviata. Il codice sorgente PHP deve essere eseguito per produrre la pagina oppure formattato come codice; un normale convertitore di file non lo rende direttamente in un PDF finito.

Che cos'è il formato PHP

PHP è un linguaggio di scripting lato server utilizzato da sviluppatori web e amministratori per generare pagine dinamiche, moduli, fatture, report e risposte API. Un file .php contiene codice sorgente, generalmente combinato con HTML, CSS, SQL o markup di template; PHP è un linguaggio di programmazione, non un formato di documento.

Un web server compatibile con PHP interpreta il file e restituisce l'output generato, normalmente HTML, a un browser. L'apertura di un file .php da un file manager non esegue il relativo codice lato server: può visualizzare il testo sorgente o non riuscire a caricarlo, a seconda del sistema operativo e dell'applicazione.

Che cos'è il formato PDF

PDF è un formato di documento a layout fisso che mantiene dimensioni delle pagine, caratteri, immagini, spaziatura e numerazione delle pagine invariati tra sistemi operativi e dispositivi. I destinatari possono stamparlo o visualizzarlo senza PHP, un web server o l'applicazione che ha creato la pagina originale.

PDF è adatto per fatture, invii ufficiali, allegati email e copie d'archivio. Normalmente non è concepito per essere modificato come un file di elaborazione testi e la conversione non garantisce un file di dimensioni inferiori; i caratteri e le immagini incorporati possono aumentarne le dimensioni.

Convertire la pagina PHP generata

Utilizzare questo metodo quando il PDF richiesto è un report, una ricevuta, un modulo o un'altra pagina prodotta dallo script.

1. Installare PHP e, se necessario, un pacchetto server locale come XAMPP, Laragon o MAMP. Il server integrato di PHP è sufficiente per molti progetti autonomi.
2. Collocare il progetto nella relativa directory dei documenti e configurare i database richiesti, le variabili d'ambiente, le estensioni, i file inclusi e le cartelle con permessi di scrittura.
3. Dalla directory appropriata del progetto o della document root, eseguire php -S localhost:8000. Il comando avvia un server di sviluppo; non si tratta di una distribuzione in produzione.
4. Aprire l'indirizzo pertinente, ad esempio http://localhost:8000/report.php, in Chrome, Edge o Firefox e verificare che la pagina contenga i dati previsti.
5. Utilizzare Print → Save as PDF nel browser. Selezionare il formato carta e i margini richiesti, attivare la grafica di sfondo quando il design la utilizza e controllare interruzioni di pagina, immagini, intestazioni e piè di pagina nell'anteprima di stampa.

Per un output lato server ripetibile, utilizzare un workflow headless Chromium con Playwright o Puppeteer e la relativa funzione PDF. Fornire lo stesso CSS di stampa, viewport, formato carta, margini e condizioni di caricamento della pagina utilizzati in produzione; attendere le richieste di rete e i contenuti renderizzati da JavaScript prima di generare il PDF.

Se la pagina è già disponibile in HTML, servizi online affidabili come PDFCrowd o CloudConvert possono fornire la conversione da HTML a PDF. Caricare l'HTML generato invece del file .php originale: generalmente questi servizi non eseguono PHP arbitrario e i fogli di stile esterni, i caratteri, le immagini, le sessioni e i dati autenticati potrebbero non essere disponibili.

Convertire il codice sorgente PHP

Utilizzare questo metodo quando il codice sorgente stesso costituisce il documento, ad esempio per una revisione del codice, materiale di formazione o una copia cartacea.

1. Aprire il file in un editor di codice come PhpStorm, Notepad++ o Visual Studio Code e attivare l'evidenziazione della sintassi PHP.
2. Impostare un carattere monospaziato leggibile, margini adeguati, ritorno a capo automatico e numeri di riga opzionali. Disattivare il ritorno a capo se preservare le righe esatte del codice è più importante che adattare il codice alla pagina.
3. Stampare da un editor che supporta la stampa, come Notepad++ o PhpStorm, e scegliere una stampante PDF di sistema: Microsoft Print to PDF su Windows o Save as PDF nella finestra di dialogo di stampa di macOS. Visual Studio Code potrebbe richiedere un'estensione per la stampa o un'esportazione HTML intermedia.

Per PDF del codice sorgente generati automaticamente, applicare l'evidenziazione della sintassi con Pygments o un formattatore simile, esportare il risultato come HTML e stampare tale HTML tramite Chromium. Questo documenta il testo sorgente; non esegue PHP né acquisisce la pagina generata dallo script.

Generare PDF all'interno di un'applicazione PHP

Per fatture, report o moduli ricorrenti, un'applicazione PHP può creare PDF da template con librerie come Dompdf, mPDF o TCPDF. Si tratta di generazione di PDF, non di conversione di file, e richiede codice, installazione delle dipendenze, preparazione dei template e verifica del supporto CSS.

Limitazioni relative a qualità e sicurezza

L'autenticazione, i risultati dei database, le estensioni PHP mancanti, i permessi, i percorsi relativi, i CSS esterni, i web font, JavaScript e il CSS di stampa del browser possono modificare il risultato renderizzato. Eseguire test con dati rappresentativi, verificare immagini e interruzioni di pagina e confrontare il PDF con la pagina all'URL previsto.

Non caricare codice sorgente PHP riservato, credenziali, dati dei clienti o pagine generate private in un convertitore online. Un browser locale, un processo Chromium headless o una libreria PHP per PDF evita di esporre tali file e consente l'accesso alle dipendenze locali. Rimuovere i segreti dai PDF del codice sorgente e verificare che i PDF generati non contengano metadati indesiderati o dati nascosti dei moduli.