Important : ExcelExport nécessite ma classe LoaderTool.

En premier lieu, choisissez la version d'ExcelExport qui vous convient le mieux :

• ExcelExport.class.php pour Symfony : utilise les fonctionnalités de formatage de date de Symfony, et les informations de culture de l'utilisateur.
• ExcelExport.class.php pour PHP 5 sans Symfony.
• ExcelExport.class.php pour PHP 4.

Exemple d'utilisation

Mettons que vous ayez un tableau PHP de cette forme :

$contenu = array(
    array('id' => 1,
          'title' => 'Mon item n°1',
          'description' => 'Un item exemple',
          'created_at' => time(),
         ),
    array('id' => 2,
          'title' => 'Mon item n°2',
          'description' => 'Un item exemple',
          'created_at' => time(),
         ),
  );

Et que vous souhaitiez l'exporter au format Excel. En premier lieu, définissez les colonnes de votre export Excel. Ici, nous allons définir les colonnes suivantes :

• N° : Valeur numérique, obtenue à partir de la colonne 'id'.
• Nom : Valeur chaîne de caractères, obtenue à partir de la colonne 'title'.
• Créé le : Valeur date, obtenue à partir de la colonne 'created_at'.

Pour décrire un tel export Excel, utilisez :

$columns = array(
    'id' => array('title' => 'N°', 'type' => ExcelExport::NUMBER),
    'title' => array('title' => 'Nom', 'type' => ExcelExport::STRING),
    'created_at' => array('title' => 'Créé le', 'type' => ExcelExport::DATE),
  );

Remarque : notez que je n'ai pas décrit la colonne 'description' : elle sera ignorée dans l'export.

Remarque 2 : Si vous utilisez PHP 4, les constantes deviennent : ExcelExport__NUMBER, ExcelExport__STRING, ExcelExport__DATE.

Créez un nouvel export Excel contenant ces colonnes :

$excel_export = new ExcelExport($columns);

Remarque : Il est possible de forcer la langue cible de l'export Excel. Par défaut, il s'agit de la langue de l'utilisateur si vous utilisez Symfony, sinon, il s'agit de l'anglais (Seule 2 cultures sont supportées : 'fr', et 'en'). Pour forcer la langue, utilisez :

$excel_export = new ExcelExport($columns, 'fr');

Ou :

$excel_export->setCulture('fr');

Enfin, ajoutez votre contenu à l'export. L'ajout peut se faire ligne par ligne, ou comme dans notre cas, plusieurs lignes simultanéement :

$excel_export->addContent($contenu);

Une fois que l'export Excel contient tout sont contenu, vous pouvez le proposer au téléchargement de l'utilisateur (cette méthode utilise ma classe LoaderTool) :

$excel_export->download('mon-fichier-excel.xls');

$excel_contents = $excel_export->getExcelContents();