يمكن أن تكون إدارة استيراد البيانات من ملفات Excel في كثير من الأحيان عملية مرهقة في تطبيقات PHP. سواء كنت تقوم بإنشاء نظام إدارة علاقات العملاء (CRM)، أو نظام جرد، أو أي تطبيق يعتمد على البيانات، فإن التعامل مع ملفات Excel ذات الهياكل والتنسيقات المختلفة يعد مطلبًا شائعًا. لتسهيل هذه العملية، أنا متحمس لتقديم ExcelMapper — مكتبة PHP مصممة لتبسيط تعيين بيانات Excel وتحليلها واستيرادها إلى تطبيقات PHP الخاصة بك.

في هذه المقالة، سأرشدك عبر الميزات الرئيسية لبرنامج 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 أداة قوية ومرنة لإدارة عمليات استيراد بيانات Excel في PHP. بفضل تعيينات الأعمدة القابلة للتخصيص والبنية القابلة للتوسيع، يمكنه التعامل مع مجموعة واسعة من حالات الاستخدام، بدءًا من استيراد البيانات البسيطة وحتى تحويلات البيانات المعقدة.

إذا كانت لديك أي أسئلة أو تعليقات أو مساهمات، فلا تتردد في فتح مشكلة أو سحب طلب على GitHub. لنجعل استيراد البيانات في PHP أسهل معًا!

جيت هاب