Differences

This shows you the differences between two versions of the page.

--- doc:appunti:linux:sa:tcpdf [2020/01/08 11:43] – [L'estensione FPDI] niccolo
+++ doc:appunti:linux:sa:tcpdf [2024/09/25 09:58] (current) – [L'estensione FPDI] niccolo
@@ Line 1: / Line 1: @@
 ====== TCPDF su Debian 10 Buster ======
-Purtroppo il pacchetto **php-tcpdf** non è presente in **Debian 10 Buster**, per fortuna si puù installare la versione **6.3.2** da Debian Bullseye, scarcando il file da [[https://packages.debian.org/bullseye/php-tcpdf|Debian packages]].
+Purtroppo il pacchetto **php-tcpdf** non è presente in **Debian 10 Buster**, esiste però come **[[https://packages.debian.org/buster-backports/all/php-tcpdf/download|backport]]** oppure si dovrebbe poter installare la versione da Debian Bullseye, scarcando il file da [[https://packages.debian.org/bullseye/php-tcpdf|Debian packages]].
 <code>
@@ Line 18: / Line 18: @@
 ===== L'alternativa FPDF =====
-In alternativa a **php-tcpdf** esiste il pacchetto **[[https://packages.debian.org/buster/php-fpdf|php-fpdf]]** (home page [[http://www.fpdf.org/|www.fpdf.org]]). Si tratta di una libreria con minori funzionalità, ma più snella. È inclusa nelle ultime versioni di Debian, comresa l'auttuale stabile **10 Buster** e la futura **Bullseye**.
+In alternativa a **php-tcpdf** esiste il pacchetto **[[https://packages.debian.org/buster/php-fpdf|php-fpdf]]** (home page [[http://www.fpdf.org/|www.fpdf.org]]). Si tratta di una libreria con minori funzionalità, ma più snella. È inclusa nelle ultime versioni di Debian, compresa l'auttuale stabile **10 Buster** (che include **php-fpdf 1.8.1**), e la futura **Bullseye**.
 ===== L'estensione FPDI =====
-FPDI sta per **Free PDF Document Importer**, si tratta di una **estensione** che funziona sia con [[http://www.fpdf.org|FPDF]] che con [[https://github.com/tecnickcom/TCPDF|TCPDF]]. Consente di inlcudere un file PDF esistente ed utilizzarlo come **template** per creare altri documenti.
+**[[https://packagist.org/packages/setasign/fpdi|FPDI]]** sta per **Free PDF Document Importer**, si tratta di una **estensione** che funziona sia con [[http://www.fpdf.org|FPDF]] che con [[https://github.com/tecnickcom/TCPDF|TCPDF]]. Consente di inlcudere un file PDF esistente ed utilizzarlo come **template** per creare altri documenti.
-Al momento non esiste un pacchetto Debian della libreria. La home page del progetto è [[https://packagist.org/packages/setasign/fpdi]]. La libreria è scaricabile da **GitHub**, ad esempio la release 2.2.0 è scaricabile scegliendo il **[[https://github.com/Setasign/FPDI/tree/v2.2.0|Tag v2.2.0]]**.
+Debian includeva **libfpdi-php 1.4.1** fino alla versione **8 Jessie**, nella attuale versione 10 Buster purtroppo non c'è. La libreria è comunque scaricabile da **GitHub**, ad esempio la release 2.2.0 è scaricabile scegliendo il **[[https://github.com/Setasign/FPDI/tree/v2.2.0|Tag v2.2.0]]**.
-Per una installazione manuale si può scompattare l'archivio **FPDI-2.2.0.zip** in **/usr/local/share/php/** oppure anche nella directory stessa del progetto PHP. Quello che serve è la directory **src**, che può essere rinominata ad esempio in **fpdi220**. Per includerla si aggiunge al codice PHP:
+Per una installazione manuale si può scompattare l'archivio **FPDI-2.2.0.zip** in **/usr/local/share/php/** oppure anche nella directory stessa del progetto PHP. Quello che serve è la directory **src** contenuta nell'archivio ZIP, che può essere rinominata ad esempio in **fpdi-2.2.0** creando un link simbolico **fpdi**. Per includerla si aggiunge al codice PHP:
 <code php>
@@ Line 34: / Line 34: @@
 // use setasign\Fpdi\Tcpdf\Fpdi;
 // Include the FPDI extension, to import pages from existing PDF documents.
-require_once('/usr/local/share/php/fpdi220/autoload.php');
+require_once('/usr/local/share/php/fpdi/autoload.php');
 </code>
 Come si vede nell'esempio viene utilizzata la keyword **use** per definire quale //variante// di FPDI si vuole utilizzare: quella basata su FPDF oppure quella basata su TCPDF (in effetti sono supportate anche altre varianti).
-**ATTENZIONE**: La versione **FPDI 2.2.0** richiede **FPDF 1.8.2**. Con versioni più vecchie (ad esempio FPDF 1.7) si incappa nell'errore:
+**ATTENZIONE**: La versione **FPDI 2.2.0** richiede **FPDF 1.8**. Con versioni più vecchie (ad esempio FPDF 1.7) si incappa nell'errore:
 <code>
 PHP Fatal error:  Access level to setasign\Fpdi\FpdfTplTrait::_putimages()
   must be public (as in class FPDF) in /niccolo/fpdi/FpdfTpl.php on line 19
+</code>
+===== Installazione consigliata =====
+Ad oggi (giugno 2024) questo è lo stack di librerie consigiate:
+  * **TCPDF** dal pacchetto Debian **php-tcpdf** (versione **6.6.2** in Debian 12).
+  * **FPDI** installata localmente da archivio **FPDI-2.6.0.tgz** (scompattare la directory **src/** e rinominarla in **/usr/local/share/php/fpdi/**).
+Nel codice PHP si includono le librerie con le seguenti direttive:
+<code php>
+set_include_path(".:/usr/local/share/php:/usr/share/php");
+require_once('tcpdf/tcpdf.php');
+use setasign\Fpdi\Tcpdf\Fpdi;
+require_once('fpdi/autoload.php');
+</code>
+Per creare una pagina PDF con Fpdi:
+<code php>
+// TCPDI extends the TCPDF class:
+$pdf = new Fpdi($orientation='P', $unit='pt', $format='A4', $unicode=TRUE, $encoding='UTF-8', $diskcache=FALSE);
+// Add a page
+$pdf->AddPage();
+// Include a PNG picture.
+$pdf->Image('image.png', 80.0, 110.0, 60.0);
+// Include page 7 from an existing PDF document.
+$pdf->setSourceFile('document.pdf');
+$imported_page = $pdf->importPage(7, '/MediaBox');
+// Arguments: ($page, $x, $y, $size):
+$pdf->useTemplate($imported_page, 80, 510, 140);
+//Close and output PDF document
+$pdf->Output('save_as.pdf', 'I');
 </code>