Проверка «может ли пользователь редактировать эту статью» обычно начинается с одного if в контроллере. Через месяц таких условий пять, в каждом действии, и они постепенно расходятся: в одном месте сравнили user_id, в другом забыли про роль редактора.
Два инструмента
Gate — для правил без модели: «может ли пользователь смотреть отчёты», «доступна ли админка». Policy — для правил, привязанных к модели: просмотр, создание, изменение, удаление конкретной записи.
Внутри Policy можно вызывать Gate, но не наоборот. Если правило зависит от объекта, почти всегда нужна Policy.
Создание Policy
php8.3 artisan make:policy PostPolicy --model=Post
Laravel найдёт её автоматически по имени App\Policies\PostPolicy для модели Post. Методы называются по действиям: viewAny, view, create, update, delete, restore, forceDelete.
public function update(User $user, Post $post): bool
{
return $user->id === $post->user_id
|| $user->hasRole('editor');
}
Метод получает пользователя и объект и возвращает bool. Здесь же можно проверять статус записи: опубликованную статью редактирует только администратор.
Gate для простых правил
Gate::define('view-reports', function (User $user): bool {
return $user->hasRole('manager');
});
Определения удобно держать в AppServiceProvider или отдельном провайдере. Если правил много, разделите их по доменам, иначе boot() разрастётся.
Использование в контроллере
public function update(UpdatePostRequest $request, Post $post)
{
$this->authorize('update', $post);
$post->update($request->validated());
return back();
}
authorize() выбрасывает AuthorizationException: для HTML это 403, для API — JSON с тем же кодом. Не пишите if (! Gate::allows(...)) abort(403) в каждом методе: исключение обрабатывается централизованно.
Для списков, где проверка не привязана к конкретной записи, используйте authorize('viewAny', Post::class).
Blade и API
В шаблоне:
@can('update', $post)
<a href="{{ route('posts.edit', $post) }}">Редактировать</a>
@endcan
Скрытая кнопка не заменяет проверку на сервере: пользователь может отправить запрос напрямую. В API перед изменением всегда вызывайте Policy, а не полагайтесь на то, что клиент не покажет действие.
Администратор и before
Если администратору разрешено всё, добавьте в начало Policy:
public function before(User $user): ?bool
{
return $user->isAdmin() ? true : null;
}
true разрешает действие без вызова остальных методов, null означает «решай как обычно». Вернуть false нельзя: это заблокирует даже владельца.
Типичные ошибки
- Правила размазаны по контроллерам. Одна проверка в Policy, остальные — ссылки на неё.
- Проверка только в интерфейсе. Кнопку скрыли, эндпоинт оставили открытым.
- Сравнение ролей строками.
if ($user->role === 'admin')в десяти местах; замените методомisAdmin(). - Policy не находится. Проверьте пространство имён и имя класса:
PostPolicyдляPost. - Нет тестов. Правила доступа — первое, что стоит покрыть тестами: запрет важнее разрешения.
Авторизация связана с аутентификацией, но не заменяет её. Как выдавать токены API, разобрано в статье Sanctum в Laravel, а о проверке входных данных — материал FormRequest в Laravel.
Правила доступа стоит покрыть тестами на уровне HTTP: пользователь без роли получает 403, владелец — 200, гость — 401 или редирект. Такие тесты ловят регрессии, которые не видны в юнит-тестах Policy, потому что проблема в маршруте или middleware.
Если проверок становится много, не создавайте «универсальную» Policy на все модели. Лучше отдельная Policy на сущность и общие трейты для повторяющихся условий. Читаемость важнее экономии файлов.
Для административных разделов добавьте отдельный middleware или Gate view-admin, а не проверяйте роль в каждом действии. Тогда отключить доступ можно одной правкой.
Отдельно проверьте граничные случаи: удалённая запись, черновик, чужая компания, пользователь без подтверждённого email. Именно они чаще всего пропускаются. Хороший тест — таблица «роль × действие × объект», где каждая ячейка ожидает конкретный код ответа. Для массовых действий проверяйте права на каждый элемент, а не только на первый: одна ошибка в фильтре открывает чужие данные.
Ещё одна привычка — не прятать проверку в аксессоры и шаблоны: правило должно жить в Policy, иначе его не найти при аудите. Если проверка нужна в очереди или команде, вызывайте Gate::forUser($user)->allows(), а не дублируйте условие.
Коротко
- Policy — для моделей, Gate — для действий без объекта;
authorize()в контроллере и@canв Blade используют одни правила;before()задаёт исключение для администратора;- скрытая кнопка не защищает эндпоинт;
- запреты тестируйте так же, как разрешения.