Laravel Warrant: قوانین دسترسی که خودشون کوئری SQL میشن
خلاصهٔ کاملتر
Laravel Warrant، ساختهی Patrick Hanna، قوانین دسترسی (authorization) رو به شرطهای SQL تبدیل میکنه. نویسندهی مقاله توی Laravel News میگه مشکل آشنایی رو حل میکنه: یه چک مالکیت رو توی policy مینویسی، بعد همونو توی یه query scope تکرار میکنی. اگه یکی رو عوض کنی و اون یکی یادت بره، صفحهی لیستت با policy جور درنمیاد.
مثال مقاله یه صفحهی timesheet هست: کارمند میتونه رکوردهای خودشو ببینه و تا وقتی قفل نشدن ویرایششون کنه. توی Warrant یه کلاس schema میسازی که توش هر شرط ردیفی (row condition) یه متد هست که یه شرط where برمیگردونه، مثلاً isOwner و isLocked. بعد این متدها با اسم is_owner و is_locked توی زبان قوانین خود Warrant استفاده میشن:
return <<<'WARRANT'
if is_owner they can view, update
if is_locked they cannot update
WARRANT;یه نکتهی مهم اینه که denyها همیشه به grantها غلبه میکنن. یعنی کارمند timesheet قفلشدهی خودشو میبینه ولی نمیتونه ویرایشش کنه. هر abilityای هم که تعریف شده ولی هیچ grantی بهش نخورده، بهطور پیشفرض رد میشه. قوانین رو میشه بهجای خود schema از دیتابیس یا فایلهای .warrant هم بارگذاری کرد.
بعد از اضافه کردن trait HasWarrantSchema به مدل، میتونی مستقیم توی کوئری فیلتر کنی:
$timesheets = Timesheet::query()
->userHasAbility('update')
->orderByDesc('id')
->paginate(20);فیلتر توی خود دیتابیس و قبل از paginate انجام میشه. اگه بعد از گرفتن صفحه کالکشن رو فیلتر میکردی، ممکن بود کمتر از ۲۰ ردیف داشته باشی و تعداد کل هم رکوردهای غیرمجاز رو حساب کنه. با selectUserAbilities هم برای هر ردیف یه ستون JSON به اسم abilities برمیگرده که میشه باهاش تصمیم گرفت دکمهی ویرایش نشون داده بشه یا نه. این قابلیت روی PostgreSQL، MySQL/MariaDB و SQLite کار میکنه.
Warrant از طریق یه هوک Gate::before به Gate لاراول وصل میشه، پس can، Gate::authorize، دستورهای Blade و middleware can: همه کار میکنن. وقتی schema یه ability رو تعریف کرده باشه، Warrant چکش میکنه و متد policy مربوطه دیگه اجرا نمیشه. نویسنده تأکید میکنه پکیج هنوز بتاست و باید نسخهی دقیق رو pin کنی. به گفتهی خودش اگه چندتا متد policy ساده کارتو راه میندازه، لازم نیست یه زبان قوانین جدید اضافه کنی، و SQL تولیدشده رو هم حتماً روی دادههای خودت چک کن.
نکات کلیدی:
- Laravel Warrant از Laravel 11، 12 و 13 با PHP 8.2 به بالا پشتیبانی میکنه.
- پکیج بتاست و نسخهی پیشنهادی برای pin کردن 4.12.3 هست.
- denyها همیشه به grantها غلبه میکنن و ability بدون grant رد میشه.
- اسکوپ userHasAbility قبل از paginate توی دیتابیس فیلتر میکنه.
- انتخاب abilityها برای هر ردیف به ازای هر ability یه شرط اضافه به کوئری اضافه میکنه، پس فقط اونایی که لازمه رو بخواه.
- مخفی کردن دکمه کافی نیست و endpoint ویرایش باید با Gate::authorize محافظت بشه.




