عندما نعمل على تطبيق لارافيل Laravel، قد نحتاج لتكرار مهام معينة مثل إنشاء ملفات أو تنفيذ أوامر خاصة بالتطبيق. وبدلاً من أن نكتب كل هذه الأوامر يدويًا في كل مرة، يمكننا أتمتة المهام المتكررة باستخدام أداة سطر الأوامر سهلة الاستخدام PHP Artisan المدمجة مع إطار عمل لارافيل، فهي تتيح لنا تنفيذ أوامر جاهزة مثل إنشاء جداول قواعد البيانات، أو تشغيل خادم التطوير المحلي، كما تتيح لنا تنفيذ أوامر جديدة خاصة بنا ننشؤها بأنفسنا، مثل إرسال بريد لمستخدم، أو تحديث بيانات معينة.

سنوضح في هذا المقال كيفية إنشاء أمر Artisan جديد باستخدام الأمر make:command الذي يؤدي لإنشاء صنف جديد في المجلد app/Console/Commands والمستخدَم لإعداد عمليات التهجير Migrations وقوائم الوِجهات Route وإنشاء الأرتال Queueing والأصناف والمهام الأخرى.

نظرة عامة على PHP Artisan

يستخدم المطورون أوامر Artisan من لارافيل لإكمال المهام الضوروية مثل إنشاء عمليات التهجير، ونشر موارد الحزم.

هناك عدة أوامر مدمجة مع Artisan، ويمكننا عرض قائمة بهذه الأوامر من خلال كتابة أمر php artisan list في الطرفية Terminal، إذ يوفر هذا الأمر قائمةً بجميع الأوامر المتاحة.

تساعد هذه الأوامر المطورين على العمل بكفاءة أكبر، فباستخدام أوامر Laravel Artisan المختلفة سنتمكن من إنشاء وظائف الاستيثاق Auth والمتحكم Controller والنموذج والبريد والتهجير والعديد من الوظائف الأخرى بسرعة وبوقت أقل.

تشغيل تطبيق لارافيل باستخدام خادم PHP Artisan

يتيح الأمر serve إمكانية تشغيل التطبيقات على خادم تطوير PHP بسهولة، ويمكن للمطورين استخدام Laravel Artisan لإنشاء واختبار ميزات التطبيق المختلفة، إذ يمكن بدء تشغيل الخادم المحلي على العنوان http://localhost:8000 بكتابة الأمر php artisan serve، مما يسهل اختبار وتطوير التطبيقات بسرعة؛ كما يمكن تخصيص الخادم لاستخدام مضيف ومنفذ مختلف.

يتكامل أمر php artisan serve مع نظام تطوير لارافيل Laravel Ecosystem الذي يتضمن ميزات عديدة مثل تهجير قواعد البيانات Migration، وجدولة المهام، وإدارة الأرتال Queues.

إنشاء أوامر مخصصة وتشغيلها

يمكن إنشاء أوامر Artisan مخصصة، مع اختيار مكان تخزينها وتحميلها باستخدام مدير الحزم Composer. سنشرح في الفقرات التالية أهم الخطوات المتبعة لإنشاء أوامر مخصصة وتسجيلها وتنفيذها.

الخطوة 1: إنشاء أمر جديد

يمكننا إنشاء أمر جديد باسم customcommand عبر استخدام الأمر make:command الذي سينشئ صنف أوامر جديد تلقائيًا في المجلد app/Console/Commands، وسيتولّد هذا المجلد إن لم يكن موجودًا مسبقًا.

لنكتب الآن الأمر التالي في طرفية Artisan:

php artisan make:command customcommand

قد يبدو ملف الشيفرة البرمجية CustomCommand.php الخاص بهذا الأمر كما يلي:

namespace App\Console\Commands;

use Illuminate\Console\Command;

class CustomCommand extends Command

{

protected $signature = 'custom:command';

protected $description = 'Description of the custom command';

public function __construct()

{

parent::__construct();

}

public function handle()

{

// نضع المنطق البرمجي للأمر هنا

}

}

الخطوة 2: تعريف الأمر

عند تنفيذ بعض أوامر Artisan، قد نحتاج أحيانًا لأن يُدخل المستخدم بعض المعلومات، مثل اسمه أو بريده الإلكتروني. يتعامل لارافيل مع ذلك باستخدام خاصية التوقيع signature، ويمكننا استخدام الصيغة القصيرة التالية لضبط الوسطاء Arguments والرايات Flags أو الخيارات المطلوبة والاختيارية، وهذا يسهل علينا تحديد الطريقة التي سيتفاعل بها المستخدمون مع الأمر عند تشغيله.

لنلقِ نظرةً على الأمر التالي:

protected $signature = 'user:update {id} {--name=} {--email=}';

يتوقّع هذا الأمر لأن يدخل المستخدم وسيطًا للمعرّف ID وخيارات الاسم والبريد الإلكتروني الاختيارية.

الخطوة 3: دخل وخرج الأمر

يوفّر لارافيل طرقًا سهلةً للحصول على قيم الوسطاء والخيارات عند تشغيل الأمر، لذا من المهم استخدام التابعين ‎$this->argument()‎ و ‎$this->option()‎ ضمن التابع handle الخاص بالأمر. وإن لم يكن الوسيط أو الخيار الذي نبحث عنه موجودًا، فسيعيد هذان التابعان القيمة null.

يمكننا الحصول على إدخال من المستخدم أثناء تشغيل الأمر بالإضافة إلى عرض الخرج، حيث يعرض التابع ask سؤالًا للمستخدم ويجمع استجابته ثم يرسلها مرةً أخرى إلى الأمر الخاص بنا.

$name = $this->ask('What is your name?', 'Taylor');

والأمر الآتي لطلب التأكيد:

if ($this->confirm('Do you wish to continue?')) {

// متابعة

}

يمكن جعل موجّه التأكيد يعيد القيمة true دائمًا من خلال تمرير القيمة true كوسيط ثانٍ للتابع confirm.

الخطوة 4: تسجيل الأوامر

يسجّل لارافيل جميع الأوامر الموجودة في المجلد app/Console/Commands افتراضيًا، ويمكننا إعداده للبحث في مزيد من المجلدات عن أوامر PHP Artisan، وذلك من خلال استخدام التابع withCommands في ملف bootstrap/app.php الخاص بتطبيقنا.

->withCommands([

__DIR__.'/../app/Domain/Orders/Commands',

])

سيجد حاوي الخدمات جميع الأوامر ويسجلها في تطبيقنا باستخدام Artisan.

الخطوة 5: تنفيذ الطلبات

قد نرغب في تشغيل أمر Artisan خارج واجهة سطر الأوامر من وجهة Route أو متحكم Controller مثلًا، حيث يمكن ذلك باستخدام التابع call مع الصنف Facade من Artisan؛ ويحتوي هذا التابع على وسيطين هما:

1. اسم الأمر أو صنفه
2. قائمة بمعاملات الأمر

ويعيد هذا التابع رمز الخروج.

يمكن أيضًا تمرير أمر Artisan بالكامل إلى التابع call كسلسلة نصية كما يلي:

Artisan::call('mail:send 1 --queue=default');

يمكن استخدام التابع queue مع الصنف Facade من Artisan لإرسال أوامر Artisan إلى عمّال الرتل، ثم نعالَج هذه الأوامر في الخلفية، ونتأكّد من ضبط الرتل وتشغيل مستمع الرتل قبل استخدام هذا التابع.

use Illuminate\Support\Facades\Artisan;

Route::post('/user/{user}/mail', function (string $user) {

Artisan::queue('mail:send', [

'user' => $user, '--queue' => 'default'

]);

// ...

});

الخطوة 6: معالجة الإشارات

يمكن لأوامر Artisan من لارافيل معالجة إشارات النظام مثل إشارات SIGINT، حيث يمكن دمج معالجة الإشارات مع الأمر الخاص بنا باستخدام التابع trap كما يلي:

$this->trap(SIGINT, function () {

$this->info('Command interrupted');

});

الخطوة 7: تخصيص الملفات الجذرية Stub

يمكن تخصيص ملفات القوالب التي يستخدمها أمر make:command من Artisan لتسهيل إنشاء الأوامر ذات البنى المتناسقة، لذا نحتاج إلى نشر الملفات الجذرية في مشروعنا كما يلي:

php artisan stub:publish

الخطوة 8: الأحداث

هناك ثلاثة أحداث يرسلها Artisan عند تشغيل الأوامر وهي:

1. Illuminate\Console\Events\ArtisanStarting
2. Illuminate\Console\Events\CommandStarting
3. Illuminate\Console\Events\CommandFinished

استخدم التابع event لإطلاق حدث كما يلي:

event(new CustomCommandExecuted($this));

إنشاء عمليات التهجير Migrations باستخدام الأمر make:migration

يُعَد الأمر php artisan make:migration من أوامر Artisan في لارافيل، ويُستخدَم لإنشاء ملف تهجير جديد. عمليات التهجير هي مخططات أولية لمخطط قاعدة البيانات الخاصة بنا، وتحدّد بنية الجداول والأعمدة والفهارس والعلاقات.

في ما يلي خطوات هذه العملية:

1. إنشاء عملية تهجير: يؤدي تشغيل الأمر make:migration إلى إنشاء ملف PHP جديد في المجلد database/migrations
2. تحديد التغييرات: يحتوي ملف التهجير على التابعين up و down، حيث يحدّد التابع up التغييرات التي تطرأ على قاعدة البيانات، مثل إنشاء الجداول أو إضافة الأعمدة، ويلغي التابع down هذه التغييرات
3. تشغيل عملية التهجير: استخدام الأمر php artisan migrate لتطبيق التغييرات على قاعدة البيانات

يؤدي الأمر التالي مثلًآ إلى إنشاء ملف جديد بالاسم create_users_table في المجلد database/migrations، ويمكن بعد ذلك تحديد بنية جدول users ضمن ملف التهجير.

Bash

php artisan make:migration create_users_table

فوائد الأمر make:migration

تتمثل فوائد الأمر make:migration فيما يلي:

• التحكم في الإصدارات: من خلال تعقّب تغييرات قاعدة البيانات بمرور الوقت
• التعاون: مشاركة بنية قاعدة البيانات مع أعضاء الفريق بسهولة
• بذر أو توليد البيانات Seeding لقاعدة البيانات: ملء قاعدة البيانات بالبيانات التجريبية باستخدام مولّد البيانات Seeder
• التراجع عن تغييرات قاعدة البيانات: يمكن عكس تغييرات قاعدة البيانات بسهولة إن لزم الأمر

تساعد عمليات التهجير على إبقاء مخطط قاعدة البيانات واضحًا ومنظمًا، مما يسهّل عملية إدارة التطبيق وتحديثه.

قائمة أوامر Laravel Artisan

تُعَد واجهة سطر أوامر Artisan في لارافيل أداةً مفيدةً للعمل مع التطبيقات، فهي تحتوي على أوامر لمهام مختلفة مثل إنشاء الشيفرة البرمجية وإدارة بيئة التطبيق.

تكون قائمة أوامر Laravel PHP Artisan الكاملة شاملة، حيث يمكننا استخدام أمر PHP Artisan list لجلبها، ولكن سنفصّل فيما يلي الأوامر الأساسية ضمن فئات في Laravel 11.

تتمثل الأوامر الأساسية في الآتي:

• cache: إدارة ذاكرة التطبيق المخبئية مثل المسح والنسيان وإلخ
• config: تخزين ملفات الضبط Configuration مؤقتًا أو مسحها أو نشرها
• down: تعطيل التطبيق مؤقتًا
• env: إدارة متغيرات البيئة
• key: توليد مفتاح تطبيق جديد
• migrate: تشغيل عمليات تهجير قاعدة البيانات
• optimize: تحسين التطبيق للإنتاج
• queue: إدارة نظام الرتل
• route: سرد الوِجهات Routes أو مسحها
• storage: إدارة مجلد التخزين
• vendor: إدارة اعتماديات مدير الحزم Composer

أما أوامر توليد الشيفرة البرمجية، فتتمثل في ما يلي:

• make: توليد بنى الشيفرة البرمجية المختلفة للمتحكم والنموذج والتهجير وإلخ
• model: إنشاء نماذج Eloquent
• migration: إنشاء ملفات التهجير
• seed: توليد بيانات وهمية لقاعدة البيانات

في حين أن أوامر الاختبار تكون كالآتي:

• test: تشغيل اختبارات التطبيق
• dusk: تشغيل اختبارات المتصفح باستخدام Dusk

إلى جانب وجود بعض الأوامر الإضافية التي يمكن اعتمادها، وتتمثل في:

• auth: إدارة العمليات المتعلقة بالاستيثاق Authentication
• breeze: تثبيت نظام استيثاق Breeze
• config: إدارة ملفات الضبط
• horizon: إدارة نظام رتل Laravel Horizon
• passport: إدارة خادم OAuth2
• sanctum: إدارة واجهة برمجة التطبيقات API لاستيثاق الرموز Token
• telescope: إدارة أداة تنقيح أخطاء Telescope

الخلاصة

بهذا نكون قد وضّحنا في هذا المقال كيفية إنشاء أوامر مخصصة باستخدام أمر Artisan الذي هو أداة PHP وتتيح تطوير أوامر مختلفة بناءً على احتياجات مشروعنا.

ترجمة -وبتصرّف- للقسم How to Create Custom Commands in Laravel 11 with PHP Artisan لصاحبته Hafsa Tahir.

اقرأ أيضًا

• إنشاء أوامر مخصصة في Laravel 11 باستخدام PHP Artisan
• نصائح لتحسين أداء تطبيقات لارافيل
• أفضل الحزم البرمجية لتحسين تطبيقات لارافيل

عندما نعمل على تطبيق لارافيل Laravel، قد نحتاج لتكرار مهام معينة خاصة بالتطبيق. وبدلاً من أن نكتب كل هذه الأوامر يدويًا في كل مرة يمكننا أتمتتها باستخدام أداة Artisan المدمجة مع إطار عمل لارافيل، فهذه الأداة تتيح لنا تنفيذ أوامر جاهزة مثل إنشاء جداول قواعد البيانات، أو تشغيل خادم التطوير المحلي، كما تمكننا من تنفيذ أوامر جديدة خاصة بنا كإرسال بريد لمستخدم، أو تحديث بيانات معينة

سنوضح في هذا المقال كيفية إنشاء أمر Artisan جديد في إصدار لارافيل 11، سنبدأ بالتعرف على أساسيات Artisan والأوامر التي توفرها، ثم ننتقل بعد ذلك لشرح طريقة إنشاء وتشغيل أوامرنا المخصصة.

نظرة عامة على Artisan

Artisan هو أداة سطر الأوامر مدمجة مع إطار العمل لارافيل توفر مجموعة من الأوامر المفيدة التي يمكن أن تساعدنا أثناء بناء التطبيقات، مثل إنشاء عمليات التهجير Migrations، ونشر موارد الحزم.

هنالك عدة أوامر مدمجة مع Artisan ويمكن عرض قائمة بهذه الأوامر من خلال كتابة أمر php artisan list في طرفية Artisan كما في الصورة التالية:

تساعدنا هذه الأوامر على العمل بكفاءة أكبر، حيث سنتمكن على سبيل المثال من إنشاء وظائف الاستيثاق Authentication، والمتحكمات Controllers، والنماذج Models، وإنشاء عمليات التهجير Migrations وغيرها من الوظائف المتقدمة بسهولة وخلال وقت أقل.

أساسيات أوامر Laravel Artisan

يُعَد الصنف Illuminate\Console\Application أساسًا في Artisan فهو الذي يحدد كيفية التعامل مع الأوامر، كما أنه يوسّع الصنف Symfony\Component\Console\Application، وهذا يسهّل على مطوري إطار عمل سيمفوني Symfony التعامل مع Artisan لأنهم سيجدون بيئة عمل مألوفة.

فيما يلي مثال على  تعريف أمر بسيط:

namespace App\Console\Commands;

use Illuminate\Console\Command;

class ExampleCommand extends Command

{

protected $signature = 'example:run {name}';

protected $description = 'Runs an example command';

public function handle()

{

$name = $this->argument('name');

$this->info("Hello, {$name}!");

}

}

دورة تطوير تطبيقات الويب باستخدام لغة PHP

احترف تطوير النظم الخلفية والووردبريس وتطبيقات الويب من الألف إلى الياء دون الحاجة لخبرة برمجية مسبقة

اشترك الآن

تشغيل تطبيق لارافيل باستخدام خادم PHP Artisan

يتيح الأمر serve تشغيل التطبيقات على خادم تطوير PHP بسهولة، ويمكن للمطورين استخدام Artisan لإنشاء واختبار ميزات التطبيق المختلفة، يمكن بدء تشغيل الخادم المحلي على العنوان http://localhost:8000 بكتابة الأمر التالي:

 php artisan serve 

وهذا يسهل اختبار وتطوير التطبيقات بسرعة، كما يمكننا تخصيص الخادم لاستخدام مضيف ومنفذ مختلف.

إنشاء أوامر مخصصة وتشغيلها

يمكن إنشاء أوامر Artisan مخصصة واختيار مكان تخزينها وتحميلها باستخدام مدير الحزم Composer. سنشرح في الفقرات التالية أهم الخطوات المتبعة لإنشاء أوامر مخصصة وتسجيلها وتنفيذها.

الخطوة 1: إنشاء أمر جديد

لإنشاء أمر جديد باسم customcommand نستخدام الأمر make:command الذي ينشئ تلقائيًا صنف أوامر جديد في المجلد app/Console/Commands، ويولّد هذا المجلد إن لم يكن موجودًا مسبقًا.

لنكتب الآن الأمر التالي في طرفية Artisan:

php artisan make:command customcommand

يبدو ملف الشيفرة البرمجية الخاص بهذا الأمر كما يلي:

namespace App\Console\Commands;

use Illuminate\Console\Command;

class CustomCommand extends Command

{

protected $signature = 'custom:command';

protected $description = 'Description of the custom command';

public function __construct()

{

parent::__construct();

}

public function handle()

{

// نضع المنطق البرمجي للأمر هنا

}

}

الخطوة 2: تعريف الأمر المخصص

عند تنفيذ بعض أوامر Artisan، قد يحتاج المستخدم لإدخال بعض المعلومات كاسمه أو بريده الإلكتروني، ويتعامل لارافيل مع ذلك باستخدام خاصية التوقيع signature. يمكننا استخدام الصيغة القصيرة التالية لضبط الوسطاء arguments والرايات flags أو الخيارات الإجبارية والاختيارية، وهذا يسهّل علينا تحديد الطريقة التي سيتفاعل بها المستخدمون مع الأمر. لنلقِ نظرة على الأمر التالي:

protected $signature = 'user:update {id} {--name=} {--email=}';

يتوقّع هذا الأمر أن يدخل المستخدم وسيطًا هو المعرف id، ويدخل الاسم والبريد الإلكتروني اختياريًا.

الخطوة 3: دخل وخرج الأمر

يوفّر لارافيل طرقًا سهلة للحصول على قيم الوسطاء عند تشغيل الأمر، حيث يمكننا استخدام التابعين ‎$this->argument()‎ و ‎$this->option()‎ ضمن التابع handle الخاص بالأمر. إن لم يكن الوسيط أو الخيار الذي نبحث عنه موجودًا، فسيعيد هذان التابعان القيمة null.

المطالبة بالإدخال

يمكننا الحصول على إدخال من المستخدم أثناء تشغيل الأمر بالإضافة إلى عرض الخرج، حيث يعرض التابع ask سؤالًا للمستخدم ويحصل على استجابته ثم يرسلها مرة أخرى إلى الأمر الخاص بك.

$name = $this->ask('What is your name?', 'Taylor');

طلب التأكيد

if ($this->confirm('Do you wish to continue?')) {

// متابعة

}

يمكن جعل موجّه التأكيد يعيد القيمة true دائمًا من خلال تمرير القيمة true كوسيط ثانٍ للتابع confirm.

الخطوة 4: تسجيل الأوامر

يسجّل لارافيل جميع الأوامر الموجودة في المجلد app/Console/Commands افتراضيًا، ويمكننا إعداد لارافيل للبحث في مزيد من المجلدات عن أوامر PHP Artisan من خلال استخدام التابع withCommands في ملف bootstrap/app.php الخاص بالتطبيق.

->withCommands([

__DIR__.'/../app/Domain/Orders/Commands',

])

سيجد حاوي الخدمات جميع الأوامر ويسجلها في التطبيق باستخدام Artisan.

الخطوة 5: تنفيذ الطلبات

قد نرغب بتشغيل أمر Artisan خارج واجهة سطر الأوامر من وجهة Route أو متحكم Controller مثلًا، ويمكن تحقيق ذلك باستخدام التابع call مع الصنف Facade من Artisan، يحتوي هذا التابع على وسيطين الأول هو اسم الأمر أو اسم الصنف المرتبط بالأمر، والوسيط الثاني هو قائمة بمعاملات الأمر، ويعيد هذا التابع رمز الخروج ليشير إلى ما إذا كان الأمر قد نجح أم لا.

يمكن أيضًا تمرير أمر Artisan بالكامل للتابع call كسلسلة نصية كما يلي:

Artisan::call('mail:send 1 --queue=default');

ترتيب أوامر Artisan ضمن رتل

يمكننا استخدام التابع queue مع الصنف Facade من Artisan لإرسال أوامر Artisan إلى عمّال الرتل Queue Workers، ثم تُعالَج هذه الأوامر في الخلفية، وعلينا التأكّد من ضبط الرتل وتشغيل مستمع الرتل قبل استخدام هذا التابع.

use Illuminate\Support\Facades\Artisan;

Route::post('/user/{user}/mail', function (string $user) {

Artisan::queue('mail:send', [

'user' => $user, '--queue' => 'default'

]);

// ...

});

الخطوة 6: معالجة الإشارات

يمكن لأوامر Artisan من لارافيل معالجة إشارات النظام مثل إشارات SIGINT، حيث يمكننا دمج معالجة الإشارات مع الأمر الخاص بنا باستخدام التابع trap كما يلي:

$this->trap(SIGINT, function () {

$this->info('Command interrupted');

});

الخطوة 7: تخصيص الملفات الجذرية Stub

يمكن تخصيص ملفات القوالب التي يستخدمها أمر make:command من Artisan لتسهيل إنشاء الأوامر ذات البنى المتناسقة، لذا نحتاج إلى نشر الملفات الجذرية في مشروعنا كما يلي:

php artisan stub:publish

الخطوة 8: الأحداث

هناك ثلاثة أحداث مهمة ترسلها أداة Artisan عند تشغيل الأوامر وهي:

• الحدث Illuminate\Console\Events\ArtisanStarting
• الحدث Illuminate\Console\Events\CommandStarting
• الحدث Illuminate\Console\Events\CommandFinished

نستخدم التابع event لإطلاق حدث كما يلي:

event(new CustomCommandExecuted($this));

إنشاء عمليات التهجير Migrations

يُعَد الأمر php artisan make:migration من أوامر Artisan المفيدة في لارافيل، حيث يستخدم لإنشاء ملف تهجير جديد. وعمليات التهجير هي مخططات أولية لمخطط قاعدة البيانات وتحدّد لنا بنية الجداول والأعمدة والفهارس والعلاقات.

فيما يلي خطوات هذه العملية:

1. إنشاء عملية تهجير: يؤدي الأمر make:migration لإنشاء ملف جديد في المجلد database/migrations
2. تحديد التغييرات: يحتوي ملف التهجير على التابعين up و down يحدّد up التغييرات التي تطرأ على قاعدة البيانات مثل إنشاء الجداول، ويلغي down هذه التغييرات
3. تشغيل عملية التهجير: يفيد الأمر php artisan migrate في تطبيق التغييرات على قاعدة البيانات

على سبيل المثال سيؤدي الأمر التالي لإنشاء ملف جديد بالاسم create_users_table في المجلد database/migrations، ويمكننا بعد ذلك تحديد بنية جدول users ضمن ملف التهجير.

php artisan make:migration create_users_table

تتمثل فوائد الأمر make:migration فيما يلي:

• التحكم في الإصدارات من خلال تعقّب تغييرات قاعدة البيانات بمرور الوقت
• التعاون ومشاركة بنية قاعدة البيانات مع أعضاء الفريق بسهولة
• بذر أو توليد البيانات Seeding لقاعدة البيانات لملئها بالبيانات التجريبية باستخدام Seeder
• التراجع عن تغييرات قاعدة البيانات بسهولة عند الحاجة
• إبقاء مخطط قاعدة البيانات واضحًا ومنظمًا، مما يسهّل إدارة تطبيقنا وتحديثه

قائمة بأهم أوامر Laravel Artisan

تحتوي واجهة سطر أوامر Artisan في لارافيل على أوامر لمهام مختلفة مثل إنشاء الشيفرة البرمجية وإدارة بيئة التطبيق ويمكن مطالعة القائمة الشاملة لكافة الأوامر بكتابة الأمر PHP Artisan list كما وضحنا سابقًا، ولكن سنفصّل فيما يلي الأوامر الأساسية الموجودة ضمن لارافيل 11 ضمن فئات.

الأوامر الأساسية

• cache: إدارة ذاكرة التطبيق المخبئية
• config: تخزين ملفات الضبط Configuration مؤقتًا أو مسحها أو نشرها
• down: تعطيل التطبيق مؤقتًا
• env: إدارة متغيرات البيئة
• key: لتوليد مفتاح تطبيق جديد
• migrate: تشغيل عمليات تهجير قاعدة البيانات
• optimize: تحسين التطبيق للإنتاج
• queue: إدارة نظام الرتل
• route: سرد الوجهات Routes أو مسحها
• storage: إدارة مجلد التخزين
• vendor: إدارة اعتماديات مدير الحزم Composer

أوامر توليد الشيفرة البرمجية

• make: توليد بنى الشيفرة البرمجية المختلفة للمتحكم والنموذج والتهجير ...إلخ.
• model: إنشاء نماذج Eloquent
• migration: إنشاء ملفات التهجير
• seed: توليد بيانات وهمية لقاعدة البيانات

أوامر الاختبار

• test: تشغيل اختبارات التطبيق
• dusk: تشغيل اختبارات المتصفح باستخدام Dusk

أوامر أخرى

• auth: إدارة العمليات المتعلقة بالاستيثاق Authentication
• breeze: تثبيت نظام استيثاق Breeze
• config: إدارة ملفات الضبط
• horizon: إدارة نظام رتل Laravel Horizon
• passport: إدارة خادم OAuth2
• sanctum: إدارة واجهة برمجة التطبيقات API لاستيثاق الرموز Token
• telescope: إدارة أداة تنقيح أخطاء Telescope

الخلاصة

وضّحنا في هذا المقال كيفية إنشاء أوامر مخصصة باستخدام أمر Artisan الذي يوفر إمكانية تطوير أوامر مختلفة واستدعاءها بناءً على احتياجات مشروعنا.

بعض الأسئلة الشائعة

لنتعرف على أبرز الأسئلة الشائعة حول أوامر Artisan

1. ما الغرض من أوامر PHP Artisan في لارافيل

أوامر Artisan هي أداة سطر أوامر في لارافيل تساعدنا على أتمتة المهام وإدارة عمليات التهجير وتوليد الشيفرة البرمجية المساعدة، ويمكننا استخدامها أيضًا لتشغيل الاختبارات وإنجاز مهام التطوير والإدارة الأخرى في تطبيقات لارافيل.

2. لماذا نستخدم أمر PHP Artisan Serve

يشغّل أمر PHP Artisan serve خادم تطوير محلي لتطبيق لارافيل الخاص بنا بسرعة، ويُعَد مثاليًا لإنشاء النماذج الأولية السريعة والاختبار أثناء التطوير.

3. كيف نشغّل أوامر PHP Artisan في cpanel

نفتح الطرفية Terminal من cPanel وننتقل إلى مجلد مشروع لارافيل الخاص بنا، ثم نشغّل الأمر باستخدام PHP كما يلي:

 ‎/usr/local/bin/php artisan {command}‎

تحتاج للتأكد من وضع مسار PHP الصحيح للخادم مكان ‎/usr/local/bin/php، والذي يمكننا العثور عليه في MultiPHP Manager ضمن cPanel.

4. هل يمكن تعديل أو توسيع أوامر Artisan الموجودة مسبقًا في لارافيل

نعم، لدينا القدرة على تعديل أو توسيع أوامر Artisan الموجودة مسبقًا في لارافيل من خلال إنشاء أمر مخصص يرث صنف الأمر الأساسي، ثم تنفيذ المنطق البرمجي أو الوظيفة المحددة التي نريدها ضمن هذا الأمر المخصص.

5. هل يمكن استخدام أوامر Artisan المخصصة لأتمتة المهام الشائعة في لارافيل

نعم، يمكننا استخدام أوامر Artisan المخصصة في لارافيل لأتمتة المهام الشائعة مثل تشغيل عمليات التهجير، وتوليد بيانات لقاعدة البيانات وتوليد الشيفرة البرمجية وتطبيق المهام المجدولة وتنفيذ أي منطق برمجي مخصص.

ترجمة -وبتصرّف- للمقال How to Create Custom Commands in Laravel 11 with PHP Artisan للكاتبة Hafsa Tahir.

اقرأ أيضًا

• نصائح لتحسين أداء تطبيقات لارافيل
• أفضل الحزم البرمجية لتحسين تطبيقات لارافيل
• كيف تنشئ نموذجا Model في Laravel
• أساسيات التخبئة Cache في Laravel

تزايدت شعبية إطار العمل لارافيل Laravel بشكل كبير فهو اليوم واحد من أبرز أطر عمل لغة PHP، لا سيما في مجال تطوير تطبيقات الويب ومنصات التجارة الإلكترونية. سنشرح لكم في هذا المقال عدة نصائح وملاحظات لتحسين أداء التطبيقات المطورة بلارافيل.

أهمية تحسين تطبيقات لارافيل

أصبح إطار العمل لارافيل شائعًا جدًا في تطوير تطبيقات الأعمال التي تساعد في اتخاذ القرارات الإدارية بسرعة وفعالية. ولضمان أداء جيد لهذه التطبيقات، نحتاج لتحسينها والتأكد من تنفيذها للمهام بسرعة وسلاسة، لا سيما إذا كانت هذه التطبيقات تؤثر في اتخاذ قرارات مهمة.

يوفر تحسين أداء تطبيقات لارافيل جملة من الفوائد تشمل زيادة فعالية التطبيق وتعزيز الفرصة لوصوله إلى جمهور أوسع، وتوفير الوقت وتقليل الهدر في الموارد، إلى جانب تحسين التعامل مع حركة البيانات وإدارة الطلبات المتزايدة بكفاءة مع زيادة حجم التطبيق.

متطلبات العمل

سنفترض في هذه المقال أن لدينا تطبيق لارافيل مثبت على خادم تتوفر فيه الأمور التالية:

• الإصدار Laravel 9.0 من إطار العمل لارافيل
• الإصدار  PHP 8.0 من لغة PHP
• قاعدة البيانات MariaDB

نصائح لتحسين أداء تطبيقات لارفيل

فيما يلي نورد مجموعة من النصائح التي تساعد في تحسين أداء تطبيقات لارافيل.

التخزين المؤقت للإعدادات

يمكننا من خلال حفظ إعدادات التطبيق في ذاكرة التخزين المؤقت cache memory تسريع الوصول لهذه الإعدادات، بدلاً من تحميلها من الملفات في كل مرة نشغل فيها التطبيق وهذا الأمر يساهم في تحسين أداء التطبيق بشكل عام. 

لتنفيذ هذا الأمر في إطار العمل لارافيل نستخدم الأمر التالي:

php artisan config:cache

بمجرد تخزين الإعدادات في ذاكرة التخزين المؤقت، فإن أي تغييرات نجريها على هذه الإعدادات لن تؤثر على هذه النسخة في الذاكرة. فإذا أردنا تحديث الذاكرة المؤقتة لتخزن الإعدادات الجديدة، فعلينا تنفيذ الأمر السابق مرة أخرى.

ولمسح التخزين المؤقت للإعدادات نستخدم الأمر التالي:

php artisan config: clear

لا ينبغي استخدام أمر تخزين الإعدادات مؤقتًا أثناء تطوير التطبيق، لأن الإعدادات قد تتغير بصورة مستمرة طيلة مرحلة التطوير، وبإمكاننا استخدام أداة OPcache لتحسين التطبيق، فهو يخزّن شيفرة PHP الذاكرة المؤقتة، مما يلغي الحاجة لإعادة تصريف شيفرة PHP في كل مرة نطلبها من الخادم، ويساهم في تسريع التطبيق.

التخزين المؤقت للوجهات Routes

يفيد التخزين المؤقت للوجهات routes في لارافيل في تحسين التطبيقات، لا سيما تلك التي تحتوي عدد كبير من الوجهات والإعدادات. فمن خلال تخزين المصفوفة الخاصة بالوجهات في الذاكرة المؤقتة، سنتمكن من تحميلها بسرعة أكبر. لتنفيذ هذه الميزة، نستخدم الأمر التالي:

php artisan route: cache

لا ننسى تنفيذ هذا الأمر كلما تغير ملفات الإعدادات أو الوجهات لمشروعنا، وإلا سيحمّل لارافيل القيم المحفوظة سابقًا. 

لمسح التخزين المؤقت للوجهات routes نستخدم الأمر التالي:

php artisan route: clear

إزالة الخدمات غير المستخدمة

الغاية الأساسية لإطار لارافيل هي تسهيل عمل المطورين ولتحقيق هذه الغاية يحمّل إطار لارافيل عند تشغيله مجموعة متنوعة من الخدمات المدمجة والمحددة في الملف config/app.php. لكن قد لا يحتاج المطور للعديد من هذه الخدمات كخدمة التعامل مع قوالب العرض View Service وخدمة إدارة الجلسة Session Service، وسيفيدنا تعطيل الخدمات غير الضرورية في تحسين أداء التطبيق.

تحسين تحميل الملفات

يستدعي إطار لارافيل ملفات متعددة للتعامل مع الطلبات requests، وبالتالي قد يرتبط تطبيق لارافيل متوسط التعقيد بعدة ملفات، ومن النصائح البسيطة لتحسين الأداء التصريح عن كل الملفات التي يحتاجها التطبيق ضمن ملف واحد يُستدعى ويُحمّل لكل الطلبات.

نستخدم الأمر التالي لتطبيق هذه النصيحة:

php artisan optimize --force

تحسين الملحن Composer

الملحن Composer هو أداة مفيدة لإدارة الاعتماديات dependencies في تطبيقات PHP وكذلك في تطبيقات لارافيل. فعند تثبيت هذه الأداة، ستعمل على تحميل جميع اعتماديات بيئة التطوير الخاصة بإطار العمل، وبالرغم من أن هذه الاعتماديات مفيدة في تسريع عملية التطوير، لكن بمجرد اكتمال العمل على التطبيق وتحويله إلى بيئة الإنتاج، تصبح هذه الاعتماديات غير ضرورية وقد تؤثر سلبًا على أداء التطبيق وتبطئه.

يمكننا تحسين الأداء في بيئة الإنتاج بتنفيذ الأمر التالي الذي يثبيت الاعتماديات الضرورية فقط، ويتجنب تحميل الحزم غير المطلوبة:

composer install --prefer-dist --no-dev -o

تحديد المكتبات المضمّنة في التطبيق

من المميزات المفيدة في إطار لارافيل إمكانية تضمين العدد الذي نريده من المكتبات في التطبيق. لكن بالمقابل ستظهر الآثار السلبية لتلك الميزة في بطئ الأداء والتأثير سلبًا على تجربة المستخدمين. لذا، من المهم مراجعة جميع المكتبات التي نضمنّها في التطبيق، ونحذف المكتبات التي يمكننا الاستغناء عنها من الملف config/app.php لتسريع التطبيق. من المهم أيضًا مراجعة الملف composer.json. الذي يحتوي على قائمة بالاعتماديات أو المكتبات التي يعتمد عليها التطبيق والتأكد من أن لكل مكتبة استخدام فعلي في التطبيق وإلا من الأفضل إزالتها.

استخدام مصرّف JIT

يمكن لتطبيقات لارافيل الاستفادة بشكل كبير من تقنية المصرّف Just In Time أو JIT اختصارًا لتحسين سرعة المعالجة وتقليل وقت الاستجابة، خصوصًا في التطبيقات الكبيرة التي تحتاج لمعالجة معقدة. فعند تنفيذ شيفرة PHP، فهي تترجم أولاً إلى شيفرة البايت Bytecode ثم تنفذ، وهو ما يتطلب استخدامًا مكثفًا للموارد. ولتنفيذ ذلك، يحتاج تطبيق لارافيل لأدوات وسيطة مثل Zend Engine التي تعمل على تشغيل برامج فرعية Subroutines بلغة C تُنفّذ في كل مرة نشغّل فيها التطبيق.

المشكلة أن هذه العمليات تستهلك وقتًا وموارد، لذا يكون من الأفضل تنفيذ عملية الترجمة مرة واحدة، وهذا ما تقوم به تقنية المصرّف JIT الذي يصرّف الشيفرة إلى شيفرة بلغة الآلة مباشرة عند الحاجة فقط، مما يساهم في تسريع الأداء بشكل كبير. ولتحقيق أفضل استفادة من هذه التقنية، يُفضّل استخدام المصرّف HHVM الذي طورته فيسبوك مع تطبيقات لارافيل.

اختيار أسرع برمجيات لتخزين بيانات الذاكرة المؤقتة والجلسة

من أفضل طرق تحسين أداء لارافيل تخزين بيانات الذاكرة المؤقتة وبيانات الجلسة ضمن ذواكر RAM. لهذا تُستخدم برمجيات لتخزين البيانات المؤقتة في الواجهة الخلفية مثل برنامج Memcached مما يساهم في تحسين أداء الإصدار لارافيل. كما يمكننا العثور على إعدادات مكتبة تخزين الجلسات أو برنامج إدارة الجلسات في الملف app/config/session.php بينما يمكننا تحديد برنامج إدارة الذاكرة المؤقتة من خلال الإعداد الموجود في الملف app/config/cache.php.

التخزين المؤقت لنتائج الاستعلام

يساعدنا التخزين المؤقت لنتائج الاستعلامات التي تتكرر كثيرًا في تطبيقاتنا على تحسين أداء لارافيل. ننصح باستخدام الدالة remember كالتالي:

$posts = Cache::remember('index.posts', 30, function() {
    return Post::with('comments', 'tags', 'author', 'seo')
               ->whereHidden(0)
               ->get();
});

يخزن الكود السابق نتائج استعلام قاعدة البيانات كالمنشورات مع التعليقات، والوسوم، والمؤلف، وتحسين محركات البحث في الذاكرة المؤقتة. فإذا كانت البيانات موجودة في الذاكرة المؤقتة بالفعل، سنسترجعها بسرعة. وإذا لم تكن موجودة، سينفذ الاستعلام لاسترجاع البيانات من قاعدة البيانات ويخزنها في الذاكرة المؤقتة لمدة 30 دقيقة لتحسين الأداء.

استخدام التوسع الأفقي للتطبيق

ما نعنيه بالتوسيع الأفقي للتطبيق توزيع الحمل على عدة خوادم بدلاً من الاعتماد على خادم واحد فقط. هذه الطريقة مفيدة عند تزايد عدد الطلبات على الواجهة البرمجية لتطبيقنا، مما يساهم في تحسين الأداء والقدرة على التعامل مع عدد أكبر من المستخدمين على التزامن.

يمكن التفكير في توسيع تطبيق لارافيل أفقيًا في حال ازدادت كثافة المرور على الواجهة البرمجية فهذا يساهم في توزيع الحمل على عدد من الخوادم ويسمح لتطبيقنا بالتعامل طلبات الاتصال المتزامنة بفعالية أكبر. يمكننا من خلال نشر نسخ إضافية من التطبيق على خوادم أخرى توزيع الحمل وتخفيف الضغط وضمان استجابة سريعة، وحتى إن تعطل أحد الخوادم سيستمر التطبيق في العمل مما يزيد ثقة العملاء بالتطبيق ويضمن توافره باستمرار.

استخدام التحميل الشره Eager Loading للبيانات

تقدم لارافيل الأداة Eloquent، وهي أداة ممتازة لربط العلاقات بالكائنات Object-Relational Mapping حيث تنشئ نماذج تجرّد جداول قاعدة البيانات وتساعد المطورين على استخدام بنى بسيطة للبيانات واستخدام Eloquent لتنفيذ كل العمليات الأساسية على قواعد البيانات بلغة PHP. 

عند استخدام التحميل الشره في لارافيل، ستسترجع كافة البيانات المرتبطة بالنموذج -مثل العلاقات بين الجداول- في نفس الاستعلام الأولي. بمعنى آخر، بدلاً من الانتظار لإجراء استعلامات إضافية عند الوصول إلى هذه البيانات المرتبطة، سينفذ تحميلها جميعًا مرة واحدة وتضمن في الاستجابة الأولى للتطبيق ما يساهم في تحسين الأداء ويقلل عدد الاستعلامات إلى قاعدة البيانات.

لنقارن التحميل البطيء lazy loading مع التحميل الشره، إذ يبدو الاستعلام في حالة التحميل البطيء كالتالي:

$books = App\Book::all();

foreach ($books as $book) {
    echo $book->author->name;
}

ويبدو كما يلي في حالة التحميل الشره:

$books = App\Book::with('author')->get();

foreach ($books as $book) {
    echo $book->author->name;
}

هذا الكود أكثر كفاءة لأنه يستخدم التحميل الشره لتحميل العلاقة مع المؤلف مرة واحدة بدلاً من تحميل المؤلف في كل مرة وصول إليه، مما يقلل عدد الاستعلامات المرسلة إلى قاعدة البيانات.

التصريف المسبق للأصول Assets Pre-compiling

عند تطوير تطبيقات لارافيل، يعمل المطورون على توزيع التطبيق عبر عدة ملفات مثل ملفات config و routes، مما يجعل الشيفرة واضحة وسهلة الإدارة. لكن هذا الأسلوب يتطلب الكثير من العمل لجعل الشيفرة جاهزة للعمل.

يقدم لارافيل بعض الأوامر البسيطة لمساعدة المطورين في تحسين الأداء وتحويل الشيفرة إلى نسخة إنتاجية حيث يمكن استخدامها لتجميع الأصول كالأنماط والسكريبتات والصور في ملفات واحدة وضغطها. 

تساهم هذه الأوامر في تسريع تحميل التطبيق وزيادة كفاءة الشيفرة في بيئة الإنتاج:

php artisan optimize
php artisan config:cache
php artisan route:cache

استخدام شبكة توزيع المحتوى CDN

شبكة توزيع المحتوى CDN هي مجموعة من الخوادم الموزعة جغرافيًا في أماكن مختلفة حول العالم، والتي تعمل على تخزين وتوزيع المحتوى الثابت مثل ملفات JavaScript، CSS، الصور، ومقاطع الفيديو بكفاءة أكبر. يفيدنا استخدام شبكة CDN لتطبيقات لارافيل في تحسين أداء تحميل الأصول الثابتة للموقع من خلال تقديمها من أقرب خادم جغرافي للمستخدم بدلاً من تحميلها من الخادم الرئيسي للموقع. عندما يزور المستخدم الموقع، تعمل CDN على توجيه الطلب إلى أقرب خادم له، مما يقلل المسافة الجغرافية التي يجب على البيانات قطعها، وبالتالي يسرع من عملية تحميل الصفحة خاصة في الحالات التي يكون فيها المحتوى ثابتًا وغير قابل للتغيير بشكل متكرر، مثل الصور أو ملفات CSS.

استخدام أداة Mix لتجميع الأصول

تأتي الأداة Mix افتراضيًا مع كل تطبيقات لارافيل، تؤمن هذه الأداة واجهة برمجية فعالة لبناء حزمة Webpack لتطبيقات PHP باستخدام المعالجات الأولية pre processors لملفات CSS وملفات جافا سكريبت  مما يساعد على تحسين إدارة أصول التطبيق وتحسين الأداء.

على سبيل المثال، يمكننا دمج عدة ملفات CSS أو JavaScript في ملف واحد، مما يقلل عدد الطلبات المرسلة للخادم ويحسن من سرعة تحميل الصفحة.

mix.styles([
    'public/css/vendor/normalize.css', 
    'public/css/styles.css'
], 'public/css/all.css'); 

تُنشئ الشيفرة السابقة ملف CSS باسم all.css يضم التنسيقات الموجودة في الملفين normalize.css و styles.css. وبهذا سنتمكن من استخدام الملف الجديد بسهولة ضمن شيفرة HTML بدلًا من تضمين الملفين السابقين.

تصغير حجم الأصول

عند تجميع الأصول في ملف واحد، قد ينتج عن ذلك ملف كبير جدًا. وعلى الرغم من أن هذا يحسن من عدد الطلبات، إلا أنه قد لا يحقق أفضل استفادة من فكرة التصريف أو  التخزين المؤقت caching التي تحدثنا عنها سابقًا. لهذا، من الأفضل تقليل حجم الأصول بقدر المستطاع لتسريع تحميل الصفحة من خلال الأمر التالي:

$ npm run production

يُنفذ الأمر السابق جميع مهام Mix اللازمة لضبط الأصول بشكل يتناسب مع النسخة النهائية من التطبيق. وهو يتضمن تصغير ملفات CSS و JavaScript ودمجها لتقليل حجمها ما يؤدي إلى تسريع تحميلها وبالتالي تحسين أداء التطبيق.

استخدام أحدث نسخ PHP

يساهم تحميل أحدث إصدار من لغة PHP في تحسين أداء التطبيق بشكل كبير. لذا، من الضروري التأكد من تشغيل أحدث نسخة من PHP في تطبيقات لارافيل للاستفادة من التحسينات التي تقدمها النسخ الجديدة، سواء على صعيد الأداء أو الأمان، وتجنب المشكلات المرتبطة بالسرعة وضمان تجربة مستخدم أفضل.

استخدام المنقح Debugger

على الرغم من أن منقّح لارافيل Laravel Debugbar ليس تقنية مباشرة لتحسين أداء تطبيقات لارافيل، إلا أداة هامة لمراقبة وتحليل أداء التطبيقات. فهو يساعدنا في دمج شريط تنقيح PHP مع لارافيل ويظهره في المتصفح أثناء تشغيل التطبيق، مما يفيدنا في مراقبة عدة أمور في تطبيقنا مثل مدة استجابة التطبيق، ووقت تنفيذ الاستعلامات، وفحص الشيفرة البرمجية، لتحديد المشكلات التي قد تؤثر على كفاءة التطبيق أو التي تؤثر سلبًا على الأداء.

استخدام إضافات مفيدة لتحسين تطبيقات لارافيل

يمكننا تنزيل أدوات مفيدة في تحسين تطبيقات لارافيل مثل إضافة تسريع صفحات لارافيل Laravel Page Speed التي تساعد في تقليل حجم البيانات المرسلة إلى المتصفح، مما يسرّع تحميل الصفحات.

نثبت الحزمة ونستخرج الملفات من renatomarinho/laravel-page-speed package باستخدام الملحن Composer ونضيف اسم الحزمة مع تفاصيل نسختها إلى الملف composer.json:

"require": { 
......
......
"renatomarinho/laravel-page-speed": "^1.8"
},

ثم ننفذ أمر تحديث الملحن Composer كما يلي:

composer update

بعد استخراج ملفات الحزمة السابقة، نضيف مزود الخدمة الخاص بها من خلال الانتقال إلى الملف config/app.php وإضافة السطر التالي:

'providers' => [ 
 ....
 ....
RenatoMarinho\LaravelPageSpeed\ServiceProvider::class,
],

بعد ذلك، يجب نشر الحزمة حتى نتمكن من استخدامها في التطبيق. يساعد الأمر التالي غلى نشر الحزمة، ولا نستطيع استخدامها قبل تنفيذه:

php artisan vendor:publish --provider="RenatoMarinho\LaravelPageSpeed\ServiceProvider"

بعد نشر الحزمة، لا بد من إضافة تفاصيل Middleware الخاص بها في الملف app/Http/Kernel.php حتى تتمكن من العمل مع الطلبات الواردة إلى التطبيق. لهذا، ننسخ الشيفرة التالية ونلصقها بعد المصفوفة middlewareGroups$:

protected $middlewareGroups = [
    'web' => [
        // بعض الوسطاء السابقين...

        \RenatoMarinho\LaravelPageSpeed\Middleware\InlineCss::class,
        \RenatoMarinho\LaravelPageSpeed\Middleware\ElideAttributes::class,
        \RenatoMarinho\LaravelPageSpeed\Middleware\InsertDNSPrefetch::class,
        \RenatoMarinho\LaravelPageSpeed\Middleware\RemoveComments::class,
        \RenatoMarinho\LaravelPageSpeed\Middleware\TrimUrls::class,
        \RenatoMarinho\LaravelPageSpeed\Middleware\RemoveQuotes::class,
        \RenatoMarinho\LaravelPageSpeed\Middleware\CollapseWhitespace::class,
    ]
];

/* تعريف وجهة */
Route::get('/listView', function () {
    return view('listView');
});

ننشئ في النهاية قالب Laravel Blade ونضع ضمنه الشيفرة لعرضها.

أدوات مفيدة لمراقبة أداء تطبيقات لارافيل

يساعدنا مراقبة أداء تطبيقات لارافيل على تحديد الجوانب التي تحتاج إلى تطوير وتحسين في تطبيقنا، وفيما يلي نستعرض بعض الأداوت المفيدة لتحقيق ذلك.

الأداة Blackfire.io

تُعد Blackfire.io أداة مفيدة لمراقبة أداء التطبيقات وتنقيحها، فهي تزود المطورين ببيانات مفصلة عن أداء تطبيقاتهم وتوفر لهم إرشادات مفيدة لتحديد أي اختناقات تؤدي إلى بطء التطبيق. كما تساعد على تحديد المشكلات التي تؤثر على الأداء سواء كانت على مستوى الشيفرة أو استعلامات قواعد البيانات أو استدعاءات واجهات برمجية خارجية. وتتكامل هذه الأداة بسلاسة مع أطر عمل PHP مثل لارافيل و Symfony وغيرها، مما يُسهل إعدادها واستخدامها في تحليل الأداء.

الأداة Laravel Dusk

أداة اختبار End-to-End لإطار العمل لارافيل مصممة لتبسيط الاختبارات المؤتمتة للمتصفح في تطبيقات الويب، فاختبار  End-to-End  هو نوع من الاختبارات الآلية التي تحاكي سلوك المستخدم الحقيقي في التطبيق، مثل تسجيل الدخول والخروج وتعبئة النماذج وإرسالها والتنقل بين الصفحات والتأكد من ظهور العناصر في الواجهة بشكل صحيح.

الأداة LoadForge

وهي منصة سحابية تساعد المطورين في قياس قدرة التطبيقات والواجهات البرمجية على التعامل مع ضغط العمل. فمن خلال هذه الأداة يمكننا محاكاة دخول آلاف المستخدمين في نفس الوقت، مما يتيح لنا تقييم أداء المواقع والواجهات البرمجية تحت ضغط مكثف ويساعدنا في تحديد فيما إذا كان التطبيق يحتاج إلى التوسيع لتحمل المزيد من المستخدمين.

الخاتمة

استعرضنا في هذا المقال مجموعة من النصائح والممارسات الفعالة لتحسين أداء تطبيقات لارافيل، إلى جانب أدوات قوية تساعد في التعامل مع مختلف متطلبات العمل. ننصح بتطبيق هذه النصائح والاستفادة منها لبناء تطبيقات أسرع وأكثر كفاءة، وموثوقية، ويمكنها التكيف مع توسع التطبيق وزيادة عدد المستخدمين بسلاسة.

ترجمة -وبتصرف- للمقال: 17 Tips for Laravel Performance Optimization in 2024 لصاحبه Mansoor Ahmed Khan

اقرأ أيضًا

• أفضل الحزم البرمجية لتحسين تطبيقات لارافيل
• مقارنة بين استخدام ووردبريس ولارافيل في تطوير الويب
• إنشاء واجهة أمامية لمدونة باستخدام لارافيل
• تعرف على لغة PHP

تبرز منصتا ووردبريس ولارافيل كخيارات مثالية في عالم الويب الذي يتطور باستمرار، هذا قد يدفعنا للتساؤل ما الخيار الأفضل من بينهما لتطوير الويب، والجواب على هذا السؤال يعتمد على طبيعة احتياجاتنا، ويحتاج منا لفهم نقاط القوة التي تميز كل منصة ونقاط الضعف المحتملة.

نقارن في هذا المقال بين لارافيل و ووردبريس، ونحاول تقديم رؤية واضحة من خلال البحث في جوانب حساسة تتعلق بالمرونة وإمكانية زيادة حجم الأعمال والأمان وسهولة الاستخدام وقابلية توسيع المنصة extensibility كي نتخذ قرارًا مدروسًا.

نظرة عامة على لارافيل و ووردبريس

قبل أن ننتقل إلى المقارنة بين إطاري العمل، لنلقِ نظرة سريعة عامة عليهما.

نظرة عامة على لارافيل

لارافيل هو إطار عمل framework لتطوير الويب يعتمد على لغة PHP ويكتسب شعبية متزايدة بين المطورين، وقد اكتسب شعبيته نظرًا لصياغته المحسنّة وتوثيقه الشامل ووجود مجتمع داعم كبير ونشط. تظهر قوة الإطار في إنتاج تطبيقات ويب مخصصة وقابلة للتوسع.

يقدم لارافيل مجموعة ملفتة من الميزات ويضم طبقة ORM فعّالة للتفاعل مع قاعدة البيانات حيث توفر هذه الطبقة واجهة لتمثيل الجداول في قاعدة البيانات ككائنات objects. ومنظومة توجيه Routing قوية، وصياغة قواعدية Syntax سهلة الفهم. تجعل هذه الميزات من لارافيل خيارًا ممتازًا للمطورين الذي يرغبون في بناء تطبيقات أكثر تخصصًا وقدرة على التكيف.

نظرة عامة على ووردبريس

تخطى ووردبريس الغاية الأصلية له كمنصة لإنشاء المدونات وتعداها ليصبح نظام إدارة محتوى Content Management System متعدد المهام يدعم أكثر من 40% من مواقع الويب عالميًا، ولا تزال سمعته كمنصة لإنشاء وإدارة محتوى ويب سهل الاستخدام لا جدال فيها.

تمكن ووردبريس من جذب الكثير من الاهتمام بفضل واجهته الواضحة سهلة الاستخدام والعدد الكبير من القوالب والإضافات التي يوفرها وسهولة تشغيله. ويعد إطاراً مناسبًا للأفراد أو الأعمال الصغيرة التي تطمح إلى تأسيس موقع ويب دون الحاجة إلى خبرة تقنية كبيرة.

مقارنة سريعة بين لارافيل و ووردبريس

المقارنة الشاملة بين لارافيل و ووردبريس

بعد أن تعرفنا سريعًا على كلتا المنصتين، بإمكاننا الآن المقارنة بينهما من عدة نواحٍ:

1- الأداء وإمكانية التوسع

تعد ميزات الأداء والتوسع ذات أهمية كبيرة في تطوير الويب حاليًا لأنها تؤثر بشكل كبير على تجربة المستخدمين، وزمن تحميل الصفحات، والاستجابة الكلية للتطبيق أو الموقع. لنوضح كيف تتعامل كلتا المنصتين مع هذه النواحي الحيوية:

لارافيل

لارفيل هو إطار عمل للغة PHP كما ذكرنا سابقًا، لهذا يستخدم مجموعة من التقنيات لتحسين الأداء وتنفيذ العمليات بسلاسة. ونظرًا لكون لارافيل مبني على الوحدات البرمجية وتوسيع الشيفرة فهو يتيح للمطورين بناء تطبيقات قادرة على النمو. ومن خلال دعم لارافيل لإمكانيات التوسع الأفقي، فإنه يستطيع إدارة التطبيقات الموزعة على عدة خوادم باستخدام أدوات مثل موازنات الحمل. كما يسهل لارافيل التعامل مع المهام المتزامنة كونه يدعم أنظمة الأرتال queueing systems مثل Redis و RabbiMO. إضافة إلى ذلك، تستفيد منصة لارافيل من فعالية محرّك PHP الذي يُحدّث ويُحسّن باستمرار.

ووردبريس

بُني نظام ووردبريس بشكل رئيسي باستخدام PHP، وقد خضع لترقيات مهمة في السنوات الأخيرة لتحسين الأداء قدر الإمكان. يوفر ووردبريس مكتبة واسعة من الإضافات والقوالب التي تسمح للمستخدمين يتطوير وتخصيص مواقعهم بسرعة وسهولة.

وعلى الرغم من أن نظام ووردبريس قد صمم أساسًا لبناء مواقع ويب صغيرة الحجم ومحدودة الموارد، إلا أنه يسمح لنا بتعزيز موارد الموقع عند الحاجة  باستخدام إضافات التخزين المؤقت، وشبكات توزيع المحتوى CDN، واستخدام بيئة استضافة محسنة لإدارة حركة البيانات الكثيفة فهذه التقنيات تعزز أداء مواقع ووردبريس بشكل كبير.

2- سهولة التطوير

يضع المطورون الأولوية لسهولة تطوير التطبيقات عند اختيارهم لأي منصة أو إطار العمل. لهذا، نناقش في هذه الفقرة الفرق بين لارافيل و ووردبريس من ناحية منحنيات التعلم والموارد والتوثيق ودعم المجتمع الخاص بكل إطار.

لارافيل

يتميز لارافيل بصياغته القواعدية الأنيقة وميزاته المصممة خصيصًا لتسهيل عمل المطورين، وأولوياته في دعم سهولة تطوير المنتجات. إذ يقدم لارافيل أساس برمجي واضح البناء ومباشر وشيفرة سهلة الصيانة. وتبسط بيئة عمل لارافيل التي تضم حزم مضمّنة جاهزة المهام البرمجية الشائعة مثل التوجيه routing والاستيثاق authentication والتفاعل مع قواعد البيانات والتخزين المؤقت للبيانات.

تتمحور فلسفة لارافيل الجوهرية حول فكرة إنتاجية المطور وسهولة الاستخدام، وتعزز إمكانية إعادة استخدام الشيفرة لتسهيل صيانة وتحديث المنتج.

ووردبريس

تدور فكرة التطوير في ووردبريس حول البساطة وسهولة الوصول، فهو يزود المستخدم بلوحة إدارة سهلة الاستخدام لتسريع إدارة المحتوى وتخصيصه. وتُعد قوالب وإضافات ووردبريس عناصر بناء التطبيقات التي تسمح للمطور بتوسيع التصميم ووظائف التطبيق دون العودة إلى نقطة الصفر.

وتمكّن خطافات ووردبريس hooks ومرشحاته filters وقوالبه ذات البنية الهرمية وميزة التحديث التلقائي من بناء أقسام مميزة في مواقع الويب، وتعديل الوظائف البنيوية وضمان بقاء الموقع محدّثًا بأدنى جهد ممكن.

3- سهولة الاستخدام

تؤثر سهولة استخدام المنصات على تجربة المستخدم ورضاه، لنلق نظرة الآن على ما يقدمه كل من لارافيل و ووردبريس في هذا الشأن

لارافيل

يركز لارافيل على سهولة الاستخدام من قبل المطورين أساسًا وبعدها سهولة الاستخدام من قبل المستخدم النهائي، حيث يوفر للمطور قاعدة واضحة وسهلة القراءة لكتابة الشيفرة. كما يبسّط التوثيق الشامل والهيكلية الجيدة للواجهات البرمجية من عملية التطوير.

كما صممت ميزات لارافيل مثل التوجيه routing وإدارة قواعد البيانات والتوثيق لتكون سهلة الاستخدام من قبل المطورين، مما يعطي فعالية أكبر في التطوير دون المساس بالمرونة.

ووردبريس

يتمير ووردبريس بسهولة الاستخدام، سواء للمطورين أو المستخدمين غير المختصين. إذ فهو يوفر للمستخدمين واجهة سهلة الاستخدام، إضافة إلى لوحة تحكم واضحة ومكتبات كثيرة للقوالب والإضافات ويوفر أدوات لبناء الصفحات عبر تقنية السحب والإفلات، مما يجعل تخصيص مواقع الويب أمرًا سهلًا دون الحاجة إلى خبرات برمجية كبيرة.

4- الأمان والصيانة

يعد موضوع الأمان والصيانة من أكثر الأمور أهمية عند اختيار منصة العمل، لنلق نظرة على ما تقدمه لارافيل و ووردبريس في هاتين الناحيتين.

لارافيل

يقدم لارافيل حماية مضمّنة من ثغرات الويب الشائعة مثل السكربتات العابرة للمواقع cross-site scripting وسكربتات انتحال الشخصية request forgery وهجوم حقن SQL. إذ يتجاوز باني الاستعلامات وطبقة ORM في لارافيل أي محارف مشبوهة في مدخلات المستخدم للحماية من حقن SQL، وتدعم كلمات السر المرمّزة بما في ذلك ميزات أمنية مثل مفاتيح التحقق CSFR والتعامل الآمن مع الجلسات.

ووردبريس

يلتزم ووردبريس بتقديم منصة آمنة وتنفيذ معايير أمنية متعددة. وتستهدف تحديثاتها المنتظمة الثغرات التي تظهر ويراقب فريق متخصص المشاكل الأمنية بنشاط ويستجيب لأي مشكلات قد تظهر لاحقًا. إضافة إلى ذلك، يحسن ووردبريس من القدرات الأمنية للتطبيقات من خلال إضافات مخصصة تقدم ميزات مثل فحص البرمجيات الضارة والحماية خلف جدار ناري وتسجيل الدخول الآمن.

5- الشعبية

تلعب شعبية المنصة دورًا مهمًا في اختيارها، فهي تعكس نسبة تبني هذه المنصة والدعم المقدم من مجتمعها وطبيعة بيئة العمل فيها.

لارافيل

يعود سبب الزيادة الكبيرة في شعبية لارافيل إلى الدعم القوي الذي يقدمه مجتمع دعم المنصة وبيئة العمل التي تدعم التوسع.

المصدر trends.builtwith

يضمن التطوير الفعال للارافيل والتحديثات المستمرة التي تنفذ عليها وصول المطورين إلى أحدث الميزات والتحسينات والتحديثات الأمنية. وتشير شعبية لارافيل المتزايدة إلى الطلب الكبير عليه في سوق العمل، وهذا ما يقدم فرص عمل أوسع لمطوري لارافيل المحترفين.

ووردبريس

ترجع شعبية ووردبريس إلى القاعدة المعرفية الواسعة لهذه المنصة والدعم الكافي من قبل مجتمعها.

المصدر trends.builtwith

تساعد القوالب والإضافات الكثيرة والمتنوعة في تقديم تصاميم ووظائف مختلفة، كما تثري التطويرات المستمرة التي يقدمها مجتمع ووردبريس من بيئة العمل وتعززها.

6- الاستضافة

إن اختيار الاستضافة المناسبة لموقعنا أو تطبيقنا أمر حيوي جدًا لأدائه وأمانه وتوفّره المستمر. لنرى كيف يكون نهج الاستضافة في كلتا المنصتين.

لارافيل

لا تتطلب منصة لارافيل أية متطلبات خاصة بالاستضافة نظرًا لمرونتها وكونها إطار عمل للغة PHP. ويمكن للمطورين الاستفادة من مزودات الاستضافة التي تقدم عروضًا مخصصة لمنصة لارافيل أو التي تقدم بيئة عمل محسنة للتطبيقات المبنية على هذه المنصة.

ووردبريس

صممت منصة ووردبريس لتكون متوافقة مع عدد كبير من بيئات الاستضافة، لكن علينا التفكير بعدة عوامل مثل أداء الخادم وسعة التخزين وحزمة تخديم البيانات ودعم العملاء عند البحث عن استضافة مناسبة لووردبريس. كما تقدم مزودات الاستضافة المخصصة لإدارة تطبيقات ووردبريس إعدادات محسنة للخادم وتحديثات تلقائية وميزات أمان إضافية.

المقارنة بين لارافيل و ووردبريس من ناحية التكلفة

من الأمور المهمة جدًا في المقارنة بين لارافيل ووردبريس مسألة التكلفة المادية. فمعرفة هيكلية التسعير وخيارات الاستضافة ستساعدنا في اختيار الحل الأكثر فعالية.

تكلفة لارافيل

لارافيل بحد ذاته مجاني الاستخدام، لكن أي مساعدة في تطوير تطبيقات لارافيل وصيانتها لن تكون رخيصة. وقد يكون مجال تلك التكلفة في الولايات المتحدة الأمريكية مثلًا بين 20-100 دولار في الساعة، مما يجعل كلفة موقع الويب بأكمله بين 3000 و 250 ألف دولار، وفقًا لمتطلبات المشروع وتعقيدها، وبالطبع تختلف هذه الأرقام من منطقة جغرافية لأخرى. كما نضيف إلى ذلك كلفة الاستضافة وقيمتها بالحد الأدنى 10 دولارات شهريًا.

تكلفة ووردبريس

تختلف تكلفة تطبيقات ووردبريس بحسب إن كنا سنصمم التطبيق بأنفسنا أو نستعين بشركة أو وكالة تطوير. فقد يكلف التطبيق إن قررنا تصميمه بنفسنا بين 20 إلى 300 دولار كما يصل إلى مجال 500-5000 دولار في حال الاستعانة بمطور مستقل وترتفع تكلفة التطوير إلى 3000-100000 دولار إن أردنا الاعتماد على شركة تطوير، ومن جديد ننوه لأن هذه الأرقام  تختلف من منطقة جغرافية لأخرى.

وتتراوح نفقات الصيانة بين 25 دولار في الشهر للصيانة الذاتية وما بين 50 إلى 100 دولار إن استعنا بمطور مستقل، كما قد تصل إلى 450 دولار إن اعتمدنا على شركة مختصة. كما نضيف إلى ذلك كلفة الاستضافة بحد ذاتها والتي تختلف في حدها الأدنى وفق مزود الاستضافة، وقد لا تقل عن 10 دولار شهريًا.

وتتعلق تكلفة الاستضافة عمومًا بحجم الموقع وحجم تبادل البيانات المسموح شهريًا إضافة إلى بعض الميزات الأخرى التي تقع خارج إطار هذا المقال.

بإمكاننا بالطبع الاستفادة من المستقلين العرب المتواجدين في منصة مستقل منصة العمل العربي الأكثر شهرة لبناء تطبيقات ويب مميزة باستخدام لارافيل أو ووردبريس بحرفية عالية وأسعار مدروسة.

خلاصة: ما الخيار الأفضل لارافيل أم ووردبريس؟

يعتمد الخيار الأمثل على احتياجاتنا الخاصة وأهدافنا من التطبيق أو موقع الويب. إذ تكون لارافيل خيارًا مفضلًا عند إنشاء تطبيقات ويب مخصصة لأنها تقدم مرونة كبيرة وقابلية لتوسيع التطبيق وبيئة عمل قوية مفصلة خصيصًا للمطورين. بينما تشتهر ووردبريس في المقابل بسهولة استخدامها وفعاليتها في إدارة المحتوى وفهارسها التي تمتلئ بالقوالب والإضافات، مما يجعلها خيارًا مفضلًا للأعمال الفردية الصغيرة التي تهدف إلى تأسيس مكان على الإنترنت بسرعة. ومن الضروري جدًا أخذ متطلبات مشروعنا بعين الاعتبار، وخبراتنا في تطوير التطبيقات، ورؤيتنا المستقبلية للمنتج قبل أن نقرر ما هي المنصة الملائمة.

أسئلة شائعة

1- من أفضل لارافيل أم ووردبريس

الجواب: للمنصتين غايتان مختلفتان فلارافيل هو إطار عمل قوي للغة PHP يستخدم في تطوير تطبيقات الويب، بينما يشتهر ووردبريس بكونه نظام إدارة محتوى متألق في بناء المدونات ومواقع الويب. لهذا السبب، لا يمكن المقارنة بين المنصتين وفق هذا السياق.

3- هل ووردبريس سهل الاستخدام أكثر من لارافيل

الجواب: يصنف ووردبريس بأنه أسهل استخدامًا وأبسط تعلمًا من لارافيل. فواجهته الواضحة وسهولة استخدامه عند إنشاء مواقع الويب وإدارة محتوياتها تجعله مفضلًا للمبتدئين الذين يفتقرون إلى الخبرة التقنية في مجال تطوير الويب، بينما يحتاج لارافيل في المقابل إلى معرفة برمجية جيدة لتطوير تطبيقات ويب فعالة.

4- متى نفضل لارافيل على ووردبريس

الجواب: لارافيل هو الحل المناسب لبناء تطبيقات ويب معقدة بوظائف خاصة وقدرة على التوسع والتخصيص. بينما ووردبريس هو خيار مثالي عند بناء مواقع ويب هدفها الأساسي تقديم محتوى مثل المدونات والمواقع التعريفية، لأنه يقدم طريقة سريعة في إعداد الموقع من خلال عمليات واضحة وسهلة الاستخدام.

ترجمة -وبتصرف- لمقال: Laravel vs WordPress: choosing the Ideal platform for your peb development needs لكاتبه Inshal Ali

اقرأ أيضًا

• تعرف على إطار عمل تطوير الويب الشهير لارافيل Laravel
• إنشاء واجهة أمامية لمدونة باستخدام لارافيل
• أفضل الحزم البرمجية لتحسين تطبيقات لارافيل
• تعلم PHP
• تعلم ووردبريس

هل سبق وشعرتم أنكم تكررون كتابة نفس الشيفرة لتنفيذ مهام روتينية شائعة في مشاريع لارافيل؟ وأن بناء ميزات التطبيق من الصفر تستهلك الكثيرمن الوقت وتبطئ العمل! يمكن حل معظم هذه المشكلات باستخدام حزم لارافيل، وهي وحدات برمجية جاهزة وقابلة للاستخدام المتكرر لتنفيذ المهام والوظائف الشائعة، حيث تسهل تلك الحزم مسار عملنا وتعزز أمان تطبيقاتنا وتحسن وظائفها.

نتحدث في هذا المقال عن حزم لارافيل ونستكشف أنواعها ونبحث في الفرق بين الحزم packages والتجميعات bundles، ونعرض قائمة بأفضل الحزم لبناء تطبيقات أسرع.

فهرس المقال

• مفهوم الحزمة package في لارافيل
• الفرق بين الحزم packages والتجميعات bundles
• أنواع حزم لارافيل
• قائمة بأفضل حزم لارافيل
• حزم تطوير لارافيل
• حزم أمان لارافيل
• حزم لوحة تحكم الإدارة في لارافيل
• حزم لارافيل المخصصة للتجارة الإلكترونية
• حزم لارافيل لتحسين محركات البحث
• حزم لارافيل المخصصة لتنقيح الشيفرة
• حزم اختبار لارافيل

مفهوم الحزمة package في لارافيل

تُعد الحزمة package بمثابة صندوق أدوات لكل مهام التطوير، وتكون الحزمة على شكل وحدات برمجية مبنية مسبقًا تقدم وظائف مخصصة لتطبيقات لارافيل. توفر الحزم وقت المطور لانها تلغي الحاجة إلى بناء التطبيق من الصفر وتسمح للمطور بالتركيز على الميزات الجوهرية للتطبيق.

الفرق بين حزم وتجميعات لارفيل

يستخدم كلا المصطلحين حزمة Package وتجميعة Bundle للإشارة إلى نفس التقنية غالبًا على الرغم من وجود اختلاف صغير بينهما:

أنواع حزم لارافيل

تأتي حزم لارافيل ضمن فئتين أساسيتين: حزنم مستقلة عن إطار العمل، وحزم مخصصة لإطار عمل

الحزم المخصصة لإطار العمل

صُمِّمت هذه الحزم خصيصًا لإطار العمل لارفيل. وتعزز هذه الحزم ميزات لارافيل وتقاليد الاستخدام وهندستها لتقديم وظائف مخصصة لتطبيقاتها. من الأمثلة عنها نجد حزم الاستيثاق وموسعّات العمل مع التخزين المؤقت.

الحزم المستقلة عن إطار العمل

لا ترتبط هذه الحزم بإطار عمل لارافيل ويمكن استخدامها في أي مشروع PHP بصرف النظر عن إطار العمل. تقدم هذه الحزم ميزات لا تتعلق بهندسة لارافيل مما يجعلها متعددة الاستخدامات في مشارع PHP المتنوعة. من الأمثلة عنها نجد مكتبات العمل مع قواعد البيانات وأدوات التحقق من استمارات الويب.

قائمة بأفضل حزم لارفيل

إليك قائمة بأفضل حزم لارافيل وفقًا لوظائفها المقدمة:

حزم تطوير لارافيل

تبسِّط حزم التطوير مسار العمل بقديمها أدوات تنقيح وتصريف أصول وتوليد شيفرة برمجية.

1. الحزمة Laravel Debugbar

تضيف هذه الحزمة الأساسية صندوق أدوات تطوير وتعطينا تلميحات مباشرة عن أداء التطبيق. إذ تعرض الحزمة استعلامات قواعد البيانات والقوالب المصيّرة والمعاملات المُمرَّرة، كما تساعدنا على إضافة رسائل مخصصة لتسهيل التنقيح، وبالتالي زمنًا أكبر في تطوير التطبيق بدلًا من تخمين المشكلات.

Debugbar::**info**($object);
Debugbar::**error**('Error!');
Debugbar::**warning**('Watch out…');
Debugbar::**addMessage**('Another message', 'mylabel')

2. الحزمة Laravel User Verification

تبسّط الحزمة Laravel User Verification تقديم المستخدم إلى الموقع حيث تتحقق من البريد الإلكتروني وصلاحيته. كما تزيد الأداة من مرونة تخصيص قوالب البريد الإلكتروني ومنطق التحقق وتجربة المستخدم كي تتلائم تمامًا مع احتياجات التطبيق، وهي تتكامل بسهولة مع نظام الاستيثاق والتنبيهات في لارافيل مما يساعد على ادخار وقت وجهد المطورين.

public function **register**(Request $request)
{
$this->**validator**($request->**all**())->**validate**();
$user = $this->**create**($request->**all**());
**event**(new **Registered**($user));
$this->**guard**()->**login**($user);
UserVerification::**generate**($user);
UserVerification::**send**($user, 'My Custom E-mail Subject');
return $this->**registered**($request, $user)
    ?: **redirect**($this->**redirectPath**());
 }

3. الحزمة Socialite

طوِّرت حزمة Laravel Socialite من قبل فريق لارافيل لتسهيل عمليات تسجيل الدخول على منصات التواصل الاجتماعي مثل فيسبوك وجوجل وإكس، وهي تتكامل مع نظام الاستيثاق والتنبيهات في لارافيل وتتولى تعقيدات تطبيق بروتوكول OAuth وراء الكواليس دون تدخل منا كي تساعدنا على التركيز على تطوير ميزات التطبيق الأساسية.

$user = Socialite::**driver**('github')->**user**();
// OAuth Two Providers
$token = $user->token;
$refreshToken = $user->refreshToken; // not always provided
$expiresIn = $user->expiresIn;
// All Providers
$user->**getId**();
$user->**getName**();
$user->**getEmail**();
$user->**getAvatar**();

4. الحزمة Laravel Mix

تقدم الحزمة Laravel Mix أداة بسيطة وسهلة الاستخدام لتصريف أصول تطبيق لارافيل. حلّت هذه الحزمة مكان Laravel Elixir وهي تقدم واجهة برمجية واضحة وسهلة الاستخدام لتحديد خطوات بناء التطبيق بطريقة فعالة.

تتكامل الأداة بسهول مع أداة التحزيم Webpack مما يحسن ميزة استبدال الوحدات البرمجية أثناء التنفيذ HMR والمزامنة مع المتصفح، مما يساعد في رؤية التغييرات مباشرة دون إعادة تحميل يدوي ويوفر وقت المطورين.

mix.**js**('resources/assets/js/app.js', 'public/js')
 .**sass**('resources/assets/sass/app.scss', 'public/css');

5. الحزمة Eloquent-Sluggable

تقدم Eloquent-Sluggable أداة مفيدة لتوليد عناوين لطيفة slug بعناوين URL وفقًا لخاصيات نموذجنا وبطريقة مؤتمتة، منشئة عناوين تساعد في تحسين محركات البحث في تطبيقك.

كما تقدم الحزمة خيارت لتخصيص حقول العناوين الملحقة والفواصل separators وسلوك التحديث. كما توفر أيضًا خطافات لمعالجة الحالات الخاصة وتتكامل مع منطق التطبيق للتأكد من تحسين عناوين URL.

class Post extends Eloquent
{
 use Sluggable;
 protected $fillable = ['title'];
 public function **sluggable**() {
    return [
     'slug' => [
       'source' => ['title']
     ]
   ];
 }
 }
 $post = new **Post**([
 'title' => 'My Awesome Blog Post',
 ]);
 // $post->slug is "my-awesome-blog-post

6. الحزمة Migrations Generator

تحلل الحزمة Laravel Migrations Generator تخطيط قاعدة البيانات وتولد ملفات التهجير migration files تلقائيًا، مما يوفر علينا الوقت ويساعدنا على التركيز على منطق تطوير التطبيق وليس كتابة تلك الملفات. ويمكننا بكل بساطة تنفيذ أمر التهجير لكل جداول قاعدة البيانات معًا وترك الأمر لهذه الحزمة.

php artisan migrate:generate

//بالإمكان اختيار جداول معينة فقط

php artisan migrate:generate table1,table2

7. الحزمة Laravel Backup

تساعدنا الحزمة Laravel Backup في إنشاء نسخ احتياطية عن ملفاتنا عن طريق ضغط المجلدات وقاعدة البيانات في ملف snapshot واحد لضمان حماية وتأمين المشروع، وذلك من خلال تنفيذ أمر واحد.

php artisan backup:run

8. الحزمة Laravel IDE Helper

تحسن هذه الأداة الأساسية IDE Helper تجربتنا مع محررات الأكواد وبيئات التطوير مثل  PhpStorm و VS Code من خلال ميزات عديدة منها الإكمال التلقائي للشيفرة، والتلميح بالنوع خصيصًا لمكونات لارافيل، فلن نضطر مع هذه الأداة إلى البحث عن التعليمات بل سنعرض تلميحات وتوجيهات مباشرة عن التوابع والمعاملات المتاحة. كما تولد الأداة تعليقات توثيقية لتسهّل علينا التنقل ضمن واجهة لارافيل البرمجية ضمن بيئة التطوير التي تفضلها.

حزم أمان لارافيل

تساعد حزم الأمان في دعم أمان التطبيق من خلال ميزات مثل الاستيثاق والأذونات المبنية على أدوار محددة والتكامل مع خدمة reCAPTCHA.

9. الحزمة Entrust

تساعدنا Entrust في تحديد دور كل مستخدم وتسند إليه أذونات أو سماحيات محددة، وبالتالي سيتمكن المستخدم من الوصول إلى وظائف محددة مسبقًا فقط مما يحسن أمان التطبيق. تنشئ هذه الحزمة الجداول الأربعة التالية لأدوار المستخدمين:

• جدول أدوار لتخزين سجلات الأدوار
• جدول الأذونات لتخزين سجلت السماحيات
• جدول أدوار-مستخدم role-user لتخزين علاقات واحد-إلى-أكثر بين الأدوار والمستخدمين
• جدول أذونات-دور permission_role لتخزين علاقات واحد-إلى-أكثر بين الأدوار والأذونات

بإمكاننا إنشاء دور بتنفيذ أسطر الشيفرة التالية:

admin = new **Role**();
$admin->name = 'admin';
$admin->display_name = 'User Administrator'; // optional
$admin->description = 'User is allowed to manage and edit other users'; // optional
$admin->**save**()

نسند الدور إلى المستخدم كالتالي:

user = User::**where**('username', '=', 'michele')->**first**();
$user->**attachRole**($admin);

ثم علينا تحديد الأذونات الخاصة بالدور:

$createPost = new **Permission**();
$createPost->name     = 'create-post';
$createPost->display_name = 'Create Posts';
$createPost->description = 'create new blog posts';
$createPost->**save**();
$admin->**attachPermission**($createPost);

10. الحزمة No Captcha

تعمل الحزمة No Captcha على تحقيق تكامل لتطبيق لارافيل مع خدمة reCAPTCHA من جوجل لحمايته من الروبوتات  الآلية bots وتضيف طبقة أمان إضافية إليه. لهذا، ننصح بالحصول على مفتاح الواجهة البرمجية API المجاني لهذه الحزمة وحماية التطبيقات.

تقدم الحزمة أيضًا خيارات مخصصة لعنصر التحكم CAPTCHA كي نضمن اندماجه مع تصميم الاستمارات Forms بكل بساطة ودون التأثير على تجربة المستخدم.

NoCaptcha::**shouldReceive**('verifyResponse')
->**once**()
->**andReturn**(true);
$response = $this->**json**('POST', '/register', [
'g-recaptcha-response' => '1',
'name' => 'Pardeep',
'email' => 'pardeep@example.com',
'password' => '123456',
'password_confirmation' => '123456',
]);

حزم لوحة تحكم إدارة لارافيل

تساعد حزم إدارة لوحة التحكم على بناء واجهات سهلة الاستخدام للوحات التحكم لمدير الواجهة الخلفية للتطبيقات

11. Voyager

قد يكون بناء لوحة تحكم مدير  واضحة وسهلة أمرًا يستهلك الكثير من وقت المطور، لكن الحزمة Voyager ستبسط العملية من خلال واجهة سهلة الاستخدام. تتميز الحزمة بتوثيقها الجيد وتتضمن واجهة واضحة وسهلة الاستخدام، وتوفر بيانات مخصصة للاختبارات ومدير وسائط متعددة متقدم. وتساعدنا في التركيز على بناء وظائف تطبيقات لارافيل لتتكفل هي بإنشاء لوحات التحكم.

12. الحزمة LaraAdmin

تُعد LaraAdmin حزمة مجانية قوية ومفتوحة المصدرية لتطوير لارافيل، حيث تسهِّل إنشاء لوحة تحكم إدارة التطبيق بتقديمها ميزات مثل إدارة المستخدمين، والوصول المشروط بالدور الممنوح للمستخدم، والقوائم الديناميكية.

تقدم الأداة أيضًا جداول بيانات سهلة التخصيص تدعم الفرز والترشيح وتعدد الصفحات مما يسمح بإدارة البيانات المعقدة بكل سهولة. لهذا ستساعدنا هذه الأداة في التركيز على البناء الوظيفي لتطبيقات لارافيل وتتكفل هي بإنشاء واجهات الإدارة.

13. الحزمة Orchid

تُقدم الحزمة Orchid صندوق أدوات يتمتع بتصميم مرن وقابل للتوسع، مما يسمح ببناء واجهات سهلة الاستخدام مفصلة خصيصًا لتلائم تطبيقاتنا. وتتجاوز الأداة إنشاء لوحات تحكم بسيطة وتتصرف كمنظومة لإدارة تطبيقات الويب. إذ يمكن التفكير بها على أنها منظومة إدارة محتوى تسهل إدارة المحتوى والمستخدمين في تطبيقات لارافيل.

حزم لارافيل المخصصة للتجارة الإلكترونية

تساعدنا هذه الحزم في تسريع تطوير المتاجر الإلكترونية من خلال ميزاتها المتعددة مثل إدارة المنتجات وعربات التسوق وبوابات الدفع الإلكتروني.

14. الحزمة Bagisto

تُعد Bagisto حزمة مفتوحة المصدر مخصصة لمتاجر لارافيل الإلكترونية التي تلفت انتباه المطورين بسرعة. إذ تقدم نظام إدارة مستخدمين سهل مع خيارات متعددة لإدارة المخازن وغيرها من الميزات.

كما تُجمّع الحزمة Laravel CMS مع أدوات تسهل التنقل بين الأقسام المختلفة ضمن لوحة التحكم، وتقدم وظائف كثيرة للمتجر مثل تعدد العملات، وتخصيص الموقع الجغرافي للمتجر، وتحديد مستويات للوصول إلى البيانات، والتكامل مع بوابات الدفع الإلكتروني وغيرها من الميزات.

15. الحزمة AvoRed

تسمح الحزمة AvoRed بتخصيص حزمة تسوق لارافيل مفتوحة المصدر بسهولة وحسب الحاجة، وتقدم افتراضيًا واجهة سهلة الاستخدام في الأجهزة المحمولة وتضم أفضل حزم تحسين محركات البحث في لارافيل.

تسمح لك الأداة ببناء كيانات مفيدة مثل الفئات categories والسمات attributes وغيرها، وتقدم إمكانيات فعالة في إدارة طلبات الشراء وتتبّعها وإدارة معلومات العملاء والمتاجر وغيرها.

حزم لارافيل لتحسين محركات البحث

تساعد هذه الحزم في تحسين تطبيقات لارافيل كي يسهل إيجادها من قبل محركات البحث وذلك من خلال إدارة بيانات الوسوم الوصفية للموقع أو التطبيق وإدارة خارطة الموقع والبيانات المهيكلة.

16. الحزمة Laravel Meta Manager

تساعد الأداة Laravel Meta Manager في تحسين ظهور صفحاتنا في محركات البحث ورفع ترتيبها ضمن صفحات نتائج البحث. حيث توضح بيانات الوسوم Meta tag وتسمح بتصحيحها باتباع أفضل الممارسات المتبعة في تحسين محركات البحث.

تأتي الحزمة مع مجموعة وسوم ميتا جاهزة وموصى بها تتضمن Standard SEO و Dublin Core و Google Plus و Facebook Open Graph وغيرها. فبعد إتمام الإعداد، كل ما علينا هو إضافة هذه الوسوم المتولّدة إلى ترويسة الصفحة التي تريد كالتالي:

@**include**('meta::manager')

يستخدم الأمر السابق الإعدادات المعرفة سابقًا لإعادة تعيين الوسوم الوصفية، لكن إن أدرنا تعريف خيارات محددة بسرعة دون تدقيق، نستطيع استخدام الشيفرة التالية:

 @**include**('meta::manager', [
  'title'     => 'My Example Title',
  'description'  => 'This is my example description',
  'image'     => 'Url to the image',
 ])

وإليكم مثالًا:

<html lang="en">
  <head>
    <meta charset="UTF-8">
    <title>Document</title>
    @**include**('meta::manager', [
      'title'     => 'My Example Title',
      'description'  => 'This is my example description',
      'image'     => '',
    ])
  </head>
  <body>
  </body>
</html>

17. الحزمة SEOTools

تسمح SEOTools بتحسين محركات البحث في تطبيقات لارافيل وفقًا لأفضل الممارسات، وتقدم ميزات تحسين ممتازة لمواقع الويب. ومن السهل دمج الحزمة مع المشاريع ولها واجهة سهلة الاستخدام بالنسبة للمبتدئين، كما تسمح بضبط العناوين والوسوم الوصفية لكل من منصة إكس و Open Graph.

18. الحزمة Laravel-SEO

تساعدنا الحزمة Laravel-SEO في التحكم الكامل بقدرة تطبيقنا على تحسين محركات البحث وتبسّط إدارة الوسوم الوصفية من ناحية الإضافة والتحرير والحذف. وتسمح أيضًا بإضافة بيانات مهيكلة لتحسين نتائج محركات البحث وإدارة الوسوم الوصفية للمنصات الشهيرة مثل Open Graph و Dublin Core دون أي جهد، مما يزيد ظهور تطبيق لارافيل ويعزز ترتيبه في نتائج البحث.

حزم تنقيح لارافيل

تركز هذه الحزم على سلوك التطبيق من خلال أدوات التنقيح وتحليل الأداء.

19. الحزمة Laravel Telescope

تُعد الحزمة Laravel Telescope أداة فعالة في يد مطوري لارافيل، إذ تكشف لنا كل ما يحدث خلف الستار، وتتعقب الطلبات القادمة وتنفيذها والسجلات واستعلامات قواعد البيانات وغيرها.

وتقدم الأداة ملاحظات مباشرة على سلوك التطبيق أثناء التنفيذ، مما يسمح بتحديد وإصلاح الثغرات بفعالية. تجعل هذه الميزات من Laravel Telescope أداة أساسية لأي مطور لارافيل يعمل في بيئة تطور محلية.

حزم اختبار لارافيل

تساعدك هذه الحزم على تحسين نوعية الشيفرة وإمكانية صيانتها من خلال إعداد اختبارات وحدات واختبارات تكامل فعالة.

20. الحزمة Orchestral Testbench

لن نتمكن من الوصول إلى جميع مساعدي اختبار لارافيل test helpers عندما نكتب الحزمة بنفسنا. فإن أردنا كتابة اختبارات لحزمتنا كما لو كانت ضمن تطبيق لارافيل نمطي ننصح باستخدام Orchestral Testbench package كالتالي:

1. ضبط ملف Composer.json للحزمة الجديدة
2. إضافة مزود خدمة
3. ضبط الأسماء المستعارة Alias
4. إنشاء صنف واجهة facade class

هذه الخطوات الأربعة مهمة جدًا في كتابة حزمة لارافيل لتسريع الإنتاجية.

الخلاصة

قدمنا في هذا المقال قائمة بأفضل حزم لارافيل التي تساعدنا على تحسين إنتاجية تطبيقاتنا. ويعتمد اختيار أفضل حزم لارافيل على متطلبات المشروع بالدرجة الأولى. وطالما أن لارافيل تسهل على المطور تنفيذ عمليات مخصصة يحددونها بأنفسهم، سيكون استخدام تلك الحزم مساعدًا في تنفيذ تلك المهام الوظيفية بفعالية أكبر.

أسئلة شائعة

1. ما هي حزم لارافيل؟

الحزم في PHP هي مجموعة من الوجهات routes والمتحكمات controllers والعروض views المهيأة لتوسيع وظائف تطبيق لارافيل.

2. ماهي التجميعة في لارافيل؟

هي تقنية قّدمت أول مرة في لارافيل 3.0، وهي طريقة لتجميع الشيفرة ضمن مكونات يمكن إضافتها إلى تطبيقات لارافيل. ولن يضطر المطور من إنشاء تلك المكونات من الصفر دائمًا عند استخدام التجميعات.

ترجمة -وبتصرف- للمقال: Best laravel packages to optimize performance, security and SEO in 2024

اقرأ أيضًا

• استخدام عمليات CRUD لإنشاء مدونة بسيطة في لارافيل
• تجريد إعداد قواعد البيانات في لارافيل باستعمال عملية التهجير Migration والبذر Seeder
• تعرف على مفهوم إطار العمل Framework وأهميته في البرمجة
• تعرف على لغة PHP

سننشئ في هذا المقال الأخير من هذه السلسلة جزء الواجهة الأمامية من التطبيق، ولكن لنضع خطة أولًا، حيث سيكون لدينا الصفحة الرئيسية لتطبيق المدونة التي تعرض قائمة بجميع المنشورات الحديثة، وصفحة فئة Category المنشور التي تعرض قائمة المنشورات ضمن فئة معينة، وصفحة الوسم Tag التي تعرض قائمة المنشورات التي لها وسم مُحدَّد، وصفحة المنشور التي تعرض محتوى منشور معين، وصفحة بحث تعرض قائمة المنشورات بناءً على استعلام بحث معين.

كما ستحتوي جميع هذه الصفحات على شريط جانبي مع مربع بحث وقائمة الفئات والوسوم، وستحتوي صفحة المنشور أيضًا على قسم المنشورات ذات الصلة في نهايتها.

تحدّثنا عن قاعدة البيانات والنماذج Models في المقال السابق، وسنبدأ الآن بالوِجهات Routes.

إنشاء الوِجهات

ننشئ الوِجهات في لارافيل ضمن الملف routes/web.php كما يلي:

. . .

// الصفحة الرئيسية
Route::get('/', [PostController::class, 'home'])->name('home');

// قائمة المنشورات ضمن هذه الفئة
Route::get('/category/{category}', [CategoryController::class, 'category'])->name('category');

// قائمة المنشورات التي لها هذا الوسم
Route::get('/tag/{tag}', [TagController::class, 'tag'])->name('tag');

// عرض منشور واحد
Route::get('/post/{post}', [PostController::class, 'post'])->name('post');

// قائمة المنشورات بناء على استعلام البحث
Route::post('/search', [PostController::class, 'search'])->name('search');

. . .

الصفحة الرئيسية

يكون لكل من هذه الوِجهات تابع تحكم مقابل، حيث سنبدأ أولًا بالمتحكم home()‎ إذًا لنضع ما يلي في الملف app/Http/Controllers/PostController.php:

<?php

namespace App\Http\Controllers;

use App\Models\Category;
use App\Models\Post;
use App\Models\Tag;
use Illuminate\Contracts\View\View;
use Illuminate\Http\RedirectResponse;
use Illuminate\Http\Request;
use Illuminate\Http\Response;
use Illuminate\Support\Facades\Auth;
use Illuminate\Database\Eloquent\Builder;

class PostController extends Controller
{
   /**
    * عرض الصفحة الرئيسية
    */
   public function home(): View
   {
       $posts = Post::where('is_published', true)->paginate(env('PAGINATE_NUM'));
       $categories = Category::all();
       $tags = Tag::all();

       return view('home', [
           'posts' => $posts,
           'categories' => $categories,
           'tags' => $tags
       ]);
   }

   . . .
}

هناك شيئان يجب عليك ملاحظتهما في السطر 20 من الشيفرة البرمجية السابقة وهما:

• أولًا، تتأكد التعليمة where('is_published', true)‎ من استرداد المقالات المنشورة فقط.
• ثانيًا، يُعَد التابع paginate()‎ أحد توابع لارافيل Laravel المُضمَّنة، مما يسمح لك بإنشاء ترقيم للصفحات Pagination في تطبيقك بسهولة. يأخذ التابع paginate()‎ عددًا صحيحًا كدخل، فمثلًا يمثّل paginate(10)‎ عرض 10 عناصر في كل صفحة، وسيُستخدَم متغير الدخل في العديد من الصفحات، لذا يمكنك إنشاء متغير بيئة في ملف ‎.env كما يلي، ثم يمكنك استرداده في أيّ مكان باستخدام التابع env()‎:

. . .
PAGINATE_NUM=12

لننشئ الآن عرض View الصفحة الرئيسية المقابل. اطّلع على بنية القوالب التي أنشأئاها، وإليك بنية العروض التالية:

resources/views
├── category.blade.php
├── home.blade.php
├── layout.blade.php
├── post.blade.php
├── search.blade.php
├── tag.blade.php
├── vendor
│   ├── list.blade.php
│   └── sidebar.blade.php
└── welcome.blade.php

سنبدأ أولًا بالعرض layout.blade.php الذي يمثل تخطيط الصفحة كما يلي:

<!doctype html>
<html lang="en">
 <head>
   <meta charset="UTF-8" />
   <meta http-equiv="X-UA-Compatible" content="IE=edge" />
   <meta name="viewport" content="width=device-width, initial-scale=1.0" />
   @vite(['resources/css/app.css', 'resources/js/app.js']) @yield('title')
 </head>

 <body class="container mx-auto font-serif">
   <nav class="flex flex-row justify-between h-16 items-center border-b-2">
     <div class="px-5 text-2xl">
       <a href="/"> My Blog </a>
     </div>
     <div class="hidden lg:flex content-between space-x-10 px-10 text-lg">
       <a
         href="https://github.com/ericnanhu"
         class="hover:underline hover:underline-offset-1"
         >GitHub</a
       >
       <a
         href="{{ route('dashboard') }}"
         class="hover:underline hover:underline-offset-1"
         >Dashboard</a
       >
       <a href="#" class="hover:underline hover:underline-offset-1">Link</a>
     </div>
   </nav>

   @yield('content')

   <footer class="bg-gray-700 text-white">
     <div
       class="flex justify-center items-center sm:justify-between flex-wrap lg:max-w-screen-2xl mx-auto px-4 sm:px-8 py-10"
     >
       <p class="font-serif text-center mb-3 sm:mb-0">
         Copyright ©
         <a href="https://www.ericsdevblog.com/" class="hover:underline"
           >Eric Hu</a
         >
       </p>

       <div class="flex justify-center space-x-4">. . .</div>
     </div>
   </footer>
 </body>
</html>

يستخدم لارافيل الأداة Vite افتراضيًا لتجميع أصول المشروع كما في السطر 8، وثبّتنا الحزمة Breeze من لارافيل في المقال السابق، وتستخدم هذه الحزمة إطار عمل Tailwind CSS، حيث سيستورد السطر 8 من الشيفرة البرمجية السابقة تلقائيًا الملفين app.css و app.js المقابلَين. يمكنك استخدام إطار عمل مختلف أيضًا، ولكن يجب أن تعود إلى توثيقه للحصول على تفاصيل حول كيفية استخدامه مع لارافيل أو Vite.

لننشئ الآن عرض الصفحة الرئيسية resources/views/home.blade.php كما يلي:

@extends('layout') @section('title')
<title>Home</title>
@endsection @section('content')
<div class="grid grid-cols-4 gap-4 py-10">
 <div class="col-span-3 grid grid-cols-1">@include('vendor.list')</div>
 @include('vendor.sidebar')
</div>
@endsection

ويكون عرض قائمة المنشورات resources/views/vendor/list.blade.php كما يلي:

<!-- قائمة المنشورات -->
<div class="grid grid-cols-3 gap-4">
 @foreach ($posts as $post)
 <!-- المنشور -->
 <div class="mb-4 ring-1 ring-slate-200 rounded-md h-fit hover:shadow-md">
   <a href="{{ route('post', ['post' => $post->id]) }}"
     ><img
       class="rounded-t-md object-cover h-60 w-full"
       src="{{ Storage::url($post->cover) }}"
       alt="..."
   /></a>
   <div class="m-4 grid gap-2">
     <div class="text-sm text-gray-500">
       {{ \Carbon\Carbon::parse($post->created_at)->format('M d, Y') }}
     </div>
     <h2 class="text-lg font-bold">{{ $post->title }}</h2>
     <p class="text-base">
       {{ Str::limit(strip_tags($post->content), 150, '...') }}
     </p>
     <a
       class="bg-blue-500 hover:bg-blue-700 rounded-md p-2 text-white uppercase text-sm font-semibold font-sans w-fit focus:ring"
       href="{{ route('post', ['post' => $post->id]) }}"
       >Read more →</a
     >
   </div>
 </div>
 @endforeach
</div>

{{ $posts->links() }}

يولّد السطر 9 Storage::url($post->cover)‎ عنوان URL الذي يؤشّر إلى صورة الغلاف. لا تُعَد الطريقة التي يخزن بها لارافيل العلامات الزمنية Timestamps سهلة الاستخدام، لذلك استخدمنا حزمة Carbon في السطر 14 لإعادة تنسيق العلامات الزمنية.
استخدمنا أيضًا الدالة strip_tags()‎ في السطر 18 لإزالة وسوم HTML، ثم تحدِّد الدالة limit()‎ الحد الأقصى لطول السلسلة، وستوضَع نقاط ... مكان الجزء الزائد منها. استخدمنا التابع paginate()‎ لإنشاء مرقّم الصفحات في المتحكم، ولكن يمكننا عرض مرقّم الصفحات في العرض باستخدام التعليمة ‎{{ $posts->links() }}‎ الموجودة في السطر 30.

لننشئ الآن عرض الشريط الجانبي resources/views/vendor/sidebar.blade.php كما يلي:

<div class="col-span-1">
 <div class="border rounded-md mb-4">
   <div class="bg-slate-200 p-4">Search</div>
   <div class="p-4">
     <form
       action="{{ route('search') }}"
       method="POST"
       class="grid grid-cols-4 gap-2"
     >
       {{ csrf_field() }}
       <input
         type="text"
         name="q"
         id="search"
         class="border rounded-md w-full focus:ring p-2 col-span-3"
         placeholder="Search something..."
       />
       <button
         type="submit"
         class="bg-blue-500 hover:bg-blue-700 rounded-md p-2 text-white uppercase font-semibold font-sans w-full focus:ring col-span-1"
       >
         Search
       </button>
     </form>
   </div>
 </div>
 <div class="border rounded-md mb-4">
   <div class="bg-slate-200 p-4">Categories</div>
   <div class="p-4">
     <ul class="list-none list-inside">
       @foreach ($categories as $category)
       <li>
         <a
           href="{{ route('category', ['category' => $category->id]) }}"
           class="text-blue-500 hover:underline"
           >{{ $category->name }}</a
         >
       </li>
       @endforeach
     </ul>
   </div>
 </div>
 <div class="border rounded-md mb-4">
   <div class="bg-slate-200 p-4">Tags</div>
   <div class="p-4">
     @foreach ($tags as $tag)
     <span class="mr-2"
       ><a
         href="{{ route('tag', ['tag' => $tag->id]) }}"
         class="text-blue-500 hover:underline"
         >{{ $tag->name }}</a
       ></span
     >
     @endforeach
   </div>
 </div>
 <div class="border rounded-md mb-4">
   <div class="bg-slate-200 p-4">More Card</div>
   <div class="p-4">
     <p>
       Lorem ipsum dolor sit amet consectetur adipisicing elit. Placeat,
       voluptatem ab tempore recusandae sequi libero sapiente autem! Sit hic
       reprehenderit pariatur autem totam, voluptates non officia accusantium
       rerum unde provident!
     </p>
   </div>
 </div>
 <div class="border rounded-md mb-4">
   <div class="bg-slate-200 p-4">...</div>
   <div class="p-4">
     <p>
       Lorem ipsum dolor sit amet consectetur adipisicing elit. Placeat,
       voluptatem ab tempore recusandae sequi libero sapiente autem! Sit hic
       reprehenderit pariatur autem totam, voluptates non officia accusantium
       rerum unde provident!
     </p>
   </div>
 </div>
</div>

صفحة الفئة Category

ضع ما يلي في ملف المتحكم app/Http/Controllers/CategoryController.php:

<?php

namespace App\Http\Controllers;

use App\Models\Category;
use App\Models\Tag;
use Illuminate\Contracts\View\View;
use Illuminate\Http\RedirectResponse;
use Illuminate\Http\Request;
use Illuminate\Http\Response;

class CategoryController extends Controller
{
   /**
    * عرض قائمة المنشورات التي تنتمي إلى الفئة
    */
   public function category(string $id): View
   {
       $category = Category::find($id);
       $posts = $category->posts()->where('is_published', true)->paginate(env('PAGINATE_NUM'));
       $categories = Category::all();
       $tags = Tag::all();

       return view('category', [
           'category' => $category,
           'posts' => $posts,
           'categories' => $categories,
           'tags' => $tags
       ]);
   }

   . . .
}

ويكون عرض الفئة المقابل resources/views/category.blade.php كما يلي:

@extends('layout') @section('title')
<title>Category - {{ $category->name }}</title>
@endsection @section('content')
<div class="grid grid-cols-4 gap-4 py-10">
 <div class="col-span-3 grid grid-cols-1">@include('vendor.list')</div>
 @include('vendor.sidebar')
</div>
@endsection

صفحة الوسم Tag

ضع ما يلي في ملف المتحكم app/Http/Controllers/TagController.php:

<?php

namespace App\Http\Controllers;

use App\Models\Category;
use App\Models\Tag;
use Illuminate\Contracts\View\View;
use Illuminate\Http\RedirectResponse;
use Illuminate\Http\Request;
use Illuminate\Http\Response;

class TagController extends Controller
{
   /**
    * عرض قائمة المنشورات التي تنتمي إلى الوسم
    */
   public function tag(string $id): View
   {
       $tag = Tag::find($id);
       $posts = $tag->posts()->where('is_published', true)->paginate(env('PAGINATE_NUM'));
       $categories = Category::all();
       $tags = Tag::all();

       return view('tag', [
           'tag' => $tag,
           'posts' => $posts,
           'categories' => $categories,
           'tags' => $tags
       ]);
   }
   . . .
}

ويكون عرض الوسم المقابل resources/views/tag.blade.php كما يلي:

@extends('layout') @section('title')
<title>Tag - {{ $tag->name }}</title>
@endsection @section('content')
<div class="grid grid-cols-4 gap-4 py-10">
 <div class="col-span-3 grid grid-cols-1">@include('vendor.list')</div>
 @include('vendor.sidebar')
</div>
@endsection

صفحة المنشور

ضع ما يلي في ملف المتحكم app/Http/Controllers/PostController.php:

<?php

namespace App\Http\Controllers;

use App\Models\Category;
use App\Models\Post;
use App\Models\Tag;
use Illuminate\Contracts\View\View;
use Illuminate\Http\RedirectResponse;
use Illuminate\Http\Request;
use Illuminate\Http\Response;
use Illuminate\Support\Facades\Auth;
use Illuminate\Database\Eloquent\Builder;

class PostController extends Controller
{
   . . .

   /**
    * عرض المنشور المطلوب
    */
   public function post(string $id): View
   {
       $post = Post::find($id);
       $categories = Category::all();
       $tags = Tag::all();
       $related_posts = Post::where('is_published', true)->whereHas('tags', function (Builder $query) use ($post) {
           return $query->whereIn('name', $post->tags->pluck('name'));
       })->where('id', '!=', $post->id)->take(3)->get();

       return view('post', [
           'post' => $post,
           'categories' => $categories,
           'tags' => $tags,
           'related_posts' => $related_posts
       ]);
   }

   . . .
}

لاحظ في السطور من 27 إلى 29 أن هذه هي الطريقة التي يمكننا من خلالها استرداد المنشورات ذات الصلة، حيث نريد الحصول على المنشورات التي يكون لها الوسوم نفسها. قد تبدو سلسلة هذه التوابع مخيفة نوعًا ما، لكن لا تقلق بشأن ذلك، حيث سنوضّحها واحدًا تلو الآخر كما يلي:

• يعيد التابع الأول where('is_published', true)‎ جميع المنشورات التي نشرناها.
• تتعقد الأمور بعض الشيء عند التابع whereHas()‎، حيث إذا أردنا فهم هذا التابع، فيجب أن نتحدث أولًا عن التابع has()‎، وهو تابع Laravel Eloquent الذي يسمح لنا بالتحقق من وجود علاقة كما في المثال التالي:

$posts = Post::has('comments', '>', 3)->get();

ستسترد الشيفرة البرمجية السابقة جميع المنشورات التي تحتوي على أكثر من 3 تعليقات، ولاحظ أنه لا يمكنك استخدام where()‎ لإنجاز ذلك، لأن comments ليس عمودًا في الجدول posts، بل هو جدول آخر له علاقة بالجدول posts. يعمل التابع whereHas()‎ مثل التابع has()‎ تمامًا، ولكنه يوفر مزيدًا من القوة، فالمعامل الثاني هو دالة تسمح بفحص محتوى جدول آخر، وهو الجدول tags في حالتنا، ويمكننا الوصول إلى الجدول tags من خلال المتغير ‎$q.

• يأخذ التابع whereIn()‎ في السطر 28 معاملَين هما: الأول هو العمود المحدَّد، والثاني هو مصفوفة من القيم المقبولة. يعيد هذا التابع السجلات ذات القيم المقبولة فقط ويستبعد الباقي.
• يجب أن تكون بقية التوابع سهلة الفهم، حيث يستبعد التابع where('id', '!=', $post->id)‎ المنشور الحالي، ويأخذ التابع take(3)‎ السجلات الثلاثة الأولى.

يكون عرض المنشور المقابل resources/views/post.blade.php كما يلي:

@extends('layout')

@section('title')
<title>Page Title</title>
@endsection

@section('content')
<div class="grid grid-cols-4 gap-4 py-10">
   <div class="col-span-3">

       <img class="rounded-md object-cover h-96 w-full" src="{{ Storage::url($post->cover) }}" alt="..." />
       <h1 class="mt-5 mb-2 text-center text-2xl font-bold">{{ $post->title }}</h1>
       <p class="mb-5 text-center text-sm text-slate-500 italic">By {{ $post->user->name }} | {{ \Carbon\Carbon::parse($post->created_at)->format('M d, Y') }}</p>

       <div>{!! $post->content !!}</div>

       <div class="my-5">
           @foreach ($post->tags as $tag)
           <a href="{{ route('tag', ['tag' => $tag->id]) }}" class="text-blue-500 hover:underline" mr-3">#{{ $tag->name }}</a>
           @endforeach
       </div>

       <hr>

       <!-- المنشورات ذات الصلة -->

       <div class="grid grid-cols-3 gap-4 my-5">
           @foreach ($related_posts as $post)
           <!-- المنشور -->
           <div class="mb-4 ring-1 ring-slate-200 rounded-md h-fit hover:shadow-md">
               <a href="{{ route('post', ['post' => $post->id]) }}"><img class="rounded-t-md object-cover h-60 w-full" src="{{ Storage::url($post->cover) }}" alt="..." /></a>
               <div class="m-4 grid gap-2">
                   <div class="text-sm text-gray-500">
                       {{ \Carbon\Carbon::parse($post->created_at)->format('M d, Y') }}
                   </div>
                   <h2 class="text-lg font-bold">{{ $post->title }}</h2>
                   <p class="text-base">
                       {{ Str::limit(strip_tags($post->content), 150, '...') }}
                   </p>
                   <a class="bg-blue-500 hover:bg-blue-700 rounded-md p-2 text-white uppercase text-sm font-semibold font-sans w-fit focus:ring" href="{{ route('post', ['post' => $post->id]) }}">Read more →</a>
               </div>
           </div>
           @endforeach
       </div>

   </div>
   @include('vendor.sidebar')
</div>
@endsection

يُعَد ‎{!! $post->content !!}‎ في السطر 15 هو الوضع الآمن في لارافيل، حيث يخبر لارافيل بعرض وسوم HTML بدلًا من عرضها كنص عادي.

صفحة البحث

ضع ما يلي في ملف المتحكم app/Http/Controllers/PostController.php:

<?php

namespace App\Http\Controllers;

use App\Models\Category;
use App\Models\Post;
use App\Models\Tag;
use Illuminate\Contracts\View\View;
use Illuminate\Http\RedirectResponse;
use Illuminate\Http\Request;
use Illuminate\Http\Response;
use Illuminate\Support\Facades\Auth;
use Illuminate\Database\Eloquent\Builder;

class PostController extends Controller
{
   . . .

   /**
    * عرض نتيجة البحث
    */
   public function search(Request $request): View
   {
       $key = $request->input('q');
       $posts = Post::where('title', 'like', "%{$key}%")->orderBy('id', 'desc')->paginate(env('PAGINATE_NUM'));
       $categories = Category::all();
       $tags = Tag::all();

       return view('search', [
           'key' => $key,
           'posts' => $posts,
           'categories' => $categories,
           'tags' => $tags,
       ]);
   }

   . . .
}

يكون عرض البحث المقابل resources/views/search.blade.php كما يلي:

@extends('layout') @section('title')
<title>Search - {{ $key }}</title>
@endsection @section('content')
<div class="grid grid-cols-4 gap-4 py-10">
 <div class="col-span-3 grid grid-cols-1">@include('vendor.list')</div>
 @include('vendor.sidebar')
</div>
@endsection

ترجمة -وبتصرُّف- للمقال Laravel for Beginners #5 - Create the Frontend لصاحبه Eric Hu.

اقرأ أيضًا

• المقال السابق: لارافيل للمبتدئين-الجزء الرابع: إنشاء لوحة تحكم لموقع مدونة بسيطة
• تعرف على إطار عمل تطوير الويب الشهير لارافيل Laravel
• كيف تستخدم منشئ الاستعلامات Query builder للتخاطب مع قاعدة البيانات في Laravel
• تجريد إعداد قواعد البيانات في لارافيل باستعمال عملية التهجير Migration والبذر Seeder

سننشئ في هذا المقال تطبيق مدونة باستخدام لارافيل ونجعل تطبيقنا كامل الميزات ويحتوي على منشورات وفئات Categories ووسوم Tags، حيث ناقشنا في المقال السابق عمليات CRUD للمنشورات، وسنكرر اليوم هذه العمليات نفسها على كل من الفئات والوسوم، كما سنناقش كيفية التعامل مع العلاقات فيما بينها.

تهيئة مشروع لارافيل جديد

سنبدأ بمشروع لارافيل جديد، حيث سننشئ مجلد العمل وننتقل إليه، ولكن تأكّد من تشغيل دوكر Docker، ثم نفّذ الأمر التالي:

curl -s https://laravel.build/<app_name> | bash

انتقل إلى مجلد التطبيق وابدأ تشغيل الخادم كما يلي:

cd <app_name>

./vendor/bin/sail up

لننشئ اسمًا بديلًا للأداة sail لتسهيل الأمور، لذا شغّل الأمر التالي:

alias sail='[ -f sail ] && sh sail || sh vendor/bin/sail'

يمكنك من الآن فصاعدًا تشغيل الأداة Sail مباشرةً دون تحديد المسار بأكمله كما يلي:

sail up

استيثاق المستخدم User authentication

يأتي إطار عمل لارافيل مع نظام بيئي كبير فهو  يحتوي على العديد من الأدوات والموارد الإضافية التي تسهل على المطورين برمجة التطبيقات، وتُعَد حزمة Breeze من لارافيل جزءًا من هذا النظام، فهي توفر طريقة سريعة لإعداد استيثاق المستخدم وتسجيله في تطبيق لارافيل. تتضمّن حزمة Breeze عروضًا Views ومتحكّمات Controllers مبنية مسبقًا خاصة بالاستيثاق، بالإضافة إلى مجموعة من واجهات برمجة التطبيقات الخلفية للتعامل مع استيثاق المستخدم وتسجيله، وصُمِّمت هذه الحزمة لتكون سهلة التثبيت والضبط مع وجود الحد الأدنى من الإعداد المطلوب.

استخدم الأوامر التالية لتثبيت حزمة Breeze من لارافيل:

sail composer require laravel/breeze --dev
sail artisan breeze:install
sail artisan migrate
sail npm install
sail npm run dev

ستولّد هذه العملية تلقائيًا كل من المتحكمات والبرمجيات الوسيطة والعروض المطلوبة اللازمة لإنشاء نظام استيثاق مستخدم أساسي في تطبيقك. يمكنك الوصول إلى صفحة التسجيل من العنوان http://127.0.0.1/register، ثم تسجّل حسابًا جديدًا وسيُعاد توجيهك إلى لوحة التحكم.

لن نناقش في هذا المقال كيفية عمل نظام استيثاق المستخدم، لأنه يرتبط ببعض المفاهيم المتقدمة إلى حدٍ ما، ولكن يوصَى بشدة بإلقاء نظرة على الملفات التي تولّدت هنا، فهي توفر نظرة أعمق حول كيفية العمل في لارافيل.

إعداد قاعدة البيانات

يجب بعد ذلك أن يكون لدينا تصور حول كيفية ظهور تطبيق المدونة، حيث نحتاج أولًا إلى قاعدة بيانات يمكنها تخزين المنشورات والفئات والوسوم، وسيكون لكل جدول قاعدة بيانات البنيةُ التالية:

جدول المنشورات Posts:

جدول الفئات Categories:

جدول الوسوم Tags:

يجب أن يكون هناك أيضًا جدول للمستخدمين users، ولكن لاحاجة لأن ننشئه فقد ولّدته حزمة Breeze من لارافيل مسبقًا، لذا سنتخطى هذه الخطوة حاليًا.

يكون لهذه الجداول علاقات مع بعضها البعض كما هو موضح فيما يلي:

• كل مستخدم لديه منشورات متعددة.
• كل فئة لديها العديد من المنشورات.
• كل وسم لديه العديد من المنشورات.
• يعودة كل منشور إلى مستخدم واحد.
• يعود كل منشور إلى فئة واحدة.
• كل منشور له العديد من الوسوم.

يمكننا إنشاء هذه العلاقات، ولكن يجب تعديل جدول المنشورات كما يلي:

جدول المنشورات مع العلاقات:

ونحتاج أيضًا إلى جدول منفصل لعلاقة المنشور مع الوسم كما يلي:

جدول يمثل علاقة المنشور مع الوسم Post/Tag:

تطبيق بنية قاعدة البيانات

يمكن تطبيق التصميم السابق من خلال توليد النماذج Models وملفات التهجير Migration باستخدام الأوامر التالية:

sail artisan make:model Post --migration

sail artisan make:model Category --migration

sail artisan make:model Tag --migration

بالإضافة إلى توليد ملف تهجير منفصل للجدول post_tag باستخدام الأمر التالي:

sail artisan make:migration create_post_tag_table

وسينشأ ملف التهجير database/migrations/create_posts_table.php التالي:

<?php

use Illuminate\Database\Migrations\Migration;
use Illuminate\Database\Schema\Blueprint;
use Illuminate\Support\Facades\Schema;

return new class extends Migration
{
   /**
    * تشغيل عمليات التهجير
    */
   public function up(): void
   {
       Schema::create('posts', function (Blueprint $table) {
           $table->id();
           $table->timestamps();
           $table->string('title');
           $table->string('cover');
           $table->text('content');
           $table->boolean('is_published');

           $table->bigInteger('user_id');
           $table->bigInteger('category_id');
       });
   }

   /**
    * عكس عمليات التهجير
    */
   public function down(): void
   {
       Schema::dropIfExists('posts');
   }
};

وسينشأ ملف التهجير database/migrations/create_categories_table.php التالي:

<?php

use Illuminate\Database\Migrations\Migration;
use Illuminate\Database\Schema\Blueprint;
use Illuminate\Support\Facades\Schema;

return new class extends Migration
{
   /**
    * تشغيل عمليات التهجير
    */
   public function up(): void
   {
       Schema::create('categories', function (Blueprint $table) {
           $table->id();
           $table->timestamps();
           $table->string('name');
       });
   }

   /**
    * عكس عمليات التهجير
    */
   public function down(): void
   {
       Schema::dropIfExists('categories');
   }
};

وسينشأ ملف التهجير database/migrations/create_tags_table.php التالي:

<?php

use Illuminate\Database\Migrations\Migration;
use Illuminate\Database\Schema\Blueprint;
use Illuminate\Support\Facades\Schema;

return new class extends Migration
{
   /**
    * تشغيل عمليات التهجير
    */
   public function up(): void
   {
       Schema::create('tags', function (Blueprint $table) {
           $table->id();
           $table->timestamps();
           $table->string('name');
       });
   }

   /**
    * عكس عمليات التهجير
    */
   public function down(): void
   {
       Schema::dropIfExists('tags');
   }
};

وسينشأ أيضُا ملف التهجير database/migrations/create_post_tag_table.php التالي:

<?php

use Illuminate\Database\Migrations\Migration;
use Illuminate\Database\Schema\Blueprint;
use Illuminate\Support\Facades\Schema;

return new class extends Migration
{
   /**
    * تشغيل عمليات التهجير
    */
   public function up(): void
   {
       Schema::create('post_tag', function (Blueprint $table) {
           $table->id();
           $table->timestamps();
           $table->bigInteger('post_id');
           $table->bigInteger('tag_id');
       });
   }

   /**
    * عكس عمليات التهجير
    */
   public function down(): void
   {
       Schema::dropIfExists('post_tag');
   }
};

طبّق هذه التغييرات باستخدام الأمر التالي:

sail artisan migrate

يجب بعد ذلك تفعيل الإسناد الجماعي Mass Assignment لحقول محدَّدة بالنسبة للنماذج المقابلة حتى نتمكّن من استخدام تابعَي create أو update معها كما ناقشنا في المقال السابق، ويجب أيضًا تعريف العلاقات بين جداول قاعدة البيانات.

سيكون ملف النموذج app/Models/Post.php كما يلي:

<?php

namespace App\Models;

use Illuminate\Database\Eloquent\Factories\HasFactory;
use Illuminate\Database\Eloquent\Model;
use Illuminate\Database\Eloquent\Relations\BelongsTo;
use Illuminate\Database\Eloquent\Relations\BelongsToMany;

class Post extends Model
{
   use HasFactory;

   protected $fillable = [
       "title",
       'content',
       'cover',
       'is_published'
   ];

   public function user(): BelongsTo
   {
       return $this->belongsTo(User::class);
   }

   public function category(): BelongsTo
   {
       return $this->belongsTo(Category::class);
   }

   public function tags(): BelongsToMany
   {
       return $this->belongsToMany(Tag::class);
   }
}

وسيكون ملف النموذج app/Models/Category.php كما يلي:

<?php

namespace App\Models;

use Illuminate\Database\Eloquent\Factories\HasFactory;
use Illuminate\Database\Eloquent\Model;
use Illuminate\Database\Eloquent\Relations\HasMany;

class Category extends Model
{
   use HasFactory;

   protected $fillable = [
       'name',
   ];

   public function posts(): HasMany
   {
       return $this->hasMany(Post::class);
   }
}

ويكون ملف النموذج app/Models/Tag.php كما يلي:

<?php

namespace App\Models;

use Illuminate\Database\Eloquent\Factories\HasFactory;
use Illuminate\Database\Eloquent\Model;
use Illuminate\Database\Eloquent\Relations\BelongsToMany;

class Tag extends Model
{
   use HasFactory;

   protected $fillable = [
       'name',
   ];

   public function posts(): BelongsToMany
   {
       return $this->belongsToMany(Post::class);
   }
}

ويكون ملف النموذج app/Models/User.php كما يلي:

<?php

namespace App\Models;

// use Illuminate\Contracts\Auth\MustVerifyEmail;
use Illuminate\Database\Eloquent\Factories\HasFactory;
use Illuminate\Database\Eloquent\Relations\HasMany;
use Illuminate\Foundation\Auth\User as Authenticatable;
use Illuminate\Notifications\Notifiable;
use Laravel\Sanctum\HasApiTokens;

class User extends Authenticatable
{
   use HasApiTokens, HasFactory, Notifiable;

   /**
    * السمات‫ Attributes التي نسندها إسنادًا جماعيًا
    *
    * @var array<int, string>
    */
   protected $fillable = [
       'name',
       'email',
       'password',
   ];

   /**
    * ‫السمات التي يجب أن تكون مخفية لعملية السَلسلة Serialization
    *
    * @var array<int, string>
    */
   protected $hidden = [
       'password',
       'remember_token',
   ];

   /**
    * السمات التي يجب تغيير نوعها‫ Cast
    *
    * @var array<string, string>
    */
   protected $casts = [
       'email_verified_at' => 'datetime',
   ];

   public function posts(): HasMany
   {
       return $this->hasMany(Post::class);
   }
}

المتحكمات Controllers والوِجهات Routes

نحتاج إلى إنشاء متحكم موارد واحد لكل مورد (منشور وفئة ووسم) باستخدام الأوامر التالية:

php artisan make:controller PostController --resource

php artisan make:controller CategoryController --resource

php artisan make:controller TagController --resource

ننشئ بعد ذلك وِجهات لكل من هذه المتحكمات في الملف routes/web.php كما يلي:

<?php

use App\Http\Controllers\CategoryController;
use App\Http\Controllers\PostController;
use App\Http\Controllers\ProfileController;
use App\Http\Controllers\TagController;
use Illuminate\Support\Facades\Route;

// وِجهات لوحة التحكم
Route::prefix('dashboard')->group(function () {

   // الصفحة الرئيسية للوحة التحكم
   Route::get('/', function () {
       return view('dashboard');
   })->name('dashboard');

   // مورد الفئة للوحة التحكم
   Route::resource('categories', CategoryController::class);

   // مورد الوسم للوحة التحكم
   Route::resource('tags', TagController::class);

   // مورد المنشور للوحة التحكم
   Route::resource('posts', PostController::class);

})->middleware(['auth', 'verified']);

Route::middleware('auth')->group(function () {
   Route::get('/profile', [ProfileController::class, 'edit'])->name('profile.edit');
   Route::patch('/profile', [ProfileController::class, 'update'])->name('profile.update');
   Route::delete('/profile', [ProfileController::class, 'destroy'])->name('profile.destroy');
});

require __DIR__ . '/auth.php';

لاحظ تجميع جميع الوِجهات باستخدام البادئة ‎/dashboard، ويكون للمجموعة البرمجيةُ الوسيطة auth، مما يعني أنه يجب على المستخدم تسجيل الدخول للوصول إلى لوحة التحكم.

متحكمات الفئة والوسم Category/Tag

يُعََد المتحكمان CategoryController و TagController واضحَين إلى حدٍ ما، ويمكنك إعدادهما بالطريقة نفسها التي أنشأنا بها المتحكم PostController في المقال السابق.

إذًا لننشئ أولًا متحكم الفئة app/Http/Controllers/CategoryController.php كما يلي:

<?php

namespace App\Http\Controllers;

use App\Models\Category;
use Illuminate\Contracts\View\View;
use Illuminate\Http\RedirectResponse;
use Illuminate\Http\Request;
use Illuminate\Http\Response;

class CategoryController extends Controller
{
   /**
    * عرض قائمة الموارد
    */
   public function index(): View
   {
       $categories = Category::all();

       return view('categories.index', [
           'categories' => $categories
       ]);
   }

   /**
    * عرض الاستمارة الخاصة بإنشاء مورد جديد
    */
   public function create(): View
   {
       return view('categories.create');
   }

   /**
    * تخزين المورد الذي أنشأناه حديثًا في وحدة التخزين
    */
   public function store(Request $request): RedirectResponse
   {
       // الحصول على البيانات من الطلب
       $name = $request->input('name');

       // إنشاء نسخة جديدة من المنشور‫ Post ووضع البيانات المطلوبة في العمود المقابل
       $category = new Category();
       $category->name = $name;

       // حفظ البيانات
       $category->save();

       return redirect()->route('categories.index');
   }

   /**
    * عرض المورد المُحدَّد
    */
   public function show(string $id): View
   {
       $category = Category::all()->find($id);
       $posts = $category->posts();

       return view('categories.show', [
           'category' => $category,
           'posts' => $posts
       ]);
   }

   /**
    * عرض الاستمارة الخاصة بتعديل المورد المُحدَّد
    */
   public function edit(string $id): View
   {
       $category = Category::all()->find($id);

       return view('categories.edit', [
           'category' => $category
       ]);
   }

   /**
    * تحديث المورد المُحدَّد في وحدة التخزين
    */
   public function update(Request $request, string $id): RedirectResponse
   {
       // الحصول على البيانات من الطلب
       $name = $request->input('name');

       // البحث عن الفئة المطلوبة ووضع البيانات المطلوبة في العمود المقابل
       $category = Category::all()->find($id);
       $category->name = $name;

       // حفظ البيانات
       $category->save();

       return redirect()->route('categories.index');
   }

   /**
    * إزالة المورد المٌحدَّد من وحدة التخزين
    */
   public function destroy(string $id): RedirectResponse
   {
       $category = Category::all()->find($id);

       $category->delete();

       return redirect()->route('categories.index');
   }
}

ولننشئ الآن متحكم الوسم app/Http/Controllers/TagController.php كما يلي:

<?php

namespace App\Http\Controllers;

use App\Models\Tag;
use Illuminate\Contracts\View\View;
use Illuminate\Http\RedirectResponse;
use Illuminate\Http\Request;
use Illuminate\Http\Response;

class TagController extends Controller
{
   /**
    * عرض قائمة الموارد
    */
   public function index(): View
   {
       $tags = Tag::all();

       return view('tags.index', [
           'tags' => $tags
       ]);
   }

   /**
    * عرض الاستمارة الخاصة بإنشاء مورد جديد
    */
   public function create(): View
   {
       return view('tags.create');
   }
   /**
    * تخزين المورد الذي أنشأناه حديثًا في وحدة التخزين
    */
   public function store(Request $request): RedirectResponse
   {
       // الحصول على البيانات من الطلب
       $name = $request->input('name');

       // إنشاء نسخة جديدة من المنشور‫ Post ووضع البيانات المطلوبة في العمود المقابل
       $tag = new Tag();
       $tag->name = $name;

       // حفظ البيانات
       $tag->save();

       return redirect()->route('tags.index');
   }

   /**
    * عرض المورد المُحدَّد
    */
   public function show(string $id): View
   {
       $tag = Tag::all()->find($id);
       $posts = $tag->posts();

       return view('tags.show', [
           'tag' => $tag,
           'posts' => $posts
       ]);
   }

   /**
    * عرض الاستمارة الخاصة بتعديل المورد المُحدَّد
    */
   public function edit(string $id): View
   {
       $tag = Tag::all()->find($id);

       return view('tags.edit', [
           'tag' => $tag
       ]);
   }

   /**
    * تحديث المورد المُحدَّد في وحدة التخزين
    */
   public function update(Request $request, string $id): RedirectResponse
   {
       // الحصول على البيانات من الطلب
       $name = $request->input('name');

       // البحث عن الوسم المطلوب ووضع البيانات المطلوبة في العمود المقابل
       $tag = Tag::all()->find($id);
       $tag->name = $name;

       // حفظ البيانات
       $tag->save();

       return redirect()->route('tags.index');
   }

   /**
    * إزالة المورد المُحدَّد من وحدة التخزين
    */
   public function destroy(string $id): RedirectResponse
   {
       $tag = Tag::all()->find($id);

       $tag->delete();

       return redirect()->route('tags.index');
   }
}

تذكّر أنه يمكنك التحقق من اسم الوِجهات باستخدام الأمر التالي:

sail artisan route:list

متحكم المنشور Post

يُعَد متحكم المنشور PostController أكثر تعقيدًا بعض الشيء، إذ يجب عليك التعامل مع عمليات رفع الصور والعلاقات بين الجداول في قاعدة البيانات في التابع store()‎. إذًا لننشئ هذا المتحكم app/Http/Controllers/PostController.php كما يلي:

<?php

namespace App\Http\Controllers;

use App\Models\Category;
use App\Models\Post;
use App\Models\Tag;
use Illuminate\Contracts\View\View;
use Illuminate\Http\RedirectResponse;
use Illuminate\Http\Request;
use Illuminate\Http\Response;
use Illuminate\Support\Facades\Auth;
use Illuminate\Database\Eloquent\Builder;

class PostController extends Controller
{
   . . .

   /**
    * تخزين المورد الذي أنشأناه حديثًا في وحدة التخزين
    */
   public function store(Request $request): RedirectResponse
   {
       // الحصول على البيانات من الطلب
       $title = $request->input('title');
       $content = $request->input('content');

       if ($request->input('is_published') == 'on') {
           $is_published = true;
       } else {
           $is_published = false;
       }

       // ‫إنشاء نسخة جديدة من المنشور Post ووضع البيانات المطلوبة في العمود المقابل
       $post = new Post();
       $post->title = $title;
       $post->content = $content;
       $post->is_published = $is_published;

       // حفظ صورة الغلاف
       $path = $request->file('cover')->store('cover', 'public');
       $post->cover = $path;

       // ضبط المستخدم
       $user = Auth::user();
       $post->user()->associate($user);

       // ضبط الفئة
       $category = Category::find($request->input('category'));
       $post->category()->associate($category);

       // حفظ المنشور
       $post->save();

       // ضبط الوسوم
       $tags = $request->input('tags');

       foreach ($tags as $tag) {
           $post->tags()->attach($tag);
       }

       return redirect()->route('posts.index');
   }

   . . .
}

هناك بعض الأشياء التي يجب ملاحظتها في التابع store()‎، حيث سنستخدم في الأسطر من 28 إلى 32 مربع اختيار HTML لتمثيل الحقل is_published، وتكون قيمته إما 'on' أو null، ولكن تُحفَظ قيمته في قاعدة البيانات بوصفها true أو false، لذلك يجب استخدام التعليمة if لحل هذه المشكلة.

يمكننا استرداد الملفات في السطور من 41 إلى 42 من خلال استخدام التابع file()‎ بدلًا من التابع input()‎، ويُحفظ الملف في القرص public ضمن المجلد cover.

نحصل في السطور من 45 إلى 46 على المستخدم الحالي باستخدام التابع Auth::user()‎، ونربط المنشور بالمستخدم باستخدام التابع associate()‎، وتفعَل السطور من 49 إلى 50 الشيء نفسه بالنسبة للفئة، وتذكّر أنه يمكنك تطبيق ذلك فقط مع المتغير ‎$post وليس ‎$user أو ‎$category، لأن العمودان user_id و category_id موجودان في الجدول posts.

وأخيرًا، يجب حفظ المنشور الحالي في قاعدة البيانات، ثم استرداد قائمة الوسوم وإرفاق كل منها بالمنشور واحدًا تلوَ الآخر باستخدام التابع attach()‎ بالنسبة للوسوم كما هو موضح في السطور من 56 إلى 60.

تجري الأمور بطريقة مشابهة بالنسبة إلى التابع update()‎، باستثناء أنه يجب إزالة جميع الوسوم الموجودة قبل أن تتمكّن من إرفاق الوسوم الجديدة كما يلي:

$post->tags()->detach();

العروض Views

تذكر دائمًا أن تكون منظّمًا عند إنشاء نظام عرض، حيث سنتّبع البنية التالية في مثالنا:

resources/views
├── auth
├── categories
│   ├── create.blade.php
│   ├── edit.blade.php
│   ├── index.blade.php
│   └── show.blade.php
├── components
├── layouts
├── posts
│   ├── create.blade.php
│   ├── edit.blade.php
│   ├── index.blade.php
│   └── show.blade.php
├── profile
├── tags
│   ├── create.blade.php
│   ├── edit.blade.php
│   ├── index.blade.php
│   └── show.blade.php
├── dashboard.blade.php
└── welcome.blade.php

أنشأنا ثلاثة مجلدات هي: posts و categories و tags، ولكل منها أربعة قوالب هي: create و edit و index و show باستثناء المجلد posts، لأن وجود صفحة show للمنشورات في لوحة التحكم أمر غير ضروري.

يؤدي تضمين جميع هذه العروض في مقال واحد إلى جعل هذا المقال طويلًا بلا داعٍ، لذا سنوضّح فقط صفحات إنشاء وتعديل وفهرس المنشورات، ولكن يمكنك الاطلاع على الشيفرة المصدرية الكاملة على Github.

عرض إنشاء منشور

لننشئ أولًا عرض إنشاء المنشور resources/views/posts/create.blade.php كما يلي:

<x-app-layout>
 <x-slot name="header">
   <div class="flex justify-between">
     <h2
       class="font-semibold text-xl text-gray-800 dark:text-gray-200 leading-tight"
     >
       {{ __('Posts') }}
     </h2>
     <a href="{{ route('posts.create') }}">
       <x-primary-button>{{ __('New') }}</x-primary-button>
     </a>
   </div>

   <script
     src="https://cdn.tiny.cloud/. . ./tinymce.min.js"
     referrerpolicy="origin"
   ></script>
 </x-slot>

 <div class="py-12">
   <div class="max-w-7xl mx-auto sm:px-6 lg:px-8">
     <div class="p-4 sm:p-8 bg-white dark:bg-gray-800 shadow sm:rounded-lg">
       <div class="">
         <form
           action="{{ route('posts.store') }}"
           method="POST"
           class="mt-6 space-y-3"
           enctype="multipart/form-data"
         >
           {{ csrf_field() }}
           <input type="checkbox" name="is_published" id="is_published" />
           <x-input-label for="is_published"
             >Make this post public</x-input-label
           >
           <br />
           <x-input-label for="title">{{ __('Title') }}</x-input-label>
           <x-text-input
             id="title"
             name="title"
             type="text"
             class="mt-1 block w-full"
             required
             autofocus
             autocomplete="name"
           />
           <br />

           <x-input-label for="content">{{ __('Content') }}</x-input-label>
           <textarea
             name="content"
             id="content"
             cols="30"
             rows="30"
           ></textarea>
           <br />
           <x-input-label for="cover">{{ __('Cover Image') }}</x-input-label>
           <x-text-input
             id="cover"
             name="cover"
             type="file"
             class="mt-1 block w-full"
             required
             autofocus
             autocomplete="cover"
           />
           <br />
           <x-input-label for="category">{{ __('Category') }}</x-input-label>
           <select id="category" name="category">
             @foreach($categories as $category)
             <option value="{{ $category->id }}">{{ $category->name }}</option>
             @endforeach
           </select>
           <br />
           <x-input-label for="tags">{{ __('Tags') }}</x-input-label>
           <select id="tags" name="tags[]" multiple>
             @foreach($tags as $tag)
             <option value="{{ $tag->id }}">{{ $tag->name }}</option>
             @endforeach
           </select>
           <br />
           <x-primary-button>{{ __('Save') }}</x-primary-button>
         </form>
         <script>
           tinymce.init({. . .});
         </script>
       </div>
     </div>
   </div>
 </div>
</x-app-layout>

استخدمنا في مثالنا محرّر النصوص TinyMCE، ولكن يمكنك استخدام محرّر نصوص آخر عوضًا عنه، أو استخدم
العنصر <textarea></textarea> إذا أدرتَ ذلك.

يجب أن تحتوي الاستمارة الموجودة في السطر 24 على السمة التي هي enctype="multipart/form-data"‎ لأننا لا ننقل النصوص فحسب، بل توجد ملفات أيضًا. تذكر في السطر 59 استخدام السمة type="file"‎ لأننا نرفع صورة، وستُنقَل قيمة الخيار في السطور من 67 إلى 71 إلى الواجهة الخلفية.

هناك شيئان يجب الانتباه إليهما في الأسطر من 74 إلى 78، فلاحظ أولًا السمة name="tags[]"‎، حيث تخبر هذه الأقواس [] لارافيل بنقل مصفوفة قابلة للتكرار بدلًا من النصوص. ثانيًا، تنشئ السمة multiple استمارة متعددة التحديد بدلًا من تحديد فردي مثل استمارة الفئات.

عرض تعديل المنشور

لننشئ الآن العرض resources/views/posts/edit.blade.php كما يلي:

<x-app-layout>
 <x-slot name="header">
   <div class="flex justify-between">
     <h2
       class="font-semibold text-xl text-gray-800 dark:text-gray-200 leading-tight"
     >
       {{ __('Posts') }}
     </h2>
     <a href="{{ route('posts.create') }}">
       <x-primary-button>{{ __('New') }}</x-primary-button>
     </a>
   </div>

   <script
     src="https://cdn.tiny.cloud/. . ./tinymce.min.js"
     referrerpolicy="origin"
   ></script>
 </x-slot>

 <div class="py-12">
   <div class="max-w-7xl mx-auto sm:px-6 lg:px-8">
     <div class="p-4 sm:p-8 bg-white dark:bg-gray-800 shadow sm:rounded-lg">
       <div class="">
         <form
           action="{{ route('posts.update', ['post' => $post->id]) }}"
           method="POST"
           class="mt-6 space-y-3"
           enctype="multipart/form-data"
         >
           {{ csrf_field() }} {{ method_field('PUT') }}
           <input
             type="checkbox"
             name="is_published"
             id="is_published"
             @checked($post-
           />is_published)/>
           <x-input-label for="is_published"
             >Make this post public</x-input-label
           >

           <br />
           <x-input-label for="title">{{ __('Title') }}</x-input-label>
           <x-text-input
             id="title"
             name="title"
             type="text"
             class="mt-1 block w-full"
             required
             autofocus
             autocomplete="name"
             value="{{ $post->title }}"
           />
           <br />
           <x-input-label for="content">{{ __('Content') }}</x-input-label>
           <textarea name="content" id="content" cols="30" rows="30">
{{ $post->content }}</textarea
           >
           <br />
           <x-input-label for="cover"
             >{{ __('Update Cover Image') }}</x-input-label
           >
           <img
             src="{{ Illuminate\Support\Facades\Storage::url($post->cover) }}"
             alt="cover image"
             width="200"
           />
           <x-text-input
             id="cover"
             name="cover"
             type="file"
             class="mt-1 block w-full"
             autofocus
             autocomplete="cover"
           />
           <br />

           <x-input-label for="category">{{ __('Category') }}</x-input-label>
           <select id="category" name="category">
             @foreach($categories as $category)
             <option value="{{ $category->id }}" @selected($post->
               category->id == $category->id)>{{ $category->name }}
             </option>
             @endforeach
           </select>
           <br />
           <x-input-label for="tags">{{ __('Tags') }}</x-input-label>
           <select id="tags" name="tags[]" multiple>
             @foreach($tags as $tag)
             <option value="{{ $tag->id }}" @selected($post->
               tags->contains($tag))>{{ $tag->name }}
             </option>
             @endforeach
           </select>
           <br />
           <x-primary-button>{{ __('Save') }}</x-primary-button>
         </form>
         <script>
           tinymce.init({. . .});
         </script>
       </div>
     </div>
   </div>
 </div>
</x-app-layout>

لاحظ في السطور من 24 إلى 26 أن لغة HTML لا تدعم التابع PUT افتراضيًا، لذا نستخدم السمة method="POST"‎ ثم نخبر لارافيل باستخدام التابع PUT من خلال التعليمة ‎{{ method_field('PUT') }}‎.

عرض فهرس المنشورات

لننشئ الآن العرض resources/views/posts/index.blade.php كما يلي:

<x-app-layout>
 <x-slot name="header">
   <div class="flex justify-between">
     <h2
       class="font-semibold text-xl text-gray-800 dark:text-gray-200 leading-tight"
     >
       {{ __('Posts') }}
     </h2>
     <a href="{{ route('posts.create') }}">
       <x-primary-button>{{ __('New') }}</x-primary-button>
     </a>
   </div>
 </x-slot>

 <div class="py-12">
   <div class="max-w-7xl mx-auto sm:px-6 lg:px-8">
     @foreach($posts as $post)
     <div
       class="bg-white dark:bg-gray-800 overflow-hidden shadow-sm sm:rounded-lg mb-4 px-4 h-20 flex justify-between items-center"
     >
       <div class="text-gray-900 dark:text-gray-100">
         <p>{{ $post->title }}</p>
       </div>
       <div class="space-x-2">
         <a href="{{ route('posts.edit', ['post' => $post->id]) }}">
           <x-primary-button>{{ __('Edit') }}</x-primary-button></a
         >

         <form
           method="post"
           action="{{ route('posts.destroy', ['post' => $post->id]) }}"
           class="inline"
         >
           {{ csrf_field() }} {{ method_field('DELETE') }}
           <x-danger-button> {{ __('Delete') }} </x-danger-button>
         </form>
       </div>
     </div>
     @endforeach
   </div>
 </div>
</x-app-layout>

لاحظ أن زر الحذف ليس زرًا عاديًا، إذ يجب أن يكون استمارة مع تابع DELETE، لأن الرابط العادي يمتلك التابع GET فقط.

يُفترَض الآن أن تكون قادرًا على إنشاء بقية نظام العرض بسهولة.

لقطات الشاشة

وأخيرًا، إليك بعض لقطات الشاشة للوحة التحكم التي أنشأناها:

صفحة إدارة التصنيفات:

ننتقل لصفحة الإدارة كما يلي:

ثم نختار التصنيفات Categories من الصورة أعلاه لننتقل للصفحة التالية لإدارة التصنيفات:

صفحة إنشاء تصنيف جديد:

صفحة تحديث المنشور:

تابع معنا المقال التالي والأخير من هذه السلسلة حيث سننشئ فيه كل ما يخص الواجهة الأمامية من التطبيق كي يتمكن المستخدمون من رؤية منشورات المدونة والتفاعل معها.

ترجمة -وبتصرُّف- للمقال Laravel for Beginners #4 - Create a Dashboard لصاحبه Eric Hu.

اقرأ أيضًا

• المقال السابق: لارافيل للمبتدئين-الجزء الثالث: استخدام عمليات CRUD لإنشاء مدونة بسيطة
• تجريد إعداد قواعد البيانات في لارافيل باستعمال عملية التهجير Migration والبذر Seeder
• كيف تستخدم منشئ الاستعلامات Query builder للتخاطب مع قاعدة البيانات في Laravel
• إنشاء استمارة اتصال في Laravel باستخدام ميزة Form Request

سنستخدم في هذا المقال كل ما تعلّمناه في المقالين السابقين من سلسلة مقالات لارافيل للمبتدئين لإنشاء مشروع حقيقي، حيث سننشئ مدونة صغيرة تحتوي على منشورات فقط بدون فئات Categories أو وسوم Tags، وكل منشور له عنوان ومحتوى، إذ لن ننشئ تطبيق مدونة كامل المواصفات، وسنوضّح كيفية استرداد البيانات من قاعدة البيانات، وكيفية إنشاء أو تحديث معلومات جديدة، وكيفية حفظها في قاعدة البيانات، وكيفية حذفها، حيث يمثّل الاختصار CRUD عمليات الإنشاء ‎Create والقراءة ‎Read والتحديث ‎Update والحذف ‎Delete.

تصميم بنية قاعدة البيانات

سننشئ أولًا ملف تهجير Migration للجدول post، ويجب أن يحتوي هذا الجدول على العنوان والمحتوى، ويمكنك توليد ملف تهجير باستخدام الأمر التالي:

php artisan make:migration create_posts_table

وسيتضمن الملف ما يلي:

<?php

use Illuminate\Database\Migrations\Migration;
use Illuminate\Database\Schema\Blueprint;
use Illuminate\Support\Facades\Schema;

return new class extends Migration
{
   /**
    * تشغيل عمليات التهجير
    */
   public function up(): void
   {
       Schema::create('posts', function (Blueprint $table) {
           $table->id();
           $table->timestamps();
           $table->string('title');
           $table->text('content');
       });
   }

   /**
    * عكس عمليات التهجير
    */
   public function down(): void
   {
       Schema::dropIfExists('posts');
   }
};

أنشأنا في هذا المثال خمسة أعمدة في الجدول post باستدعاء 5 توابع وهي:

• ينشئ التابع id()‎ عمود المعرّف id الذي يُستخدَم عادة للفهرسة.
• ينشئ التابع timestamps()‎ عمودين هما: created_at و uptated_at، وسيُحدَّث هذان العمودان تلقائيًا عند إنشاء السجل وتحديثه.
• ينشئ التابع string('title')‎ العمود title الذي نوعه VARCHAR ويبلغ طوله الافتراضي 255 بايتًا.
• ينشئ التابع string('content')‎ عمود المحتوى content.

يمكنك تطبيق التغييرات من خلال تشغيل الأمر التالي:

php artisan migrate

ويجب أن ينشأ جدول posts جديد كما يلي:

يمكننا الآن إنشاء النموذج Model المقابل لهذا الجدول باستخدام الأمر التالي:

php artisan make:model Post

وسيتضمّن هذا النموذج app/Models/Post.php ما يلي:

<?php

namespace App\Models;

use Illuminate\Database\Eloquent\Factories\HasFactory;
use Illuminate\Database\Eloquent\Model;

class Post extends Model
{
   use HasFactory;
}

لننشئ الآن متحكم الموارد Resource Controller المقابل باستخدام الأمر التالي:

php artisan make:controller PostController --resource

وأخيرًا، سجّل هذا المتحكم في الموجِّه Router كما يلي:

use App\Http\Controllers\PostController;

Route::resource('posts', PostController::class);

يمكنك التحقق من الوِجهات Routes المُسجَّلة من خلال تشغيل الأمر التالي:

php artisan route:list

وسيظهر الخرج التالي:

GET|HEAD        posts ................................................................. posts.index › PostController@index
POST            posts ................................................................. posts.store › PostController@store
GET|HEAD        posts/create ........................................................ posts.create › PostController@create
GET|HEAD        posts/{post} ............................................................ posts.show › PostController@show
PUT|PATCH       posts/{post} ........................................................ posts.update › PostController@update
DELETE          posts/{post} ...................................................... posts.destroy › PostController@destroy
GET|HEAD        posts/{post}/edit ....................................................... posts.edit › PostController@edit

يحتوي الخرج السابق على معلومات مثل توابع الطلبات Request Methods وتوابع المتحكّمات Controller Methods بالإضافة إلى أسماء الوِجهات، وتُعَد هذه المعلومات مهمة جدًا وسنحتاج إليها لاحقًا في هذا المقال.

عمليات CRUD

حان الوقت الآن لنتعمّق في التطبيق نفسه، فمن غير المحتمل أن ننشئ جميع المتحكمات أولًا ثم نصمّم القوالب ثم ننتقل إلى الموجّهات عند إنشاء تطبيقات واقعية، إذ يجب أن نفكّر من وجهة نظر المستخدم وفي الإجراءات التي قد يرغب المستخدم في اتخاذها. يجب أن يكون لدى المستخدم القدرة على إجراء أربع عمليات لكل مورد، والذي هو Post في حالتنا، وهذه العمليات هي:

• الإنشاء Create: يجب أن يكون المستخدم قادرًا على إنشاء موارد جديدة وحفظها في قاعدة البيانات.
• القراءة Read: يجب أن يكون المستخدم قادرًا على قراءة الموارد سواءً من خلال استرداد قائمة الموارد أو التحقق من تفاصيل مورد محدّد.
• التحديث Update: يجب أن يكون المستخدم قادرًا على تحديث الموارد الموجودة وتحديث سجل قاعدة البيانات المقابلة لها.
• الحذف Delete: يجب أن يكون المستخدم قادرًا على إزالة مورد من قاعدة البيانات.

ويشار إلى هذه العمليات مع بعضها البعض باسم عمليات CRUD.

إجراء الإنشاء Create

لا تزال قاعدة بياناتنا فارغة حاليًا، لذا قد يرغب المستخدم في إنشاء منشورات جديدة، فلنبدأ بإجراء الإنشاء (C)، حيث يمكن إكمال هذا الإجراء من خلال استخدام التابعين التاليين:

• تابع المتحكم create()‎ الذي يعرض استمارة، مما يسمح للمستخدم بملء العنوان والمحتوى.
• تابع المتحكم store()‎ الذي يحفظ المنشور الذي أنشأناه حديثًا في قاعدة البيانات، ويعيد توجيه المستخدم إلى صفحة القائمة.

يطابق التابع create()‎ نمط URL الذي هو ‎/posts/create (التابع GET)، ويطابق التابع store()‎ نمط URL الذي هو ‎/post (التابع POST).

إليك مراجعةً مختصرة لتوابع HTTP في حال احتياجك إلى تجديد بعض المعلومات:

• تابع GET هو تابع طلبات HTTP الأكثر استخدامًا، ويُستخدَم لطلب البيانات والموارد من الخادم.
• يُستخدَم تابع POST لإرسال البيانات إلى الخادم، ويُستخدَم لإنشاء أو تحديث المورد.
• يعمل تابع HEAD مثل تابع GET تمامًا، باستثناء أن استجابة HTTP ستحتوي على الترويسة فقط بدون الجسم، ويستخدم المطورون هذا التابع لأغراض تنقيح الأخطاء Debugging.
• يُعَد تابع PUT مشابهًا لتابع POST، مع اختلاف واحد بسيط، حيث إذا أرسلتَ باستخدام التابع POST موردًا موجودًا مسبقًا على الخادم، فلن يسبّب هذا الإجراء أيّ فرق، ولكن سيكرّر تابع PUT هذا المورد في كل مرة نقدّم فيها الطلب.
• يزيل تابع DELETE موردًا من الخادم.

لنبدأ بالتابع create()‎، حيث سيتضمّن ملف المتحكم app/Http/Controllers/PostController.php ما يلي:

<?php

namespace App\Http\Controllers;
use App\Models\Post;
use Illuminate\Contracts\View\View;
. . .

class PostController extends Controller
{
   . . .

   /**
    *  عرض الاستمارة الخاصة بإنشاء مورد جديد
    */
   public function create(): View
   {
       return view('posts.create');
   }

   . . .
}