استيراد وتصدير ملفات إكسل، CSV، و ODS عبر مكتبة PHP مجانية
واجهة برمجة تطبيقات PHP مفتوحة المصدر تمكّن مطوري البرمجيات من استيراد وتصدير ملفات MS Excel. تعرّف على ميزاتها وفوائدها وأمثلة الشيفرة للتعامل مع مجموعات بيانات كبيرة بكفاءة.
ما هو Fast-Excel؟
Fast-Excel هي حزمة PHP خفيفة الوزن صُممت لتبسيط عمليات استيراد/تصدير Excel و CSV في تطبيقات Laravel. تم بناؤها على أساس OpenSpout، وتُركز على السرعة، واستهلاك الذاكرة المنخفض، وصياغة صديقة للمطورين. على عكس مكتبات الجداول الإلكترونية الأكبر حجماً، تُعد Fast-Excel مثالية للمشاريع التي تحتاج إلى معالجة جداول بسيطة وفعّالة دون تعقيد غير ضروري. تدعم تصدير واستيراد ملفات XLSX و CSV و ODS مع الحفاظ على استهلاك الذاكرة منخفضًا بشكل مفاجئ.
Fast-Excel مفيدة بشكل خاص للمطورين الذين يحتاجون إلى معالجة ملفات Excel أو CSV أو ODS الكبيرة دون مواجهة قيود الذاكرة. غالبًا ما تقوم المكتبات التقليدية بتحميل مجموعات البيانات بالكامل في الذاكرة، لكن Fast-Excel تستخدم تقنيات البث للتعامل مع البيانات بكفاءة. تُستخدم المكتبة على نطاق واسع لتصدير سجلات قاعدة البيانات إلى جداول البيانات، واستيراد بيانات المستخدم أو التقارير، وإنشاء تقارير كبيرة بشكل ديناميكي، وتبسيط التعامل مع Excel في تطبيقات Laravel وغيرها. بفضل واجهة برمجة التطبيقات النظيفة والتكوين القليل، تقلل Fast-Excel من وقت التطوير مع تحسين الأداء.
البدء مع Fast-Excel
الطريقة الموصى بها لتثبيت Fast-Excel في مشروعك هي باستخدام Composer. يرجى استخدام الأمر التالي لتثبيت سلس.
تثبيت Fast-Excel عبر Composer
composer require rap2hpoutre/fast-excelيمكنك أيضًا استنساخ المشروع باستخدام Git عن طريق تشغيل
تصدير المجموعات إلى ملفات Excel عبر PHP
Fast-Excel يجعل تصدير المجموعات أو النماذج إلى Excel بسيطًا للغاية. باستخدام بضع أسطر من الشيفرة فقط، يمكنك إنشاء ملفات .xlsx أو .csv أو .ods. هذه الميزة تلغي الحاجة إلى كتابة كود مكرر وتسرّع عملية التطوير، خاصةً للوحة التحكم أو أنظمة التقارير. المثال التالي يوضح كيفية تصدير البيانات إلى ملف MS Excel XLSX باستخدام كود PHP. المكتبة تحول مجموعة Laravel مباشرةً إلى ملف Excel دون الحاجة إلى إعدادات معقدة.
كيفية تصدير البيانات إلى ملف Excel XLSX عبر مكتبة PHP؟
use Rap2hpoutre\FastExcel\FastExcel;
// Sample data
$list = collect([
['id' => 1, 'name' => 'Jane'],
['id' => 2, 'name' => 'John'],
]);
// Export to Excel
(new FastExcel($list))->export('users.xlsx');
تصدير مقسّم موفر للذاكرة باستخدام المولدات
مكتبة Fast-Excel مفتوحة المصدر تتضمن دعمًا لاستخدام منخفض للذاكرة، وصياغة بسيطة لاستيراد أو تصدير البيانات. هذه هي الميزة الرائدة للتعامل مع "البيانات الضخمة". بدلاً من تحميل مليون مستخدم في مصفوفة، يمكنك استخدام cursor() في Laravel أو مولد yield مخصص. يقوم المصدّر بمعالجة كل صف على حدة، يكتبها في الملف، ثم يتخلص منها من الذاكرة. هذا يحافظ على استهلاك الذاكرة ثابتًا (منخفضًا جدًا) بغض النظر عما إذا كنت تصدر 100 صف أو 10 ملايين صف.
كيفية تصدير حقول محددة مع رؤوس مخصصة داخل تطبيقات PHP؟
return (new FastExcel(User::all()))->export('formatted_users.xlsx', function ($user) {
return [
'Full Name' => $user->firstname . ' ' . $user->lastname,
'Email Address' => $user->email,
'Member Since' => $user->created_at->format('Y-m-d'),
'Status' => $user->is_active ? 'Active' : 'Suspended'
];
});
استيراد البيانات مباشرةً إلى قاعدة البيانات
بدلاً من استيراد الصفوف يدويًا، يمكن لـ Fast-Excel معالجة كل صف وإدخاله مباشرةً إلى قاعدة البيانات الخاصة بك. هذا مثالي لتحميلات المسؤول الجماعية ويقدم فوائد كبيرة مثل الإدخال الجماعي للبيانات، كود أنظف، تقليل المعالجة اليدوية، سير عمل سهل للمسؤول، وما إلى ذلك. وهو مفيد بشكل خاص لأنظمة الموارد البشرية، أنظمة إدارة العلاقات مع العملاء، ومنصات التجارة الإلكترونية. إليك مثالًا مفيدًا يوضح كيفية استيراد البيانات إلى قاعدة بيانات داخل تطبيقات PHP.
كيفية استيراد البيانات مباشرةً إلى قاعدة بيانات عبر مكتبة PHP؟
use Rap2hpoutre\FastExcel\FastExcel;
use App\Models\User;
(new FastExcel)->import('users.xlsx', function ($line) {
return User::create([
'name' => $line['Name'],
'email' => $line['Email'],
]);
});
تخصيص تعيين الأعمدة والتنسيق عبر PHP
أعمدة قاعدة البيانات ليست دائمًا قابلة للقراءة من قبل البشر. لقد أدرجت مكتبة Fast-Excel دعمًا كاملاً لتعيين وتنسيق الأعمدة أو الصفوف المخصصة. تتيح لك هذه الميزة تحديد بالضبط أي السمات تريد تصديرها وإعادة تنسيق قيمها في الوقت الفعلي. سواء كنت بحاجة إلى تحويل اسم العائلة إلى أحرف كبيرة، أو دمج الاسم الأول والاسم الأخير، أو إعادة تسمية ‘user_id’ إلى ‘معرف الموظف’, فإن الدالة المغلقة تمنحك السيطرة الكاملة على مصفوفة الإخراج النهائية.
