Que sont les classes Form Request ?

Question

Accepted Answer

Les classes **Form Request** sont des classes de requête personnalisées qui **encapsulent la logique de validation (et d'autorisation)** pour une requête spécifique. Elles déplacent les règles de validation hors des contrôleurs vers des classes dédiées et réutilisables — maintenant les contrôleurs minces et la validation organisée.

## Créer et utiliser une 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
}
```

Quand vous type-hintez une Form Request dans une méthode de contrôleur, Laravel **exécute automatiquement son autorisation et sa validation avant l'exécution de la méthode** — si l'une échoue, la requête est rejetée (403 pour l'autorisation, 422/redirection pour la validation) et votre méthode ne s'exécute jamais. Donc à l'intérieur de la méthode, vous savez que les données sont valides et l'action est autorisée.

## Les bénéfices

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

## Pourquoi c'est important

Les classes Form Request sont une meilleure pratique importante de Laravel pour organiser proprement la validation et l'autorisation — elles sont l'approche recommandée pour tout au-delà de la validation triviale, donc les comprendre est précieux pour écrire des applications Laravel maintenables.

Leur avantage clé est de garder **les contrôleurs minces** : en déplaçant les règles de validation et la logique d'autorisation vers une classe dédiée (que Laravel exécute automatiquement avant la méthode du contrôleur), le contrôleur reste concentré sur sa logique essentielle, avec l'assurance que les données sont déjà validées et l'action autorisée lors de son exécution.

Cette séparation rend le code plus **organisé** (toutes les règles, messages personnalisés et autorisation pour une requête en un seul endroit cohésif), **réutilisable** (la même Form Request peut être utilisée sur plusieurs endpoints) et plus propre.

La combinaison automatique de **validation et d'autorisation** dans une seule classe — toutes deux vérifiées avant l'exécution du contrôleur, rejetant automatiquement les requêtes invalides ou non autorisées — est élégante et réduit le code passe-partout.

Comprendre les Form Requests, comment elles s'exécutent automatiquement et les avantages d'extraire la validation/autorisation des contrôleurs reflète une pratique Laravel mature et est important pour construire des applications bien structurées, puisque la validation et l'autorisation sont des préoccupations omniprésentes et les Form Requests sont la façon propre et idiomatique de Laravel pour les gérer pour des cas non triviaux — une caractéristique du code Laravel professionnel et maintenable.