Avez-vous une question? (216) 97 656 803 hajjriadh@gmail.com
Les cours de programmation

Générer un PDF avec la classe FPDF

Cette leçon montre comment produire des documents PDF avec FPDF, une bibliothèque PHP légère entièrement orientée objet. Elle présente l'installation avec Composer, la création d'une page, les polices...

0 chapitres 0 QCM Accès gratuit
Générer un PDF avec la classe FPDF

À propos de ce cours

Cette leçon montre comment produire des documents PDF avec FPDF, une bibliothèque PHP légère entièrement orientée objet. Elle présente l'installation avec Composer, la création d'une page, les polices, les cellules simples et multilignes, les images et les tableaux, puis la personnalisation de l'en-tête et du pied de page par héritage de la classe FPDF. Elle traite la question des accents et des différentes sorties : affichage, téléchargement ou enregistrement sur le serveur.

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

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éthodeRô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, SetDrawColorCouleurs (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

DestinationUsage
IAfficher dans le navigateur
DForcer le téléchargement
FEnregistrer sur le serveur (archives, pièce jointe d'e-mail)
SRé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;

Une hiérarchie de documents 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
  1. Que signifient les arguments de Cell(0, 10, 'Titre', 0, 1, 'C')?
  2. Quelle destination de Output() choisir pour joindre le PDF à un e-mail ?
  3. Pourquoi le PDF peut-il être corrompu si un espace précède <?php?
  4. Créez une classe ReleveNotes extends DocumentCentre qui affiche un tableau module / note / coefficient.
  5. Comment afficher « page 2/5 » dans le pied de page ?
  6. Pourquoi Header() est-elle un bon exemple de polymorphisme ?
Correction
  1. Largeur 0 (jusqu'à la marge droite), hauteur 10 mm, texte, pas de bordure, passage à la ligne après la cellule, texte centré.
  2. 'S' (chaîne) ou 'F' (fichier sur le serveur).
  3. 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).
  4. Constructeur parent::__construct('Relevé de notes'); méthode generer(): AddPage(), ligne d'en-têtes avec Cell(…, 1, 0, 'C', true), puis une ligne par note, enfin la moyenne en gras ; return $this->Output('S');
  5. AliasNbPages() dans le constructeur et $this->PageNo() . '/{nb}' dans Footer().
  6. FPDF appelle $this->Header() dans AddPage(); 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() et Footer().
  • Une classe mère commune donne un style unique à tous les documents.

Cet article vous a-t-il aidé ?