La gestion des importations de données à partir de fichiers Excel peut souvent être un processus fastidieux dans les applications PHP. Que vous construisiez un CRM, un système d'inventaire ou toute autre application basée sur les données, la gestion de fichiers Excel avec différentes structures et formats est une exigence courante. Pour faciliter ce processus, je suis ravi de vous présenter ExcelMapper, une bibliothèque PHP conçue pour simplifier le mappage, l'analyse et l'importation de données Excel dans vos applications PHP.

Dans cet article, je vais vous présenter les principales fonctionnalités d'ExcelMapper, vous montrer comment l'installer et le configurer, et vous fournir quelques exemples pratiques pour vous aider à démarrer.

Installation

L'installation d'ExcelMapper est simple à l'aide de Composer. Si vous n'avez pas encore installé Composer, vous pouvez le faire ici. Une fois Composer installé, vous pouvez exiger ExcelMapper dans votre projet :

composer require esmaeil/excelmapper

Commencer
Commençons par créer un exemple de base montrant comment utiliser ExcelMapper pour importer des données à partir d'un fichier Excel.

Étape 1 : Préparez votre fichier Excel
Imaginez que vous ayez un fichier Excel clients.xlsx avec la structure suivante :

| First Name | Last Name | Phone Number |
|------------|-----------|--------------|
| John       | Doe       | ۱۲۳۴۵۶۷۸۹۰   |
| Jane       | Smith     | 9876543210   |

Étape 2 : Créer un analyseur personnalisé (facultatif)
ExcelMapper est livré avec un DefaultParser qui renvoie simplement la valeur de la cellule. Cependant, vous souhaiterez peut-être créer des analyseurs personnalisés pour gérer une logique plus complexe, telle que le formatage des numéros de téléphone ou la division des noms complets.

Voici un exemple d'analyseur personnalisé qui convertit les chiffres persans/arabes en chiffres anglais :

namespace ExcelMapper\Parsers;

use ExcelMapper\Interfaces\ColumnParserInterface;
use ExcelMapper\Utils\DataHelper;

class DigitConversionParser implements ColumnParserInterface
{
    public function parse($value)
    {
        return DataHelper::convertDigits($value);
    }
}

Étape 3 : Définir les mappages de colonnes
Ensuite, définissez comment chaque colonne de votre fichier Excel doit être mappée et analysée :

use ExcelMapper\DataProcessor\ExcelDataProcessor;
use ExcelMapper\Readers\ExcelReader;
use ExcelMapper\Parsers\DefaultParser;
use ExcelMapper\Parsers\DigitConversionParser;

// Define custom column mapping
$mapping = [
    ['first_name', DefaultParser::class],
    ['last_name', DefaultParser::class],
    ['phone_number', DigitConversionParser::class], // Convert digits to English
];

Exemple d'utilisation d'ExcelMapper

// Read Excel file
$reader = new ExcelReader();
$sheetData = $reader->read('path_to_file.xlsx');

// Process the data
$processor = new ExcelDataProcessor();
$processor->process($sheetData, $mapping, function($mappedData) {
    // Handle the mapped data (e.g., save to database)
    print_r($mappedData);
});

Extension d'ExcelMapper
ExcelMapper est conçu pour être extensible. Vous pouvez facilement ajouter vos propres analyseurs et lecteurs ou modifier ceux existants en fonction de vos besoins spécifiques. Par exemple, vous pouvez créer un lecteur personnalisé pour les fichiers CSV ou étendre la classe ExcelDataProcessor pour ajouter des étapes de traitement supplémentaires.

Conclusion
ExcelMapper est un outil puissant et flexible pour gérer les importations de données Excel en PHP. Grâce à ses mappages de colonnes personnalisables et à son architecture extensible, il peut gérer un large éventail de cas d'utilisation, depuis les simples importations de données jusqu'aux transformations de données complexes.

Si vous avez des questions, des commentaires ou des contributions, n'hésitez pas à ouvrir un problème ou une pull request sur GitHub. Ensemble, facilitons l'importation de données en PHP !

GitHub