ExcelMapper: واردات داده های اکسل را در پروژه های PHP خود ساده کنید

Summarize this content to 400 words in Persian Lang
مدیریت واردات داده ها از فایل های اکسل اغلب می تواند یک فرآیند دست و پا گیر در برنامه های PHP باشد. چه در حال ساخت یک CRM، یک سیستم موجودی یا هر برنامه مبتنی بر داده باشید، مدیریت فایل‌های اکسل با ساختارها و فرمت‌های مختلف یک نیاز رایج است. برای سهولت این روند، من هیجان زده هستم که معرفی کنم ExcelMapper— یک کتابخانه PHP که برای ساده سازی نقشه برداری، تجزیه و وارد کردن داده های Excel به برنامه های PHP شما طراحی شده است.

در این مقاله، ویژگی‌های کلیدی ExcelMapper را به شما آموزش می‌دهم، نحوه نصب و پیکربندی آن را به شما نشان می‌دهم و چند مثال عملی برای کمک به شما در شروع کار ارائه می‌دهم.

نصب و راه اندازی

نصب ExcelMapper با استفاده از Composer ساده است. اگر قبلاً Composer را نصب نکرده‌اید، می‌توانید این کار را در اینجا انجام دهید. پس از نصب Composer، می توانید ExcelMapper را در پروژه خود نیاز داشته باشید:

composer require esmaeil/excelmapper

وارد حالت تمام صفحه شوید

از حالت تمام صفحه خارج شوید

شروع به کاربیایید با ایجاد یک مثال اساسی از نحوه استفاده از ExcelMapper برای وارد کردن داده ها از یک فایل اکسل شروع کنیم.

مرحله 1: فایل اکسل خود را آماده کنیدتصور کنید که یک فایل 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: نگاشت ستون را تعریف کنیدسپس، نحوه ترسیم و تجزیه هر ستون در فایل اکسل را مشخص کنید:

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);
});

وارد حالت تمام صفحه شوید

از حالت تمام صفحه خارج شوید

گسترش ExcelMapperExcelMapper به گونه ای طراحی شده است که قابل توسعه باشد. شما به راحتی می توانید تجزیه کننده ها و خوانندگان خود را اضافه کنید یا موارد موجود را مطابق با نیازهای خاص خود تغییر دهید. به عنوان مثال، ممکن است یک خواننده سفارشی برای فایل‌های CSV ایجاد کنید یا کلاس ExcelDataProcessor را برای اضافه کردن مراحل پردازش اضافی گسترش دهید.

نتیجه گیریExcelMapper یک ابزار قدرتمند و انعطاف پذیر برای مدیریت واردات داده های اکسل در PHP است. با نگاشت ستون های قابل تنظیم و معماری قابل توسعه، می تواند طیف گسترده ای از موارد استفاده، از واردات ساده داده تا تبدیل داده های پیچیده را انجام دهد.

اگر سؤال، بازخورد یا مشارکتی دارید، می‌توانید یک مشکل را باز کنید یا در GitHub درخواست کنید. بیایید با هم وارد کردن داده ها در PHP را آسان تر کنیم!

GitHub

composer require esmaeil/excelmapper

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

namespace ExcelMapper\Parsers;

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

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

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

// 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);
});