Валидация в контроллере начинается с пяти строк и заканчивается блоком на семьдесят. Правила дублируются между созданием и обновлением, сообщения расходятся, а тесты проверяют не то, что видит пользователь. 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()защищает от лишних полей.