Cosa sono le classi Form Request?

Question

Accepted Answer

Le classi **Form Request** sono classi request personalizzate che **incapsulano la logica di validazione (e autorizzazione)** per una richiesta specifica. Spostano le regole di validazione dai controller in classi dedicate e riutilizzabili — mantenendo i controller snelli e la validazione organizzata.

## Creazione e utilizzo di un 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 type-hint un Form Request in un metodo controller, Laravel **esegue automaticamente l'autorizzazione e la validazione prima che il metodo si esegua** — se uno qualsiasi fallisce, la richiesta viene rifiutata (403 per l'autorizzazione, 422/redirect per la validazione) e il tuo metodo non viene mai eseguito. Quindi all'interno del metodo, sai che i dati sono validi e l'azione è autorizzata.

## I vantaggi

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

## Perché è importante

Le classi Form Request sono un'importante best practice Laravel per organizzare la validazione e l'autorizzazione in modo pulito — sono l'approccio consigliato per qualsiasi cosa al di là della validazione banale, quindi comprenderle è prezioso per scrivere applicazioni Laravel mantenibili.

Il loro vantaggio principale è mantenere i **controller snelli**: spostando le regole di validazione e la logica di autorizzazione in una classe dedicata (che Laravel esegue automaticamente prima del metodo controller), il controller rimane focalizzato sulla sua logica principale, con la certezza che i dati sono già validati e l'azione è autorizzata quando viene eseguita.

Questa separazione rende il codice più **organizzato** (tutte le regole, i messaggi personalizzati e l'autorizzazione per una richiesta in un unico posto coeso), **riutilizzabile** (lo stesso Form Request può essere utilizzato su più endpoint) e più pulito.

La combinazione automatica di **validazione e autorizzazione** in una classe — entrambe controllate prima dell'esecuzione del controller, rifiutando automaticamente le richieste non valide o non autorizzate — è elegante e riduce il boilerplate.

Comprendere i Form Request, come vengono eseguiti automaticamente e i vantaggi di estrarre validazione/autorizzazione dai controller riflette una pratica Laravel matura ed è importante per costruire applicazioni ben strutturate, poiché la validazione e l'autorizzazione sono problematiche ubique e i Form Request sono il modo pulito e idiomatico di Laravel per gestirli per casi non banali — un marchio di codice Laravel professionale e mantenibile.