Excel ファイルからのデータ インポートの管理は、PHP アプリケーションでは面倒なプロセスになることがよくあります。 CRM、在庫システム、またはその他のデータ駆動型アプリケーションを構築している場合でも、さまざまな構造や形式の Excel ファイルを処理することは共通の要件です。このプロセスを容易にするために、ExcelMapper を導入できることを嬉しく思います。これは、Excel データのマッピング、解析、PHP アプリケーションへのインポートを簡素化するように設計された PHP ライブラリです。

この記事では、ExcelMapper の主な機能を説明し、ExcelMapper をインストールして構成する方法を示し、開始に役立ついくつかの実践的な例を示します。

インストール

ExcelMapper のインストールは Composer を使用すると簡単です。 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