FAQ

• 1. Esattamente qual'è la licenza di FPDF? Ci sono limitazioni all'utilizzo?
• 2. Quando tento di creare un PDF, molti strani caratteri vengono visualizzati sullo schermo. Perché?
• 3. Quando provo a generare un PDF IE visualizza una pagina vuota. Che succede?
• 4. Non riesco a far funzionare le interruzioni di linea. Inserisco i \n nella stringa stampata da MultiCell ma non funziona.
• 5. Provo a visualizzare una variabile nel metodo Header, ma non viene stampato nulla.
• 6. Ho definito i metodi Header e Footer nella mia classe PDF ma non appare nulla.
• 7. I caratteri accentati vengono sostituiti da strani caratteri come é.
• 8. Tento di inserire il simbolo dell'Euro ma non funziona.
• 9. Quando tento di generare un PDF, ricevo il seguente messaggio di errore: "Some data has already been output, can't send PDF file".
• 10. Ho disegnato un frame di dimensioni molto precise, ma quando viene stampato noto alcune differenze.
• 11. Vorrei utilizzare l'intera superficie della pagina, ma quando stampo restano sempre alcuni margini. Come posso eliminarli?
• 12. Come posso impostare uno sfondo nel mio PDF?
• 13. Come posso impostare una specifica intestazione o un piede nella prima pagina?
• 14. Vorrei poter utilizzare estensioni rese disponibili tramite diversi script. Come posso combinarle?
• 15. Come posso inviare il PDF tramite email?
• 16. Qual'è il limite delle dimensioni dei file che posso generare con FPDF?
• 17. Posso modificare un PDF con FPDF?
• 18. Vorrei creare un motore di ricerca in PHP e indicizzare i file PDF. Posso farlo utilizzando FPDF?
• 19. Posso convertire una pagina HTML in PDF con FPDF?
• 20. Posso concatenare files PDF con FPDF?

• 1. Esattamente qual'è la licenza di FPDF? Ci sono limitazioni all'utilizzo?

  FPDF è rilasciata con licenza permissiva: non vi sono restrizioni di utilizzo. Puoi incorporarla liberamente nelle tue applicazioni (commerciali o meno), con o senza modifiche.

• 2. Quando tento di creare un PDF, molti strani caratteri vengono visualizzati sullo schermo. Perché?

  Questi "strani" caratteri sono appunto il contenuto del tuo PDF. Questo comportamento è un difetto di IE6. Quando esso riceve una pagina HTML, e successivamente un file PDF dallo stesso indirizzo, visualizza quest'ultimo direttamente, senza lanciare Acrobat. Questo accade frequentemente durante lo sviluppo: all'ultimo errore dello script viene inviata una pagina HTML e, dopo la correzione, arriva il PDF.
  Per risolvere il problema, semplicemente chiudi e riavvia IE. Oppure vai ad un altro indirizzo e poi torna indietro.
  Per evitare questo tipo di inconvenienti durante lo sviluppo, puoi generare il PDF direttamente come file, aprendolo poi da explorer.

• 3. Quando provo a generare un PDF IE visualizza una pagina vuota. Che succede?

  Anzitutto verifica di non aver inviato nulla al browser dopo il PDF (nemmeno uno spazio o un ritorno a capo). Puoi inserire la funzione exit() subito dopo la chiamata alla funzione Output() per essere sicuro. Se ancora non funziona, significa che sei una vittima della "sindrome della pagina vuota". IE utilizzata assieme al plug-in di Acrobat soffre di numerosi bugs. Per evitare questi problemi esistono due tecniche:
  
  - Disabilitare il plug-in ed usare Acrobat come applicazione di supporto. Per fare questo, lancia Acrobat; nel menu Edit, Preferences, Options, deseleziona l'opzione "Display PDF in Browser". La prossima volta che caricherai un PDF da IE, ti verrà mostrata la finestra di dialogo con le opzioni "Apri il file dal percorso corrente" e "Salva il file su disco". Deseleziona l'opzione "Avvisa sempre prima di aprire questo tipo di file" e seleziona Apri. D'ora in poi, i file PDF verranno automaticametne aperti in una finestra di Acrobat.
  Lo svantaggio di questo sistema è la necessità di alterare la configurazione del client, cosa fattibile in una rete privata, ma non su Internet.
  
  - Utilizzare una tecnica di reindirizzamento. Consiste nel generare il PDF in un file temporaneo sul server e reindirizzare il client a esso. Per esempio, alla fine dello script, puoi inserire quanto segue:

  //Determina il nome del file temporaneo nella directory corrente
  $file = basename(tempnam('.', 'tmp'));
  rename($file, $file.'.pdf');
  $file .= '.pdf';
  //Salva il PDF come file
  $pdf->Output($file, 'F');
  //Reindirizzamento
  header('Location: '.$file);

  Questo metodo converte il PDF dinamico in uno statico ed evita ogni problema. E' tuttavia necessario eliminare i file temporanei. Per esempio in questo modo:

  function CleanFiles($dir)
  {
      //Cancella i files temporanei
      $t = time();
      $h = opendir($dir);
      while($file = readdir($h))
      {
          if(substr($file,0,3)=='tmp' && substr($file,-4)=='.pdf')
          {
              $path = $dir.'/'.$file;
              if($t-filemtime($path)>3600)
                  @unlink($path);
          }
      }
      closedir($h);
  }

  Questa funzione cancella tutti i files il cui nome sia nel formato tmp*.pdf più vecchi di un'ora dalla directory specificata. Puoi chiamarla dove vuoi, ad esempio nello script che genera il PDF.

• 4. Non riesco a far funzionare le interruzioni di linea. Inserisco i \n nella stringa stampata da MultiCell ma non funziona.

  Devi chiudere la stringa tra virgolette, non tra apici singoli.

• 5. Provo a visualizzare una variabile nel metodo Header, ma non viene stampato nulla.

  Devi utilizzare la parola chiave global per accedere alle variabili globali, per esempio:

  function Header()
  {
      global $title;
  
      $this->SetFont('Arial', 'B', 15);
      $this->Cell(0, 10, $title, 1, 1, 'C');
  }

  In alternativa, puoi utilizzare una proprietà dell'oggetto:

  function Header()
  {
      $this->SetFont('Arial', 'B', 15);
      $this->Cell(0, 10, $this->title, 1, 1, 'C');
  }
  
  $pdf->title = 'My title';

• 6. Ho definito i metodi Header e Footer nella mia classe PDF ma non appare nulla.

  Devi creare un oggetto dalla classe PDF, non FPDF:

  $pdf = new PDF();

• 7. I caratteri accentati vengono sostituiti da strani caratteri come é.

  Non utilizzare la codifica UTF-8. I font standard FPDF utilizzano ISO-8859-1 o windows-1252. Vi è la possibilità di effettuare una conversione verso ISO-8859-1 tramite utf8_decode():

  $str = utf8_decode($str);

  Ma alcuni caratteri, come il simbolo di Euro, non possono essere convertiti correttamente. Se l'estensione iconv è disponibile, la via migliore è la seguente:

  $str = iconv('UTF-8', 'windows-1252', $str);

• 8. Tento di inserire il simbolo dell'Euro ma non funziona.

  I font standard hanno il simbolo dell'euro alla posizione 128. Puoi definire per convenienza una costante come questa:

  define('EURO', chr(128));

• 9. Quando tento di generare un PDF, ricevo il seguente messaggio di errore: "Some data has already been output, can't send PDF file".

  Non devi inviare al browser nient'altro che il solo PDF: non HTML, nessuno spazio o ritorno di carrello. Un caso comune consiste nell'avere uno spazio bianco indesiderato alla fine dello script di un file incluso.
  Se non riesci a determinare da dove possa derivare l'errore, il seguente altro messaggio di errore eventualmente apparso appena prima potrà aiutarti:
  
  Warning: Cannot modify header information - headers already sent by (output started at script.php:X).
  
  Ciò significa che lo script.php genera qualche output alla riga X. Vai a tale linea di codice e correggila. Nel caso in cui tale messaggio non appaia, prima controlla di non aver disabilitato i messaggi d'errore e poi aggiungi all'inizio del tuo script le seguenti linee:

  ob_end_clean();

  Se continui a non vederlo, disabilita zlib.output_compression nel tuo file php.ini e così dovrebbe apparire.

• 10. Ho disegnato un frame di dimensioni molto precise, ma quando viene stampato noto alcune differenze.

  Per rispettare le dimensioni, scegli "Nessuno" nel settaggio della scala di stampa al posto di "Restringi all'area di stampa" nel box di dialogo della stampa.

• 11. Vorrei utilizzare l'intera superficie della pagina, ma quando stampo restano sempre alcuni margini. Come posso eliminarli?

  Tutte le stampanti hanno dei margini fisici (diversi a seconda del modello), ed è quindi impossibile rimuoverli e stampare su tutta la superficie della carta.

• 12. Come posso impostare uno sfondo nel mio PDF?

  Per un'immagine, effettua una chiamata a Image() all'interno del metodo Header(), prima di ogni altro output. Per impostare un colore di sfondo usa Rect().

• 13. Come posso impostare una specifica intestazione o un piede nella prima pagina?

  Semplicemente, testa il numero di pagina:

  function Header()
  {
      if($this->PageNo()==1)
      {
          //First page
          ...
      }
      else
      {
          //Other pages
          ...
      }
  }

• 14. Vorrei poter utilizzare estensioni rese disponibili tramite diversi script. Come posso combinarle?

  Utilizza un'ereditarietà a catena. Se hai due classi, diciamo A in a.php:

  require('fpdf.php');
  
  class A extends FPDF
  {
  ...
  }

  e B in b.php:

  require('fpdf.php');
  
  class B extends FPDF
  {
  ...
  }

  poi, effettua B extend A:

  require('a.php');
  
  class B extends A
  {
  ...
  }

  e la tua classe extend B:

  require('b.php');
  
  class PDF extends B
  {
  ...
  }
  
  $pdf = new PDF();

• 15. Come posso inviare il PDF tramite email?

  Come ogni altro file, ma una via semplice è utilizzare PHPMailer e il suo sistema di allegati in-memory:

  $mail = new PHPMailer();
  ...
  $doc = $pdf->Output('', 'S');
  $mail->AddStringAttachment($doc, 'doc.pdf', 'base64', 'application/pdf');
  $mail->Send();

• 16. Qual'è il limite delle dimensioni dei file che posso generare con FPDF?

  Non c'è un limite particolare. Ci sono comunque alcune restrizioni:
  
  - La massima dimensione di memoria allocata per gli script PHP è impostata di default a 8 MB. Per documenti molto grandi, specialmetne con immagini, questo limite potrebbe essere raggiunto (il file viene generato nella memoria). Questo parametro è configurabile nel file php.ini.
  
  - Il tempo massimo di esecuzione è impostato di default a 30 secondi. Questo limite può naturalmente essere raggiunto con facilità. E' configurato nel file php.ini e può essere alterato dinamicamente con la funzione set_time_limit().
  
  - I browser hanno generalmente un timeout di 5 minuti. Se il PDF viene inviato direttamente al browser e il limite viene raggiunto, il file verrà perduto. E' quindi consigliabile generare i documenti di grandi dimensioni come files, e inviare i dati al browser poco a poco (per esempio, pagina 1, pagina 2... con la funzione flush() per forzare l'output). Quando il documento è completo, è possibile reindirizzare ad esso con JavaScript o creando un link.
  Nota bene: anche se il browser va in timeout, lo script continuerà a girare sul server.

• 17. Posso modificare un PDF con FPDF?

  Grazie all'estensione FPDI, è possibile importare pagine da un documento PDF preesistente:
  
  http://www.setasign.de/products/pdf-php-solutions/fpdi/
  
  Poi, puoi aggiungere ad esse altro contenuto.

• 18. Vorrei creare un motore di ricerca in PHP e indicizzare i file PDF. Posso farlo utilizzando FPDF?

  No, ma esiste una utility scritta in C e rilasciata sotto licenza GPL, pdftotext, che consente di estrarre il contenuto testuale da un PDF. E' fornita col il pacchetto Xpdf:
  
  http://www.foolabs.com/xpdf/

• 19. Posso convertire una pagina HTML in PDF con FPDF?

  Non pagine del "mondo reale". No, ma esiste una utility scritta in C e rilasciata sotto licenza GPL, htmldoc, che permette di farlo ottenendo buoni risultati:
  
  http://www.htmldoc.org

• 20. Posso concatenare files PDF con FPDF?

  Non direttamente, ma è possibile utilizzare FPDI per raggiungere tale obiettivo. Esistono anche alcuni tools liberi a linea di comando:
  
  mbtPdfAsm
  pdftk