Excel 파일에서 데이터 가져오기를 관리하는 것은 PHP 애플리케이션에서 종종 번거로운 프로세스일 수 있습니다. CRM, 재고 시스템 또는 데이터 기반 애플리케이션을 구축하는 경우 다양한 구조와 형식의 Excel 파일을 처리하는 것이 일반적인 요구 사항입니다. 이 프로세스를 쉽게 하기 위해 Excel 데이터를 PHP 애플리케이션으로 매핑, 구문 분석 및 가져오기를 단순화하도록 설계된 PHP 라이브러리인 ExcelMapper를 소개하게 되어 기쁘게 생각합니다.

이 문서에서는 ExcelMapper의 주요 기능을 안내하고, 설치 및 구성 방법을 보여주고, 시작하는 데 도움이 되는 몇 가지 실용적인 예를 제공합니다.

설치

Composer를 사용하면 ExcelMapper를 쉽게 설치할 수 있습니다. 아직 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는 PHP에서 Excel 데이터 가져오기를 관리하기 위한 강력하고 유연한 도구입니다. 사용자 정의 가능한 열 매핑과 확장 가능한 아키텍처를 통해 간단한 데이터 가져오기부터 복잡한 데이터 변환까지 광범위한 사용 사례를 처리할 수 있습니다.

질문, 피드백 또는 기여가 있는 경우 언제든지 GitHub에서 이슈를 열거나 요청을 가져오세요. PHP에서 데이터 가져오기를 더 쉽게 만들어 보겠습니다!

GitHub