[分享]ExcelMapper：简化 PHP 项目中的 Excel 数据导入

在 PHP 应用程序中，管理从 Excel 文件导入的数据通常是一个繁琐的过程。无论您是在构建 CRM、库存系统还是任何数据驱动的应用程序，处理各种结构和格式的 Excel 文件都是常见的要求。为了简化这一过程，我很高兴推出 ExcelMapper，这是一个 PHP 库，旨在简化 Excel 数据到您的 PHP 应用程序中的映射、解析和导入。

在本文中，我将向您介绍 ExcelMapper 的主要功能，向您展示如何安装和配置它，并提供一些实际示例来帮助您入门。

安装

使用 Composer 安装 ExcelMapper 非常简单。如果您尚未安装 Composer，可以在此处进行安装。安装 Composer 后，您可以在项目中要求使用 ExcelMapper：

composer require esmaeil/excelmapper

入门
让我们从创建一个基本示例开始，说明如何使用 ExcelMapper 从 Excel 文件导入数据。

第 1 步：准备 Excel 文件
想象一下，您有一个 Excel 文件customers.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 是一个强大而灵活的工具，用于管理 PHP 中的 Excel 数据导入。凭借其可定制的列映射和可扩展的架构，它可以处理从简单的数据导入到复杂的数据转换等各种用例。

如果您有任何问题、反馈或贡献，请随时在 GitHub 上提出问题或拉取请求。让我们一起让PHP中的数据导入更容易！