Что такое классы Form Request?

Question

Accepted Answer

Классы **Form Request** — это пользовательские классы запросов, которые **инкапсулируют логику валидации (и авторизации)** для конкретного запроса. Они переносят правила валидации из контроллеров в выделенные, переиспользуемые классы — сохраняя контроллеры стройными и валидацию организованной.

## Создание и использование Form Request

```php
<?php
// php artisan make:request StoreUserRequest
class StoreUserRequest extends FormRequest {
    public function authorize(): bool {
        return $this->user()->can('create', User::class);   // AUTHORIZATION check
    }

public function rules(): array {
        return [                                              // VALIDATION rules
            'name' => 'required|string|max:100',
            'email' => 'required|email|unique:users',
            'password' => 'required|min:8|confirmed',
        ];
    }

public function messages(): array {
        return ['email.unique' => 'That email is already taken.'];   // custom messages
    }
}
```

```php
// type-hint the Form Request in the controller — validation runs AUTOMATICALLY
public function store(StoreUserRequest $request) {
    // if we reach here, validation AND authorization already PASSED
    User::create($request->validated());   // get the validated data
}
```

Когда вы используете type-hint для Form Request в методе контроллера, Laravel **автоматически выполняет проверку авторизации и валидацию перед выполнением метода** — если хотя бы одна из них не пройдет, запрос отклоняется (403 для авторизации, 422/перенаправление для валидации) и ваш метод никогда не выполнится. Таким образом, внутри метода вы знаете, что данные валидны и действие авторизовано.

## Преимущества

```text
✓ Thin controllers — validation/authorization logic lives in the Form Request, not the controller
✓ Reusable — use the same request class across multiple endpoints
✓ Organized — rules, messages, and authorization for a request are in one place
✓ Combines validation AND authorization — both checked automatically before the controller
✓ Access prepared/validated data cleanly via $request->validated()
```

## Почему это важно

Классы Form Request — это важная лучшая практика Laravel для чистой организации валидации и авторизации — это рекомендуемый подход для чего угодно, кроме тривиальной валидации, поэтому их понимание ценно для написания поддерживаемых приложений Laravel.

Их ключевое преимущество — сохранять **контроллеры стройными**: перемещая правила валидации и логику авторизации в выделенный класс (который Laravel автоматически выполняет перед методом контроллера), контроллер остается сосредоточенным на своей основной логике с уверенностью, что данные уже валидированы и действие авторизовано при выполнении.

Это разделение делает код более **организованным** (все правила, пользовательские сообщения и авторизация для запроса в одном связном месте), **переиспользуемым** (один и тот же Form Request может быть использован в разных эндпоинтах) и чище.

Автоматическая комбинация **валидации и авторизации** в одном классе — обе проверяются перед выполнением контроллера, автоматически отклоняя недействительные или неавторизованные запросы — это элегантно и снижает boilerplate код.

Понимание Form Requests, как они автоматически выполняются и преимущества извлечения валидации/авторизации из контроллеров отражают зрелую практику Laravel и важны для построения хорошо структурированных приложений, поскольку валидация и авторизация являются повсеместными задачами, а Form Requests — чистый, идиоматичный способ Laravel справляться с ними для нетривиальных случаев — отличительная черта профессионального, поддерживаемого кода Laravel.