Что такое Form Request?

Question

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

YeaHub · Accepted Answer

Form Request — это мощный инструмент в Laravel для централизованной обработки входящих HTTP-запросов, сочетающий в себе валидацию, авторизацию и подготовку данных.Основные возможности Form RequestВалидация данныхОпределение правил проверки входных данныхАвтоматическое перенаправление при ошибкахКастомные сообщения об ошибкахclass StoreUserRequest extends FormRequest {
    public function rules() {
        return [
            'name' => 'required|string|max:255',
            'email' => 'required|email|unique:users',
            'password' => 'required|min:8|confirmed',
            'role' => 'sometimes|in:admin,user,moderator',
        ];
    }
    
    public function messages() {
        return [
            'email.unique' => 'Этот email уже занят',
            'password.min' => 'Пароль должен быть не менее 8 символов',
        ];
    }
}Авторизация запросовПроверка прав доступа пользователяОпределение, может ли пользователь выполнить действиеclass UpdateUserRequest extends FormRequest {
    public function authorize() {
        // Пользователь может обновлять только свой профиль
        return $this->user()->id === $this->route('user')->id;
    }
    
    public function rules() {
        return [
            'name' => 'sometimes|string|max:255',
            'email' => 'sometimes|email|unique:users,email,' . $this->route('user')->id,
        ];
    }
}Подготовка данныхНормализация данных перед валидациейДобавление вычисляемых полейclass CreatePostRequest extends FormRequest {
    protected function prepareForValidation() {
        $this->merge([
            'slug' => Str::slug($this->title),
            'user_id' => auth()->id(),
        ]);
    }
    
    public function rules() {
        return [
            'title' => 'required|string|max:255',
            'content' => 'required|string',
            'slug' => 'required|unique:posts',
            'user_id' => 'required|exists:users,id',
        ];
    }
}Использование в контроллерахclass UserController extends Controller {
    public function store(StoreUserRequest $request) {
        // Данные уже прошли валидацию
        $validated = $request->validated();
        
        $user = User::create($validated);
        
        return response()->json($user, 201);
    }
    
    public function update(UpdateUserRequest $request, User $user) {
        // Авторизация уже проверена
        $validated = $request->validated();
        
        $user->update($validated);
        
        return response()->json($user);
    }
}Преимущества использования Form RequestЧистота контроллеровКонтроллеры освобождаются от логики валидацииУпрощается чтение и поддержка кодаПовторное использованиеОдин Form Request может использоваться в нескольких контроллерахЛегко модифицировать правила валидацииТестируемостьForm Request легко тестировать изолированноМожно тестировать правила валидации отдельно от бизнес-логикиclass StoreUserRequestTest extends TestCase {
    public function test_validation_rules() {
        $request = new StoreUserRequest();
        
        $rules = $request->rules();
        
        $this->assertArrayHasKey('email', $rules);
        $this->assertContains('required', $rules['email']);
        $this->assertContains('email', $rules['email']);
    }
}ВыводForm Request — это эффективный способ организовать валидацию и авторизацию в Laravel приложениях, делая код более структурированным, безопасным и легким в поддержке.