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

فهم التحدي

تعد تعدادات Laravel أداة قوية لتحديد حالات أو فئات معينة. على سبيل المثال، يمكنك تحديد أنواع مختلفة من المستخدمين مثل "admin" أو "agent" أو "agency". ومع ذلك، عند محاولة مقارنة قيم التعداد هذه في قوالب Blade، قد تواجه نتائج غير متوقعة.

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

النهج الصحيح

تحتوي تعدادات Laravel على كل من القيمة والوظائف الإضافية، مما يعني أن المقارنة المباشرة قد لا تعمل على النحو المنشود. لمقارنة قيم التعداد في قوالب Blade، يجب عليك الرجوع إلى خاصية القيمة.

إليك مثال يوضح الحل.

مثال: مقارنة قيم التعداد

لنفترض أن لديك فئة تعداد UserType لأدوار مستخدم مختلفة في تطبيقك:

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


  
  
  مقارنة غير صحيحة


قد تبدو المقارنة المباشرة للتعدادات في قوالب Blade بهذا الشكل، لكنها لن تنجح:


@if (auth()->user()->user_type === 'agent' || auth()->user()->user_type === 'agency')
    
@endif




 فشل الكود أعلاه لأن auth()->user()->user_type يُرجع كائن التعداد، وليس سلسلة. ستؤدي مقارنتها بسلسلة دائمًا إلى خطأ.


  
  
  المقارنة الصحيحة: الوصول إلى خاصية القيمة


 الطريقة الصحيحة لمقارنة قيم التعداد في Blade هي عن طريق الوصول إلى خاصية قيمة التعداد:


@if (auth()->user()->user_type->value === 'agent' || auth()->user()->user_type->value === 'agency')
    
@endif




هنا، نقوم باستخراج القيمة الأولية ("agent" أو "agency") من كائن التعداد، مما يسمح بإجراء مقارنة مناسبة.


  
  
  إعادة البناء لسهولة القراءة


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

في نموذج المستخدم:


public function isAgentOrAgency(): bool {
    return $this->user_type->value === 'agent' || $this->user_type->value === 'agency';
}




في قالب النصل:


@if (auth()->user()->isAgentOrAgency())
    
@endif




يعمل هذا الأسلوب على تحسين إمكانية القراءة وتقليل التعليمات البرمجية المتكررة.


  
  
  الاستفادة من التعدادات في أجزاء أخرى من Laravel


التعدادات ليست مفيدة فقط في قوالب Blade؛ يمكن الاستفادة منها عبر تطبيق Laravel بالكامل للحصول على منطق أكثر تنظيمًا وقابلية للتنبؤ. يمكنك استخدامها في:

1. قواعد التحقق من الصحة:

استخدم التعدادات لتحديد القيم المقبولة.


'user_type' => ['required', Rule::in(UserType::cases())], 




2. استعلامات قاعدة البيانات:

مقارنة التعدادات في شروط الاستعلام.


$users = User::where('user_type', UserType::Agent->value)->get();




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


  
  
  الوجبات السريعة الرئيسية


- قيم التعداد هي كائنات:

 قم دائمًا بالوصول إلى خاصية القيمة عند مقارنة التعدادات في قوالب Blade.

  - المنطق المركزي:  

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

- التعدادات عبر التطبيق:

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

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


  
  
  خاتمة


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