Die Verwaltung von Datenimporten aus Excel-Dateien kann in PHP-Anwendungen oft ein umständlicher Prozess sein. Unabhängig davon, ob Sie ein CRM, ein Inventarsystem oder eine andere datengesteuerte Anwendung erstellen, ist der Umgang mit Excel-Dateien mit unterschiedlichen Strukturen und Formaten eine häufige Anforderung. Um diesen Prozess zu vereinfachen, freue ich mich, Ihnen ExcelMapper vorzustellen – eine PHP-Bibliothek, die das Zuordnen, Parsen und Importieren von Excel-Daten in Ihre PHP-Anwendungen vereinfacht.

In diesem Artikel führe ich Sie durch die wichtigsten Funktionen von ExcelMapper, zeige Ihnen, wie Sie es installieren und konfigurieren, und stelle einige praktische Beispiele zur Verfügung, die Ihnen den Einstieg erleichtern.

Installation

Die Installation von ExcelMapper ist mit Composer unkompliziert. Wenn Sie Composer noch nicht installiert haben, können Sie dies hier tun. Sobald Composer installiert ist, können Sie ExcelMapper in Ihrem Projekt anfordern:

composer require esmaeil/excelmapper

Erste Schritte
Beginnen wir mit der Erstellung eines einfachen Beispiels für die Verwendung von ExcelMapper zum Importieren von Daten aus einer Excel-Datei.

Schritt 1: Bereiten Sie Ihre Excel-Datei vor
Stellen Sie sich vor, Sie haben eine Excel-Datei „customers.xlsx“ mit folgender Struktur:

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

Schritt 2: Erstellen Sie einen benutzerdefinierten Parser (optional)
ExcelMapper verfügt über einen DefaultParser, der einfach den Zellenwert zurückgibt. Möglicherweise möchten Sie jedoch benutzerdefinierte Parser erstellen, um komplexere Logik zu verarbeiten, z. B. das Formatieren von Telefonnummern oder das Aufteilen vollständiger Namen.

Hier ist ein Beispiel für einen benutzerdefinierten Parser, der persische/arabische Ziffern in englische Ziffern umwandelt:

namespace ExcelMapper\Parsers;

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

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

Schritt 3: Spaltenzuordnungen definieren
Als nächstes definieren Sie, wie jede Spalte in Ihrer Excel-Datei zugeordnet und analysiert werden soll:

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
];

Beispielverwendung von 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);
});

ExcelMapper erweitern
ExcelMapper ist erweiterbar konzipiert. Sie können ganz einfach Ihre eigenen Parser und Reader hinzufügen oder die vorhandenen an Ihre spezifischen Anforderungen anpassen. Sie können beispielsweise einen benutzerdefinierten Reader für CSV-Dateien erstellen oder die ExcelDataProcessor-Klasse erweitern, um zusätzliche Verarbeitungsschritte hinzuzufügen.

Abschluss
ExcelMapper ist ein leistungsstarkes und flexibles Tool zur Verwaltung von Excel-Datenimporten in PHP. Mit seinen anpassbaren Spaltenzuordnungen und der erweiterbaren Architektur kann es ein breites Spektrum an Anwendungsfällen bewältigen, von einfachen Datenimporten bis hin zu komplexen Datentransformationen.

Wenn Sie Fragen, Feedback oder Beiträge haben, können Sie gerne ein Issue oder eine Pull-Anfrage auf GitHub eröffnen. Lassen Sie uns gemeinsam den Datenimport in PHP einfacher machen!

GitHub