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

Exporter les données de la base en PDF (facture, liste)

Cette leçon relie la base de données et la génération de PDF dans deux cas réels : une facture avec ses lignes, ses totaux HT, TVA et TTC, et une liste paginée d'inscrits. Elle insiste sur la séparati...

0 chapitres 0 QCM Accès gratuit
Exporter les données de la base en PDF (facture, liste)

À propos de ce cours

Cette leçon relie la base de données et la génération de PDF dans deux cas réels : une facture avec ses lignes, ses totaux HT, TVA et TTC, et une liste paginée d'inscrits. Elle insiste sur la séparation des responsabilités : le dépôt charge les données, les objets métier calculent les totaux, la classe PDF met en forme. Elle aborde aussi la numérotation des factures, l'archivage du PDF, son envoi par e-mail et le contrôle d'accès au document.

Objectifs de la leçon

  • Charger des données liées avec un dépôt.
  • Calculer les totaux dans les objets métier.
  • Générer une facture et une liste paginée en PDF.
  • Archiver et envoyer le document.
  • Contrôler l'accès aux documents.

1. Mise en situation

La boutique du TP du chapitre 29 doit maintenant éditer ses factures: numéro unique, client, lignes de produits, totaux HT, TVA et TTC. Le gérant veut aussi imprimer chaque semaine la liste des commandes à préparer.

Le piège serait de mélanger requêtes SQL, calculs et dessin du PDF dans un même script. Nous allons au contraire faire collaborer trois types d'objets, chacun avec sa responsabilité.

2. Charger les données

Trois responsabilités pour une facture

Trois responsabilités pour une facture

<?php
final class FactureRepository
{
    public function __construct(private PDO $pdo) {}

    public function trouver(string $numero): ?Facture
    {
        $s = $this->pdo->prepare('SELECT f.*, c.nom AS client_nom, c.adresse AS client_adresse
                                  FROM facture f JOIN client c ON c.id = f.client_id WHERE f.numero = ?');
        $s->execute([$numero]);
        $f = $s->fetch() ?: null;
        if ($f === null) { return null; }

        $l = $this->pdo->prepare('SELECT designation, quantite, prix_unitaire_ht, taux_tva FROM ligne_facture WHERE facture_id = ? ORDER BY id');
        $l->execute([$f['id']]);
        $facture = new Facture($f['numero'], new DateTimeImmutable($f['emise_le']), new Client($f['client_nom'], $f['client_adresse']));
        foreach ($l->fetchAll() as $ligne) {
            $facture->ajouterLigne($ligne['designation'], (int) $ligne['quantite'], (float) $ligne['prix_unitaire_ht'], (int) $ligne['taux_tva']);
        }
        return $facture;
    }
}

3. Les calculs dans l'objet métier

<?php
final class Facture
{
    /** @var list<LigneFacture> */
    private array $lignes = [];

    public function __construct(public readonly string $numero, public readonly DateTimeImmutable $emiseLe, public readonly Client $client) {}

    public function ajouterLigne(string $designation, int $qte, float $puHT, int $tva): void
    {
        $this->lignes[] = new LigneFacture($designation, $qte, $puHT, $tva);
    }

    public function lignes(): array { return $this->lignes; }
    public function totalHT(): float { return round(array_sum(array_map(fn($l) => $l->totalHT(), $this->lignes)), 3); }
    public function totalTVA(): float { return round(array_sum(array_map(fn($l) => $l->montantTVA(), $this->lignes)), 3); }
    public function totalTTC(): float { return round($this->totalHT() + $this->totalTVA(), 3); }

    /** @return array<int, float> base HT par taux de TVA, pour le récapitulatif */
    public function basesParTaux(): array
    {
        $bases = [];
        foreach ($this->lignes as $l) { $bases[$l->tva] = ($bases[$l->tva] ?? 0) + $l->totalHT(); }
        ksort($bases);
        return $bases;
    }
}

La classe PDF ne fait aucun calcul: elle affiche $facture->totalTTC(). Les mêmes totaux servent à l'écran, dans le PDF, dans l'export comptable et dans l'API : ils ne peuvent pas diverger.

4. Numérotation et archivage

  • Numéro unique et continu par année (F2026-0042), attribué dans une transaction pour éviter les doublons.
  • Une facture émise ne se modifie plus : on émet un avoir.
  • Le PDF est généré une fois puis archivé (var/factures/), pour pouvoir le renvoyer à l'identique.
  • Le téléchargement passe par un script qui vérifie que le client connecté est bien le destinataire.

5. Une liste paginée

Pour une liste longue (commandes à préparer, inscrits), FPDF gère le saut de page automatiquement avec SetAutoPageBreak(). Il suffit de redessiner la ligne d'en-têtes du tableau sur chaque nouvelle page, ce que l'on fait dans Header() quand une propriété $enTableau est vraie.

6. Mise en pratique : la classe FacturePdf

<?php
declare(strict_types=1);

final class FacturePdf extends DocumentCentre
{
    private const L = [90, 20, 30, 15, 25];         // largeurs des colonnes

    public function __construct(private Facture $facture)
    {
        parent::__construct('Facture ' . $facture->numero);
    }

    public function generer(): string
    {
        $this->AddPage();
        $this->blocClient();
        $this->tableauLignes();
        $this->totaux();
        return $this->Output('S');
    }

    private function blocClient(): void
    {
        $this->SetFont('Helvetica', '', 11);
        $this->Cell(0, 6, $this->t('Date : ' . $this->facture->emiseLe->format('d/m/Y')), 0, 1, 'R');
        $this->MultiCell(80, 6, $this->t($this->facture->client->nom . "\n" . $this->facture->client->adresse), 1);
        $this->Ln(8);
    }

    private function tableauLignes(): void
    {
        $this->SetFont('Helvetica', 'B', 10);
        $this->SetFillColor(232, 249, 253);
        foreach (['Désignation', 'Qté', 'P.U. HT', 'TVA', 'Total HT'] as $i => $t) {
            $this->Cell(self::L[$i], 8, $this->t($t), 1, 0, 'C', true);
        }
        $this->Ln();
        $this->SetFont('Helvetica', '', 10);
        foreach ($this->facture->lignes() as $l) {
            $this->Cell(self::L[0], 7, $this->t($l->designation), 1);
            $this->Cell(self::L[1], 7, (string) $l->quantite, 1, 0, 'R');
            $this->Cell(self::L[2], 7, $this->montant($l->prixUnitaireHT), 1, 0, 'R');
            $this->Cell(self::L[3], 7, $l->tva . ' %', 1, 0, 'R');
            $this->Cell(self::L[4], 7, $this->montant($l->totalHT()), 1, 1, 'R');
        }
    }

    private function totaux(): void
    {
        $this->Ln(4);
        foreach (['Total HT' => $this->facture->totalHT(), 'TVA' => $this->facture->totalTVA(), 'Total TTC' => $this->facture->totalTTC()] as $lib => $v) {
            $this->SetFont('Helvetica', $lib === 'Total TTC' ? 'B' : '', 11);
            $this->Cell(array_sum(self::L) - 35, 7, $this->t($lib), 0, 0, 'R');
            $this->Cell(35, 7, $this->montant($v) . ' DT', 1, 1, 'R');
        }
    }

    private function montant(float $v): string { return number_format($v, 3, ',', ' '); }
}

La classe FacturePdf

Diagramme de classe UML de FacturePdf

Exercice Activités
  1. Pourquoi les totaux sont-ils calculés dans Facture et non dans FacturePdf?
  2. Écrivez la classe LigneFacture (readonly) avec totalHT() et montantTVA().
  3. Pourquoi archiver le PDF d'une facture au lieu de le régénérer à chaque demande ?
  4. Comment éviter que deux factures reçoivent le même numéro ?
  5. Ajoutez à FacturePdf le récapitulatif des bases par taux de TVA.
  6. Quel contrôle faire avant d'envoyer le PDF d'une facture à l'utilisateur connecté ?
Correction
  1. Pour qu'ils soient calculés à un seul endroit et identiques à l'écran, dans le PDF, l'export comptable et l'API.
  2. final readonly class LigneFacture { public function __construct(public string $designation, public int $quantite, public float $prixUnitaireHT, public int $tva) {} public function totalHT(): float { return round($this->quantite * $this->prixUnitaireHT, 3); } public function montantTVA(): float { return round($this->totalHT() * $this->tva / 100, 3); } }
  3. Une facture est un document légal qui ne doit pas changer ; si un prix ou une adresse change en base, la régénération produirait un document différent.
  4. Attribuer le numéro dans une transaction avec un verrou (SELECT … FOR UPDATE sur un compteur par année), et une contrainte UNIQUE sur la colonne numero.
  5. foreach ($this->facture->basesParTaux() as $taux => $base) { $this->Cell(60, 6, $this->t("Base HT à $taux %"), 1); $this->Cell(35, 6, $this->montant($base), 1, 1, 'R'); }
  6. Vérifier qu'il est le client destinataire ou qu'il a un rôle de gestion ($autorisation->exiger('voir', $facture)) : sinon faille IDOR.

Résumé

  • Le dépôt charge la facture et ses lignes.
  • L'objet Facture calcule HT, TVA, TTC et bases par taux.
  • FacturePdf se limite à la mise en forme, en héritant du modèle commun.
  • Numéro unique, document archivé, jamais modifié.
  • Accès au PDF contrôlé comme toute ressource.

Cet article vous a-t-il aidé ?