Управление импортом данных из файлов Excel часто может быть трудоемким процессом в приложениях PHP. Независимо от того, создаете ли вы CRM, систему инвентаризации или любое другое приложение, управляемое данными, обработка файлов Excel различных структур и форматов является общим требованием. Чтобы облегчить этот процесс, я рад представить ExcelMapper — библиотеку PHP, предназначенную для упрощения сопоставления, анализа и импорта данных Excel в ваши приложения PHP.

В этой статье я расскажу вам об основных функциях ExcelMapper, покажу, как его установить и настроить, а также приведу несколько практических примеров, которые помогут вам начать работу.

Установка

Установить ExcelMapper с помощью Composer очень просто. Если вы еще не установили Composer, вы можете сделать это здесь. После установки Composer вы можете использовать ExcelMapper в своем проекте:

composer require esmaeil/excelmapper

Начиная
Давайте начнем с создания простого примера использования ExcelMapper для импорта данных из файла Excel.

Шаг 1. Подготовьте файл Excel
Представьте, что у вас есть файл Excel customer.xlsx со следующей структурой:

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

Шаг 2. Создайте собственный анализатор (необязательно)
ExcelMapper поставляется с DefaultParser, который просто возвращает значение ячейки. Однако вам может потребоваться создать собственные анализаторы для обработки более сложной логики, например форматирования телефонных номеров или разделения полных имен.

Вот пример специального синтаксического анализатора, который преобразует персидские/арабские цифры в английские цифры:

namespace ExcelMapper\Parsers;

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

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

Шаг 3. Определите сопоставления столбцов
Затем определите, как каждый столбец в вашем файле Excel должен отображаться и анализироваться:

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

Пример использования 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
ExcelMapper спроектирован так, чтобы его можно было расширять. Вы можете легко добавить свои собственные парсеры и читатели или изменить существующие в соответствии с вашими конкретными потребностями. Например, вы можете создать собственное средство чтения для файлов CSV или расширить класс ExcelDataProcessor, добавив дополнительные этапы обработки.

Заключение
ExcelMapper — мощный и гибкий инструмент для управления импортом данных Excel в PHP. Благодаря настраиваемым сопоставлениям столбцов и расширяемой архитектуре он может обрабатывать широкий спектр вариантов использования: от простого импорта данных до сложных преобразований данных.

Если у вас есть какие-либо вопросы, отзывы или предложения, не стесняйтесь открыть проблему или запрос на включение на GitHub. Давайте вместе упростим импорт данных в PHP!

GitHub