ازاي تضيف دوال جديدة لكلاسات لارافيل الأساسية من غير ما تكسر الكود؟ استخدام الـ Macros في لارافيل (Laravel Macros)

أهلاً بيك يا بشمهندس في مقال جديد من سلسلة شروحات تطوير الويب (Web Development) وتحديداً عمالقة الفريم ووركس (Frameworks). كام مرة كنت شغال على مشروع لارافيل (Laravel) ولقيت نفسك بتكرر نفس اللوجيك (Logic) أو الدالة (Function) في كذا مكان؟ مثلاً، بتعمل معالجة معينة على النصوص (Strings) أو الـ (Collections) وكل مرة بتكتب نفس الـ Helper Function أو بتعمل Extends للكلاس الأصلي، ودايماً حاسس إن الطريقة دي مش نظيفة ومش هي الطريقة اللي صمم بيها تايلور أويلويل الفريم وورق.

المشكلة دي بتواجه مبرمجين كتير، وخصوصاً لما نحب نضيف ميزة جديدة لكلاس جاهز زي (Collection) أو (Request) أو (Str). التعديل على الكود الأصلي ممنوع تماماً (Don't modify core files)، وعمل كلاسات جديدة لكل حاجة صغيرة بيعمل مجهود و(Boilerplate Code) مالوش لزمة. الحل السحري هنا اللي هيوفر عليك وقت وجهد هو استخدام الـ (Laravel Macros).

يعني إيه Laravel Macro ومنين بيجي السحر ده؟

الـ (Macro) باختصار شديد هو طريقة ديناميكية بتسمح لك تضيف دوال جديدة (Methods) للكلاسات الأساسية في لارافيل وقت التشغيل (Runtime) من غير ما تضطر تعدل على الكود المصدر (Source Code) للكلاس نفسه. الفكرة شبه الباترن اللي اسمها (Monkey Patching) بس بطريقة منظمة وشيك جداً جوه الفريم وورق.

لارافيل بيوفر ميزة اسمها (Macroable Trait) ومدمجة جوه كلاسات كتير أساسية زي (Collection)، و(Str)، و(Response)، وحتى الـ (Filesystem). ده معناه إنك تقدر تخترع دالة جديدة تماماً وتخليها جزء من الكلاس وكأنها كانت موجودة فيه من أول يوم.

الخطوات العملية: ازاي تعمل Macro بنفسك في لارافيل؟

عشان نطبق الموضوع ده صح، أحسن مكان تسجل فيه الـ Macros بتاعتك هو الـ (AppServiceProvider) وتحديداً في دالة الـ (boot). تعالوا نشوف مثال عملي وبسيط.

تخيل إنك دايماً بتحتاج تعمل تجميع (Collection) لأسماء المستخدمين وتخلي أول حرف كابيتال وتدمجهم بطريقة معينة، بدل ما تكتب اللوجيك ده كل مرة، تقدر تعمل (Collection Macro) بالصورة دي:

use Illuminate\Support\Collection;

public function boot()
{
    Collection::macro('toSentence', function () {
        return $this->map(function ($item) {
            return ucfirst($item);
        })->implode(', ');
    });
}

دلوقتي، بكل بساطة في أي مكان جوه مشروعك، تقدر تستخدم الدالة الجديدة دي وكأنها جزء أساسي من كلاس الـ (Collection) بالشكل ده:

$names = collect(['أحمد', 'محمد', 'علي']);
echo $names->toSentence(); 
// الناتج هيكون: أحمد, محمد, علي

استخدام الـ Macros مع كلاس النصوص (Str Macro)

لو أنت شغال كتير مع الـ (Strings)، أكيد بتقابلك حالات بتحتاج فيها تنظف النصوص بطريقة معينة. كلاس (Str) بيدعم الـ (Macroing) بشكل كامل. تعالوا نعمل دالة تحول النص لشكل مناسب للروابط (Slug) بس بطريقتنا الخاصة:

use Illuminate\Support\Str;

public function boot()
{
    Str::macro('customSlug', function ($string) {
        return strtolower(trim(preg_replace('/[^A-Za-z0-9-]+/', '-', $string)));
    });
}

الاستخدام هيكون سهل جداً وسريع:

$slug = Str::customSlug('Laravel Macros are Awesome!');
// الناتج: laravel-macros-are-awesome

الفرق بين الـ Macros و الـ Mixins لما المشروع يكبر

لو عندك (Macros) كتير وعملت حشر لكل الكود جوه الـ (AppServiceProvider)، الكود هيكون صعب القراءة والصيانة. هنا بيجي دور الـ (Mixins). الـ (Mixin) هو مجرد كلاس عادي بتجمع فيه مجموعة (Macros) وبعدين بتربط الكلاس ده بالـ (Macroable Class).

مثال على عمل (Collection Mixin):

namespace App\Mixins;

class CollectionMixins 
{
    public function toSentence()
    {
        return function () {
            return $this->implode(', ');
        };
    }
}

وبعدين تسجل المكسين في الـ (ServiceProvider) بالطريقة دي:

Collection::mixin(new \App\Mixins\CollectionMixins());

الطريقة دي بتخلي كودك منظم ونظيف جداً، ومناسب جداً لو بتعمل (Open Source Contributions) أو حزم (Packages) خارجية للارافيل.

خاتمة ونصيحة من أخ

استخدام الـ (Laravel Macros) هيخليك تحس بمدى قوة ومرونة لارافيل، وهيوفر عليك كتابة أكواد مكررة (DRY Principle - Don't Repeat Yourself). لكن نصيحة أخيرة: متفتريش في استخدامها! استخدم الـ Macros في الحاجات اللي بتتكرر فعلاً بأسلوب متكرر في مشروعك، عشان لو دخل معاك مبرمج جديد في الفريق، ميتفاجئش بدوال غريبة مش موجودة في التوثيق الرسمي (Official Documentation) وتعمله لخبطة.

مارس اللي تعلمته حالا، افتح مشروع تجريبي وجرب تعمل أول (Macro) خاصة بيك، وبالتوفيق يا بشمهندس في رحلتك مع البرمجة!