在 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 中的数据导入变得更容易！

GitHub