Валидация в контроллере начинается с пяти строк и заканчивается блоком на семьдесят. Правила дублируются между созданием и обновлением, сообщения расходятся, а тесты проверяют не то, что видит пользователь. FormRequest решает это одним классом на сценарий.

Создание

php8.3 artisan make:request StorePostRequest

Класс появится в app/Http/Requests. В нём два обязательных метода: authorize() и rules(). Контроллер просто принимает объект в аргументах:

public function store(StorePostRequest $request)
{
    $post = Post::create($request->validated());

    return redirect()->route('posts.show', $post);
}

Валидация запускается до метода. Если данные неверны, Laravel вернёт редирект с ошибками для HTML или 422 с JSON для API.

Правила и authorize

public function authorize(): bool
{
    return $this->user()->can('create', Post::class);
}

public function rules(): array
{
    return [
        'title' => ['required', 'string', 'max:120'],
        'slug' => ['required', 'alpha_dash', 'max:120'],
        'body' => ['required', 'string', 'min:100'],
        'published_at' => ['nullable', 'date'],
        'tags' => ['array', 'max:5'],
        'tags.*' => ['string', 'max:30'],
    ];
}

authorize() по умолчанию возвращает false — частая причина «почему 403». Проверку прав лучше делегировать Policy, а не писать условия в контроллере.

Уникальность при обновлении

Правило unique должно игнорировать текущую запись, иначе сохранение без изменения слага упадёт:

use Illuminate\Validation\Rule;

'slug' => [
    'required',
    Rule::unique('posts', 'slug')->ignore($this->route('post')),
],

ignore() принимает модель или id. Если slug генерируется автоматически, проверяйте его после генерации, а не до.

Сообщения и названия полей

public function messages(): array
{
    return [
        'title.required' => 'Заголовок обязателен.',
        'body.min' => 'Текст слишком короткий: нужно хотя бы :min символов.',
    ];
}

public function attributes(): array
{
    return ['body' => 'текст статьи'];
}

Сообщения стоит писать на языке интерфейса и без технических терминов. :min и другие плейсхолдеры Laravel подставит сам.

Подготовка данных

Иногда до валидации нужно нормализовать вход: обрезать пробелы, привести slug к нижнему регистру, собрать теги из строки.

protected function prepareForValidation(): void
{
    $this->merge([
        'slug' => str($this->slug)->slug()->toString(),
        'tags' => array_filter(array_map('trim', explode(',', (string) $this->tags))),
    ]);
}

Не делайте здесь тяжёлых запросов к базе: метод вызывается до правил и должен быть быстрым.

validated() и safe()

validated() возвращает только поля, для которых есть правила. safe() делает то же самое, но не падает, если правила описаны не для всех полей. В обоих случаях request()->all() использовать не нужно: туда попадает всё, включая служебные поля формы.

Для вложенных массивов validated() сохраняет структуру, но не гарантирует, что каждый элемент прошёл все правила. Проверяйте tags.* явно.

Что не должно быть в FormRequest

  • бизнес-логика и сохранение модели;
  • запросы к внешним API;
  • проверка прав через if ($user->id === ...) — для этого Policy;
  • сотня правил на все сценарии в одном классе.

Отдельный класс на создание и обновление читается лучше, чем один с ветвлением по методу HTTP. Дублирование правил можно вынести в трейт или базовый класс, но не превращайте это в преждевременную абстракцию.

О проверке доступа — статья Policy и Gate в Laravel. О кэшировании результатов, чтобы не ходить в базу на каждый запрос, — кэш в Laravel.

Тестами проверяйте не только успешное сохранение, но и ответ 422: какие поля попали в ошибки, какие сообщения увидит пользователь. Для API дополнительно проверьте структуру JSON — Laravel отдаёт errors с массивом на каждое поле.

Если форма используется и для создания, и для обновления, вынесите общие правила в отдельный класс или трейт. Но не делайте один FormRequest с ветвлением по isMethod('put'): читать такое тяжело, а тестировать ещё тяжелее.

Помните про nullable: пустая строка и отсутствующее поле — разные вещи. Для необязательных дат и чисел используйте nullable вместе с date или integer, иначе валидация пропустит пустую строку в базу.

Проверьте формы с пустыми и повторяющимися полями, с массивом из одного элемента и с отсутствующим ключом. Валидация, которая работает на «идеальных» данных, ломается на реальных. И не забывайте про sometimes для полей, которые меняются только при обновлении.

Коротко

  • один FormRequest — один сценарий;
  • authorize() по умолчанию запрещает, не забывайте про Policy;
  • Rule::unique(...)->ignore() нужен при обновлении;
  • сообщения и названия полей пишутся для пользователя;
  • validated() защищает от лишних полей.