Programmazione.it :: Usare documenti PDF in PHP grazie a Zend

Usare documenti PDF in PHP grazie a Zend_Pdf (1/2)

Scritto da Cosmos Puglisi il 13-09-2007 ore 11:18

L’obiettivo di Zend_Pdf, come suggerisce già il nome, è quello di creare e manipolare documenti PDF. Un articolo apparso sul sito Zend Developer Zone dà una overview del componente. Per poter usare Zend_Pdf nella propria applicazione, ovviamente bisogna prima caricarlo. Per fare ciò basta eseguire il comando seguente:

<span style="font-size:1.0em">
require_once('Zend/Pdf.php');
</span>

Per creare o caricare un nuovo documento invece si possono usare i seguenti metodi:

<span style="font-size:1.0em">
//primo metodo
$pdf = new Zend_Pdf();
 
//secondo metodo
$fileName = '/path/to/your/file.pdf'; 
$pdf = new Zend_Pdf($fileName); 
</span>

Ma esiste anche una terza modalità per caricare un documento PDF, utilizzando la funzione di parsing di una stringa:

<span style="font-size:1.0em">
$pdf = Zend_Pdf::parse($pdfString);
</span>

Una delle prime operazioni che si possono effettuare su un’istanza PDF aperta è quella di manipolare le pagine. Questo si fa usando la property pages dell’istanza Zend_Pdf, la quale è un array di tipo Zend_Pdf_page. Così per aggiungere una pagina nuova si può scegliere tra le due opzioni:

<span style="font-size:1.0em">
$pdf->pages[] = new Zend_Pdf_Page(Zend_Pdf_Page::SIZE_A4); 
//oppure
$pdf->pages[] = $pdf->newPage(Zend_Pdf_Page::SIZE_A4);
</span>

Entrambi i metodi creano una pagina nuova ed entrambi necessitano di un formato valido, tra i quali: Zend_Pdf_Page::SIZE_A4; Zend_Pdf_Page::SIZE_A4_LANDSCAPE; Zend_Pdf_Page::SIZE_LETTER; Zend_Pdf_Page::SIZE_LETTER_LANDSCAPE.

Anche per salvare una pagina PDF ci sono due metodi: Zend_Pdf::save($filename, $updateOnly = false) e Zend_Pdf::render($newSegmentOnly = false). Nel metodo save() si deve specificare il nome del file, dove salvarlo e opzionalmente se fare solo un overwrite del file o un update a patto che il secondo parametro sia rispettivamente false o true. Il metodo render(), oltre al flag e a salvare il documento, ritorna anche il PDF in formato stringa.

Pubblicazioni correlate:
14-09-2007 Usare documenti PDF in PHP grazie a Zend_Pdf (2/2)