À propos de ce cours
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
<?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, ',', ' '); }
}
Diagramme de classe UML de FacturePdf
Exercice Activités
- Pourquoi les totaux sont-ils calculés dans
Factureet non dansFacturePdf? - Écrivez la classe
LigneFacture(readonly) avectotalHT()etmontantTVA(). - Pourquoi archiver le PDF d'une facture au lieu de le régénérer à chaque demande ?
- Comment éviter que deux factures reçoivent le même numéro ?
- Ajoutez à
FacturePdfle récapitulatif des bases par taux de TVA. - Quel contrôle faire avant d'envoyer le PDF d'une facture à l'utilisateur connecté ?
Correction
- Pour qu'ils soient calculés à un seul endroit et identiques à l'écran, dans le PDF, l'export comptable et l'API.
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); } }- 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.
- Attribuer le numéro dans une transaction avec un verrou (
SELECT … FOR UPDATEsur un compteur par année), et une contrainte UNIQUE sur la colonnenumero. 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'); }- 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
Facturecalcule HT, TVA, TTC et bases par taux. FacturePdfse 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é ?
Merci pour votre avis sur cet article 🙏
Merci, votre message nous a bien été transmis 🙏
Cette leçon vous a été utile ? Partagez-la !