Ce sunt clasele Form Request?

Question

Accepted Answer

Clasele **Form Request** sunt clase de cerere personalizate care **încapsulează logica de validare (și autorizare)** pentru o cerere specifică. Ele mută regulile de validare din controlerele în clase dedicate și reutilizabile — păstrând controlerele ușoare și validarea organizată.

## Crearea și utilizarea unui 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
}
```

Când hint-ezi tipul unui Form Request într-o metodă a controlerului, Laravel **execută automat autorizarea și validarea înainte ca metoda să se execute** — dacă oricare dintre ele eșuează, cererea este respingă (403 pentru autorizare, 422/redirect pentru validare) și metoda ta nu se execută niciodată. Deci în interiorul metodei, știi că datele sunt valide și acțiunea este autorizată.

## Beneficiile

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

## De ce este important

Clasele Form Request sunt o practică bună importantă Laravel pentru organizarea curată a validării și autorizării — sunt abordarea recomandată pentru orice altceva decât validarea banală, deci înțelegerea lor este valoroasă pentru scrierea aplicațiilor Laravel întreținute.

Beneficiul lor principal este menținerea **controlerelor ușoare**: prin mutarea regulilor de validare și a logicii de autorizare într-o clasă dedicată (pe care Laravel o execută automat înainte de metoda controlerului), controlerul rămâne concentrat pe logica sa de bază, cu asigurarea că datele au fost deja validate și acțiunea a fost autorizată când se execută.

Această separare face codul mai **organizat** (toate regulile, mesajele personalizate și autorizarea pentru o cerere într-un singur loc coeziv), **reutilizabil** (același Form Request poate fi utilizat în mai multe endpoint-uri) și mai curat.

Combinarea automată a **validării și autorizării** într-o singură clasă — ambele verificate înainte ca controlerul să se execute, respingând automat cererile invalide sau neautorizate — este elegantă și reduce boilerplate.

Înțelegerea Form Requests, cum se execută automat și beneficiile extragerii validării/autorizării din controlere reflectă practica Laravel matură și este importantă pentru construirea aplicațiilor bine structurate, deoarece validarea și autorizarea sunt preocupări omniprezente și Form Requests sunt modul curat și idiomativ al Laravel de a le gestiona pentru cazuri non-banale — o caracteristică a codului Laravel profesional și întreținut.