Kas yra Form Request klasės?

Question

Accepted Answer

**Form Request** klasės yra pasirinktinės užklauso klasės, kurios **įkapsulina patikrinimo (ir autorizacijos) logiką** konkrečiam užklausai. Jie perkeliama tikrinimo taisykles iš valdiklių į skirtus, pakartotinai naudojamus klasės — laikyti valdiklius plonus ir tikrinimą organizuotą.

## Form Request kūrimas ir naudojimas

```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
}
```

Kai naudojate type-hint Form Request valdiklio metode, Laravel **automatiškai vykdo jo autorizaciją ir patikrinimą prieš metodo vykdymą** — jei bet kuris nepavyksta, užklausa atmetama (403 autorizacijai, 422/peradresavimas patikrinimui) ir jūsų metodas niekada nebus vykdytas. Taigi metodo viduje jūs žinote, kad duomenys yra patikrinti ir veiksmas yra autorizuotas.

## Privalumai

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

## Kodėl tai svarbu

Form Request klasės yra svarbi Laravel geroji praktika patikrinimui ir autorizacijai švariai organizuoti — jie yra rekomenduojamas būdas bet ką daugiau nei trivinį patikrinimą, todėl juos suprasti yra vertinga rašant palaikomus Laravel programas.

Jų pagrindinis privalumas yra **valdiklius plonus**: perkeliant tikrinimo taisykles ir autorizacijos logiką į dedikuotą klasę (kurią Laravel automatiškai vykdo prieš valdiklio metodą), valdiklis lieka sutelktas į savo pagrindinę logiką, su garantija, kad duomenys jau yra patikrinti ir veiksmas yra autorizuotas, kai jis vykdomas.

Šis atskyrimas daro kodą daugiau **organizuotu** (visos taisykles, pasirinktini pranešimai ir autorizacija užklausal viename suderintame vietoje), **pakartotinai naudojamus** (ta pati Form Request gali būti naudojama keliuose galuose) ir švarius.

Auto **tikrinimo ir autorizacijos** kombinacija vienoje klasėje — abu patikrinti prieš valdiklio vykdymą, automatiškai atmetant negaliojančius arba neautorizuotus prašymus — yra elegantiška ir sumažina standartinį kodą.

Form Request supratimas, kaip jie vykdomi automatiškai ir patikrinimo/autorizacijos ištraukimo iš valdiklių privalumai atspindi brandą Laravel praktiką ir yra svarbu gerai sustrukturizuotiems programoms statyti, nes patikrinimas ir autorizacija yra visur suinteresuoti ir Form Request yra Lane švarUs ir idiomatinis būdas juo vadinti į neribotas atvejus — profesionalios, palaikomos Laravel kodo žymė.