Exemple minimal
Voici pour commencer l'exemple classique :
<?php
require('fpdf.php');
$pdf=new FPDF();
$pdf->AddPage();
$pdf->SetFont('Arial','B',16);
$pdf->Cell(40,10,'Hello World !');
$pdf->Output();
?>
[Démo]
Après avoir inclus la librairie, un object FPDF est créé.
Le constructeur FPDF() est utilisé ici avec les valeurs par défaut : les pages sont en
portrait A4 et l'unité de mesure est le millimètre. On aurait pu l'indiquer explicitement par :
$pdf=new FPDF('P','mm','A4');
Il est possible de passer en paysage (L
), d'utiliser d'autres formats de page (comme
A3
et A5
) ainsi que d'autres unités de mesure (pt
,
cm
, in
).
Il n'y a pour l'instant encore aucune page, c'est pourquoi il faut en ajouter une avec
AddPage(). L'origine est en haut à gauche et la position courante est placée par défaut
à 1 cm des bords ; on peut changer ces marges par SetMargins().
Avant d'imprimer du texte, il est impératif de définir la police avec SetFont(), sinon
le document serait invalide. On choisit de l'Arial gras en taille 16 :
$pdf->SetFont('Arial','B',16);
On aurait pu spécifier de l'italique avec I
, du souligné avec U
ou une
police normale avec une chaîne vide (ou bien encore une combinaison de styles). A noter que la
taille de la police est ici donnée en points, pas en millimètres (ou autre unité choisie) ; c'est
la seule exception. Les autres polices standard disponibles sont Times, Courier, Symbol et
ZapfDingbats.
On imprime ensuite une cellule grâce à Cell(). Une cellule est une zone rectangulaire,
éventuellement encadrée, qui contient une ligne de texte. Elle est imprimée à la position
courante. On spécifie ses dimensions, le texte (centré ou aligné), si des bords doivent être
tracés, et si la position courante doit être déplacée à droite, en dessous ou bien doit
retourner au début de la ligne suivante. On aurait par exemple encadré le texte comme ceci :
$pdf->Cell(40,10,'Hello World !',1);
Si on veut ajouter une nouvelle cellule à droite avec du texte centré et retourner à la ligne,
on fait :
$pdf->Cell(60,10,'Powered by FPDF.',0,1,'C');
Remarque : le retour à la ligne peut également s'effectuer grâce à la méthode Ln(). Cette
dernière permet de préciser en plus la hauteur du saut de ligne.
Enfin, le document est terminé et envoyé au navigateur grâce à Output(). On aurait pu
le sauvegarder directement dans un fichier en passant le nom souhaité.
Attention : dans le cas où le PDF est envoyé au navigateur, le script ne doit
rien envoyer d'autre, ni avant ni après (pas d'HTML, même pas un espace ni un retour-chariot).
Si vous envoyez quelque chose avant, vous obtiendrez le message : "Some data has already been
output, can't send PDF file". Si vous envoyez quelque chose après, il se peut que le document
ne s'affiche pas.