X'inhuma klassijiet Form Request?

Question

Accepted Answer

Klassijiet **Form Request** huma klassijiet ta' talba personalizzati li **jinkapsulanu l-loġika ta' validazzjoni (u awtorizzazzjoni)** għal talba speċifika. Jimmixxu r-regoli ta' validazzjoni barra mill-kontrolluri f'klassijiet dedikati u riusabbli — iżommu l-kontrolluri raqqin u l-validazzjoni organizzata.

## Ħoloq u użu ta' 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
}
```

Metà inti tiddikjara Form Request fi metodu ta' kontrollur, Laravel **awtomatikament iħaddem l-awtorizzazzjoni u l-validazzjoni tiegħu qabel ma l-metodu jitnaffaz** — jekk kwalunkwe wieħed ikun falla, it-talba hija riggettjata (403 għall-awtorizzazzjoni, 422/iderezzjoni għall-validazzjoni) u l-metodu tiegħek qatt ma jitħaddem. Allura ġewwa l-metodu, inti taf li d-data hija valida u l-azzjoni hija awtorizzata.

## Il-benefiċċji

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

## Għaliex hija importanti

Klassijiet Form Request huma prattika tajba Laravel importanti biex torganizza l-validazzjoni u l-awtorizzazzjoni b'mod naddaf — huma l-approċċ rakkomandatur għal kwalunkwe ħaġa lil hinn mill-validazzjoni trivjali, għaldaqstant il-fehim tagħhom huwa valguż għall-kitba ta' applikazzjonijiet Laravel mantenabbli.

Il-benefiċċju primarji tagħhom huwa jżommu **l-kontrolluri raqqin**: billi jimmixxu r-regoli ta' validazzjoni u l-loġika ta' awtorizzazzjoni f'klassja dedikata (li Laravel iħaddem awtomatikament qabel il-metodu ta' kontrollur), il-kontrollur jibqa' fokussat fuq il-loġika priymar tiegħu, bl-assiguranza li d-data hija diġà validata u l-azzjoni hija awtorizzata meta titnaffaz.

Din is-separazzjoni tagħmel il-kodiċi aktar **organizzat** (ir-regoli kollha, il-messaġġi personalizzati, u l-awtorizzazzjoni għat-talba f'post wieħed koeziv), **riusabbli** (l-istess Form Request jista' jintuża fuq endpojnts multipli), u aktar naddaf.

L-kombinazzjoni awtomatika ta' **validazzjoni u awtorizzazzjoni** f'klassja waħda — it-tnejn miċċekati qabel il-kontrollur jitħaddem, riggettaw talbiet invalidi jew mhux awtorizzati awtomatikament — eleganti u tnaqqas il-boilerplate.

L-fahim ta' Form Request, kif jaħdmu awtomatikament, u l-benefiċċji tal-estrazzjoni tal-validazzjoni/awtorizzazzjoni mill-kontrolluri jirriflettu prattika Laravel matura u importanti għall-bini ta' applikazzjonijiet strutturati tajjeb, minħabba li l-validazzjoni u l-awtorizzazzjoni huma kwistjonijiet ubikwi u Form Request huma l-mod naddaf u idijomatiku ta' Laravel biex jittrattawhom għal każi mhux-trivjali — hallmark ta' kodiċi Laravel professjonali u mantenabbli.