À propos de ce cours
Objectifs de la leçon
- Installer et utiliser Html2Pdf ou Dompdf.
- Écrire un gabarit HTML adapté au PDF.
- Gérer en-têtes, pieds de page, polices et images.
- Choisir entre FPDF et une conversion HTML.
- Séparer données, gabarit et moteur de conversion.
1. Mise en situation
Le relevé de notes doit reprendre la charte graphique du site : couleurs, logo, tableau avec des lignes alternées, badges de mention. Avec FPDF, chaque bordure et chaque couleur se programment à la main. Le développeur front-end de l'équipe, lui, sait déjà faire tout cela en HTML et CSS.
Les bibliothèques de conversion HTML vers PDF permettent de réutiliser ce savoir-faire : on génère une page HTML avec les données, puis on la convertit en PDF.
2. Installation et premier document
FPDF ou conversion HTML ?
composer require spipu/html2pdf # Html2Pdf
composer require dompdf/dompdf # ou Dompdf
<?php
use Spipu\Html2Pdf\Html2Pdf;
$html2pdf = new Html2Pdf('P', 'A4', 'fr', true, 'UTF-8', [15, 15, 15, 15]);
$html2pdf->writeHTML('<h1 style="color:#00a3c4">Relevé de notes</h1><p>Stagiaire : Sara Ben Ali</p>');
$html2pdf->output('releve.pdf'); // affichage ; 'D' pour télécharger, 'F' pour un fichier
// Avec Dompdf
use Dompdf\Dompdf;
$dompdf = new Dompdf(['defaultFont' => 'DejaVu Sans']); // police couvrant les accents
$dompdf->loadHtml($html, 'UTF-8');
$dompdf->setPaper('A4', 'portrait');
$dompdf->render();
$dompdf->stream('releve.pdf', ['Attachment' => false]);
3. Un gabarit adapté au PDF
<!-- templates/pdf/releve.php -->
<style>
body { font-family: 'DejaVu Sans', sans-serif; font-size: 11pt; color: #1d3557; }
h1 { color: #00a3c4; border-bottom: 2px solid #00d8ff; }
table { width: 100%; border-collapse: collapse; }
th { background: #00d8ff; color: #fff; padding: 6px; }
td { border: 1px solid #ccc; padding: 5px; }
tr:nth-child(even) td { background: #e8f9fd; }
.mention { font-weight: bold; color: #2a9d8f; }
</style>
<h1>Relevé de notes — <?= $e($bulletin->etudiant->nomComplet()) ?></h1>
<table>
<tr><th>Module</th><th>Coef.</th><th>Note</th></tr>
<?php foreach ($bulletin->lignes() as $l): ?>
<tr><td><?= $e($l->module->intitule) ?></td><td><?= $l->module->coefficient ?></td><td><?= number_format($l->note->valeur, 2, ',', '') ?></td></tr>
<?php endforeach; ?>
</table>
<p>Moyenne : <strong><?= number_format($bulletin->moyenne(), 2, ',', '') ?></strong> — <span class="mention"><?= $bulletin->mention()->value ?></span></p>
- CSS 2.1 bien supporté ; flexbox et grid peu ou pas : utilisez des tableaux pour la mise en page.
- Images par chemin absolu sur le serveur, ou encodées en base64.
- Unités physiques (mm, pt) pour une mise en page fiable.
- Le saut de page se force avec
page-break-before: always.
4. En-têtes et pieds de page
<!-- Html2Pdf : balise page propre à la bibliothèque -->
<page backtop="25mm" backbottom="15mm">
<page_header><img src="<?= $logo ?>" style="width:30mm"> Centre de formation</page_header>
<page_footer>Page [[page_cu]]/[[page_nb]]</page_footer>
… contenu …
</page>
5. Quel outil choisir ?
| Besoin | Outil conseillé |
|---|---|
| Document simple, très rapide, positions exactes | FPDF |
| Mise en page riche, charte graphique | Dompdf ou Html2Pdf |
| Arabe, écriture de droite à gauche | mPDF |
| Rendu identique au navigateur (CSS moderne) | Navigateur sans interface (Chrome headless, Gotenberg) |
6. Prévisualiser avant de convertir
<?php
// Mode développement : afficher le HTML au lieu du PDF pour régler la mise en page dans le navigateur
$html = $vue->rendre('pdf/releve', ['bulletin' => $bulletin]);
if (($_GET['apercu'] ?? '') === 'html' && $_ENV['APP_ENV'] === 'dev') {
echo $html;
exit;
}
echo $convertisseur->convertir($html);
Régler la mise en page directement dans le navigateur (outils de développement) est beaucoup plus rapide que de régénérer le PDF à chaque essai. Gardez à l'esprit que le moteur PDF supporte moins de CSS que le navigateur : vérifiez le rendu final.
7. Vers la POO : un service de génération indépendant du moteur
Le choix de la bibliothèque est un détail technique qui peut changer. On le cache derrière une interface : le reste de l'application demande « un PDF à partir de ce gabarit et de ces données », sans savoir quel moteur est utilisé.
Diagramme de classe UML de GenerateurDocuments
<?php
declare(strict_types=1);
namespace App\Pdf;
interface ConvertisseurPdf
{
public function convertir(string $html): string; // renvoie le contenu binaire du PDF
}
final class DompdfConvertisseur implements ConvertisseurPdf
{
public function convertir(string $html): string
{
$d = new \Dompdf\Dompdf(['defaultFont' => 'DejaVu Sans', 'isRemoteEnabled' => false]);
$d->loadHtml($html, 'UTF-8');
$d->setPaper('A4');
$d->render();
return $d->output();
}
}
final class Html2PdfConvertisseur implements ConvertisseurPdf
{
public function convertir(string $html): string
{
$p = new \Spipu\Html2Pdf\Html2Pdf('P', 'A4', 'fr', true, 'UTF-8');
$p->writeHTML($html);
return $p->output('', 'S');
}
}
final class GenerateurDocuments
{
public function __construct(private Vue $vue, private ConvertisseurPdf $convertisseur) {}
public function pdf(string $gabarit, array $donnees): string
{
return $this->convertisseur->convertir($this->vue->rendre('pdf/' . $gabarit, $donnees));
}
}
$generateur = new GenerateurDocuments($vue, new DompdfConvertisseur());
$pdf = $generateur->pdf('releve', ['bulletin' => $bulletin]);
Changer de moteur se fait en une ligne. On peut même tester GenerateurDocuments avec un faux convertisseur qui renvoie le HTML, et vérifier que le nom du stagiaire figure bien dans le document.
Exercice Activités
- Citez deux avantages et un inconvénient de la conversion HTML par rapport à FPDF.
- Pourquoi choisir la police DejaVu Sans avec Dompdf ?
- Comment forcer un saut de page avant chaque bulletin dans un PDF qui en contient plusieurs ?
- Pourquoi désactiver
isRemoteEnableddans Dompdf ? - Écrivez un faux convertisseur pour les tests.
- Générez un PDF de la liste des inscrits d'une formation avec
GenerateurDocuments.
Correction
- Avantages : mise en forme en CSS, réutilisation des gabarits et compétences web. Inconvénient : plus lent, CSS moderne mal supporté.
- Les polices PDF de base ne couvrent que l'alphabet latin restreint ; DejaVu Sans contient les accents et de nombreux autres caractères.
<div style="page-break-before: always">autour de chaque bulletin (sauf le premier).- Pour empêcher le chargement de ressources distantes indiquées dans le HTML (risque SSRF et lenteur).
final class FauxConvertisseur implements ConvertisseurPdf { public function convertir(string $html): string { return $html; } }puisassert(str_contains($g->pdf('releve', $d), 'Sara'));- Créer
templates/pdf/inscrits.php(tableau échappé), puis$pdf = $g->pdf('inscrits', ['formation' => $f, 'inscrits' => $depot->inscrits($f)]);et l'envoyer avec les en-têtes PDF.
Résumé
- Html2Pdf et Dompdf convertissent un gabarit HTML/CSS en PDF.
- CSS 2.1, tableaux, unités physiques et polices UTF-8 adaptées.
- En-têtes, pieds de page et sauts de page se gèrent dans le gabarit.
- FPDF pour la précision, HTML pour la mise en forme.
- Une interface
ConvertisseurPdfrend le moteur interchangeable.
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 !