من فضلك تسجيل الدخول أو تسجيل لتفعل ذلك.

نواجه نحن المطورين في Laravel تحديًا شائعًا يتمثل في تكرار قواعد الصلاحيات في أماكن متعددة، مثل السياسات (Policies) ونطاقات الاستعلام (Query Scopes). عندما تقوم بتغيير قاعدة في مكان وتنسى تحديثها في الآخر، قد يؤدي ذلك إلى عدم اتساق البيانات أو مشكلات أمنية. هنا يأتي دور حزمة Laravel Warrant، التي قدمها Patrick Hanna، لتوحيد هذه القواعد.

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

لماذا نحتاج Warrant؟

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

على الرغم من أن Laravel توفر بالفعل بوابات (Gates) وسياسات (Policies) للتعبير عن قواعد الملكية والتطبيق الأخرى، إلا أنها لا تقوم تلقائيًا بترجمة هذه القواعد إلى مرشحات قاعدة بيانات لصفحات القوائم. هنا تتفوق Warrant، فهي تتيح لك تحديد الشروط كقيود استعلام ودمجها في لغة قواعدها، مما يوفر مرونة وكفاءة أعلى.

يمكن لـ Warrant أيضًا التكامل مع حزم أخرى مثل Spatie أو Bouncer، مما يسمح لك بالاحتفاظ بتعيينات الأدوار الموجودة لديك وكتابة موفر قواعد Warrant لإرجاع القواعد لتلك الأدوار.

كيف يعمل Warrant؟

الحزمة حاليًا في مرحلة البيتا، وقد يتغير API الخاص بها بين الإصدارات. يوصي القائم على صيانتها بتثبيت إصدار دقيق والتحقق من سجل التغييرات قبل الترقية. يمكنك تثبيتها باستخدام الأمر التالي: «composer require patrickhanna/laravel-warrant:4.12.3». تدعم الحزمة Laravel 11 و 12 و 13 مع PHP 8.2 أو أحدث، مع العلم أن Laravel 13 نفسها تتطلب PHP 8.3 أو أحدث.

لتحديد القواعد، تقوم بإنشاء مخطط (Schema) يصف الكيان الخاص بك، مثل `TimesheetSchema`. داخل هذا المخطط، يمكنك تعريف قدرات (Abilities) مثل «VIEW» و «UPDATE»، وتحديد شروط الصفوف (RowConditions) مثل `isOwner` و `isLocked`. يتم استخدام هذه الشروط لإنشاء لغة قواعد بسيطة تسمح لك بدمج المنح والرفض، مع الأخذ في الاعتبار أن الرفض يلغي المنح.

بعد تعريف المخطط وتسجيله في ملف «config/warrant.php»، يمكنك استخدام Warrant لتصفية السجلات بكفاءة. على سبيل المثال، يمكنك استرداد سجلات الدوام التي يمكن للمستخدم الحالي تحديثها قبل تقسيم النتائج على صفحات (pagination)، مما يضمن عدم ظهور سجلات غير مصرح بها في القائمة.

بالإضافة إلى تصفية القوائم، تتيح لك Warrant تحديد القدرات لكل صف عند الاستعلام، مما يسمح لك بتخصيص واجهة المستخدم بناءً على صلاحيات المستخدم، كإظهار زر التعديل إذا كان المستخدم يملك صلاحية «update». كما تدعم Warrant تكامل Gate في Laravel بشكل افتراضي، مما يتيح لك استخدام استدعاءات Laravel المعتادة مثل `Gate::authorize()` للتحقق من الصلاحيات قبل حفظ التغييرات.

تأثير ذلك على عمل المطورين

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

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

المصدر: laravel-news.com

ثغرة Java4Shell: تحديثات أمنية عاجلة تحمي تطبيقاتك
GitHub تطلق Replica و A11y Framework: مستقبل مفتوح المصدر

Reactions

0
0
0
0
0
0
بالفعل كان رد فعل لهذا المنصب.

ردود الفعل