Проверка «может ли пользователь редактировать эту статью» обычно начинается с одного 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() задаёт исключение для администратора;
  • скрытая кнопка не защищает эндпоинт;
  • запреты тестируйте так же, как разрешения.