O que são classes Form Request?

Question

Accepted Answer

Classes **Form Request** são classes de requisição personalizadas que **encapsulam lógica de validação (e autorização)** para uma requisição específica. Elas movem regras de validação para fora dos controladores e as colocam em classes dedicadas e reutilizáveis — mantendo controladores enxutos e validação organizada.

## Criando e usando um 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
}
```

Quando você type-hint um Form Request em um método de controlador, o Laravel **executa automaticamente sua autorização e validação antes da execução do método** — se qualquer um falhar, a requisição é rejeitada (403 para autorização, 422/redirecionamento para validação) e seu método nunca é executado. Assim, dentro do método, você sabe que os dados são válidos e a ação é autorizada.

## Os benefícios

```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()
```

## Por que isso importa

Classes Form Request são uma prática recomendada importante do Laravel para organizar validação e autorização de forma limpa — elas são a abordagem recomendada para qualquer coisa além de validação trivial, então entendê-las é valioso para escrever aplicações Laravel mantíveis.

Seu benefício principal é manter **controladores enxutos**: movendo regras de validação e lógica de autorização para uma classe dedicada (que o Laravel executa automaticamente antes do método do controlador), o controlador permanece focado em sua lógica principal, com a garantia de que os dados já foram validados e a ação foi autorizada quando é executada.

Essa separação torna o código mais **organizado** (todas as regras, mensagens personalizadas e autorização para uma requisição em um único lugar coeso), **reutilizável** (o mesmo Form Request pode ser usado em vários endpoints) e mais limpo.

A combinação automática de **validação e autorização** em uma única classe — ambas verificadas antes do controlador ser executado, rejeitando automaticamente requisições inválidas ou não autorizadas — é elegante e reduz boilerplate.

Entender Form Requests, como elas são executadas automaticamente e os benefícios de extrair validação/autorização dos controladores reflete prática madura do Laravel e é importante para construir aplicações bem estruturadas, já que validação e autorização são preocupações onipresentes e Form Requests são a forma limpa e idiomática do Laravel de lidar com elas para casos não triviais — uma marca registrada de código Laravel profissional e mantível.