À propos de ce cours
Objectifs de la leçon
- Installer FPDF avec Composer.
- Créer une page, choisir une police, écrire des cellules.
- Insérer une image et dessiner un tableau.
- Personnaliser en-tête et pied de page par héritage.
- Gérer les accents et les modes de sortie.
1. Mise en situation
Le centre de formation veut délivrer automatiquement une attestation d'inscription en PDF, avec le logo, le nom du stagiaire, la formation et un tableau des modules. Aujourd'hui, la secrétaire remplit un modèle Word à la main pour chaque stagiaire.
FPDF est une classe PHP qui dessine un PDF élément par élément. Son grand intérêt pédagogique : on la personnalise en en héritant et en redéfinissant ses méthodes Header() et Footer(), exactement comme dans le chapitre sur l'héritage.
2. Installation et premier PDF
Construire un PDF avec FPDF
composer require setasign/fpdf
<?php
require __DIR__ . '/vendor/autoload.php';
$pdf = new FPDF('P', 'mm', 'A4'); // portrait, millimètres, A4
$pdf->AddPage();
$pdf->SetFont('Helvetica', 'B', 16); // police, style (B, I, U), taille
$pdf->Cell(0, 10, 'Attestation d\'inscription', 0, 1, 'C'); // largeur 0 = toute la ligne
$pdf->SetFont('Helvetica', '', 12);
$pdf->Ln(5); // saut de ligne de 5 mm
$pdf->MultiCell(0, 7, 'Texte long qui revient automatiquement à la ligne lorsqu\'il atteint la marge droite de la page.');
$pdf->Output('I', 'attestation.pdf'); // I : affichage dans le navigateur
| Méthode | Rôle |
|---|---|
Cell(l, h, texte, bordure, ln, align, remplissage) | Une cellule sur une ligne |
MultiCell(l, h, texte) | Texte sur plusieurs lignes |
Image(fichier, x, y, l) | Image PNG, JPEG ou GIF |
SetFillColor, SetTextColor, SetDrawColor | Couleurs (RVB) |
Output(dest, nom) | I afficher, D télécharger, F fichier, S chaîne |
3. Les accents
<?php
// FPDF 1.8 avec les polices standard attend du Windows-1252 :
$pdf->Cell(0, 10, mb_convert_encoding('Développement Web et Mobile', 'Windows-1252', 'UTF-8'));
// Une petite méthode évite de le répéter partout (voir la classe ci-dessous)
Pour l'arabe ou d'autres alphabets, préférez tFPDF ou mPDF, qui gèrent l'UTF-8 et les polices TrueType, ou la conversion HTML de la leçon suivante.
4. Un tableau
<?php
$entetes = ['Module', 'Heures', 'Coef.'];
$largeurs = [110, 35, 35];
$pdf->SetFont('Helvetica', 'B', 11);
$pdf->SetFillColor(0, 216, 255);
foreach ($entetes as $i => $t) {
$pdf->Cell($largeurs[$i], 8, $t, 1, 0, 'C', true);
}
$pdf->Ln();
$pdf->SetFont('Helvetica', '', 11);
foreach ($modules as $m) {
$pdf->Cell($largeurs[0], 7, $m['intitule'], 1);
$pdf->Cell($largeurs[1], 7, (string) $m['heures'], 1, 0, 'R');
$pdf->Cell($largeurs[2], 7, (string) $m['coefficient'], 1, 1, 'R'); // ln = 1 : ligne suivante
}
5. Envoyer ou enregistrer
| Destination | Usage |
|---|---|
I | Afficher dans le navigateur |
D | Forcer le téléchargement |
F | Enregistrer sur le serveur (archives, pièce jointe d'e-mail) |
S | Récupérer le PDF dans une chaîne (envoi par e-mail, stockage en base) |
Aucun texte (ni espace, ni echo, ni avertissement PHP) ne doit être envoyé avant Output('I') ou Output('D'), sinon le PDF est corrompu.
6. Mise en pratique : une classe Attestation qui hérite de FPDF
<?php
declare(strict_types=1);
namespace App\Pdf;
use FPDF;
class DocumentCentre extends FPDF // modèle commun à tous les documents du centre
{
public function __construct(protected string $titreDocument)
{
parent::__construct('P', 'mm', 'A4');
$this->SetMargins(18, 18);
$this->SetAutoPageBreak(true, 22);
$this->AliasNbPages(); // {nb} = nombre total de pages
}
public function Header(): void // redéfinition : appelée par AddPage()
{
$this->Image(__DIR__ . '/../../public/img/logo.png', 18, 12, 28);
$this->SetFont('Helvetica', 'B', 14);
$this->Cell(0, 10, $this->t($this->titreDocument), 0, 1, 'R');
$this->SetDrawColor(0, 216, 255);
$this->Line(18, 30, 192, 30);
$this->Ln(12);
}
public function Footer(): void
{
$this->SetY(-15);
$this->SetFont('Helvetica', 'I', 8);
$this->Cell(0, 10, $this->t('Centre de formation — page ') . $this->PageNo() . '/{nb}', 0, 0, 'C');
}
protected function t(string $utf8): string
{
return mb_convert_encoding($utf8, 'Windows-1252', 'UTF-8');
}
}
final class Attestation extends DocumentCentre
{
public function __construct(private Etudiant $etudiant, private Formation $formation)
{
parent::__construct("Attestation d'inscription");
}
public function generer(): string
{
$this->AddPage();
$this->SetFont('Helvetica', '', 12);
$this->MultiCell(0, 8, $this->t(sprintf(
"Nous attestons que %s, matricule %s, est régulièrement inscrit(e) à la formation « %s » pour l'année %s.",
$this->etudiant->nomComplet(), $this->etudiant->matricule, $this->formation->intitule, date('Y')
)));
$this->Ln(20);
$this->Cell(0, 8, $this->t('Fait le ' . date('d/m/Y')), 0, 1, 'R');
return $this->Output('S'); // le PDF sous forme de chaîne
}
}
// Contrôleur
$pdf = (new Attestation($etudiant, $formation))->generer();
header('Content-Type: application/pdf');
header('Content-Disposition: inline; filename="attestation-' . $etudiant->matricule . '.pdf"');
echo $pdf;
Diagramme de classe UML de DocumentCentre
Header() et Footer() sont des méthodes crochets: FPDF les appelle automatiquement à chaque page, et vos classes filles les redéfinissent. Tous les documents du centre (attestation, relevé, facture) héritent du même en-tête.
Exercice Activités
- Que signifient les arguments de
Cell(0, 10, 'Titre', 0, 1, 'C')? - Quelle destination de
Output()choisir pour joindre le PDF à un e-mail ? - Pourquoi le PDF peut-il être corrompu si un espace précède
<?php? - Créez une classe
ReleveNotes extends DocumentCentrequi affiche un tableau module / note / coefficient. - Comment afficher « page 2/5 » dans le pied de page ?
- Pourquoi
Header()est-elle un bon exemple de polymorphisme ?
Correction
- Largeur 0 (jusqu'à la marge droite), hauteur 10 mm, texte, pas de bordure, passage à la ligne après la cellule, texte centré.
'S'(chaîne) ou'F'(fichier sur le serveur).- Cet espace est envoyé au navigateur avant le contenu du PDF, qui devient invalide (et les en-têtes ne peuvent plus être modifiés).
- Constructeur
parent::__construct('Relevé de notes'); méthodegenerer():AddPage(), ligne d'en-têtes avecCell(…, 1, 0, 'C', true), puis une ligne par note, enfin la moyenne en gras ;return $this->Output('S'); AliasNbPages()dans le constructeur et$this->PageNo() . '/{nb}'dansFooter().- FPDF appelle
$this->Header()dansAddPage(); c'est la version redéfinie par la classe fille qui s'exécute, sans que FPDF la connaisse.
Résumé
- FPDF dessine un PDF élément par élément :
AddPage,SetFont,Cell,MultiCell,Image. - Les accents demandent une conversion en Windows-1252 (ou tFPDF/mPDF).
Output(): I, D, F ou S.- On personnalise en héritant et en redéfinissant
Header()etFooter(). - Une classe mère commune donne un style unique à tous les documents.
Cet article vous a-t-il aidé ?
Merci pour votre avis sur cet article 🙏
Merci, votre message nous a bien été transmis 🙏
Cette leçon vous a été utile ? Partagez-la !