Mitä ovat Form Request -luokat?

Question

Accepted Answer

**Form Request** -luokat ovat mukautettuja request-luokkia, jotka **kapseloivat validointi- (ja autorisointilogiikan)** tietylle requestille. Ne siirtävät validointisäännöt pois kontrolleista omille, uudelleenkäytettäville luokille — pitäen kontrollerit ohuina ja validoinnin organisoituna.

## Form Requestin luominen ja käyttäminen

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

Kun type-hinttaat Form Requestin kontrollerinmenetelmässä, Laravel **suorittaa automaattisesti sen autorisointin ja validoinnin ennen kuin metodi suoritetaan** — jos jompikumpi epäonnistuu, request hylätään (403 autorisoinnille, 422/uudelleenohjaus validoinnille) eikä metodisi koskaan suorita. Joten metodin sisällä tiedät, että data on kelvollinen ja toiminto on valtuutettu.

## Hyödyt

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

## Miksi sillä on merkitystä

Form Request -luokat ovat tärkeä Laravel-paras käytäntö validoinnin ja autorisoinnin siivoamiseen — ne ovat suositeltu lähestymistapa mihin tahansa triviaalin validoinnin ulkopuolelle, joten niiden ymmärtäminen on arvokasta, kun kirjoitetaan ylläpidettäviä Laravel-sovelluksia.

Niiden keskeinen etu on **kontrollerien pitäminen ohuina**: siirtämällä validointisäännöt ja autorisointilogiikan omalle luokalle (jonka Laravel suorittaa automaattisesti ennen kontrollerinmenetelmää), kontrolleri pysyy keskittyneenä ydinlogiikkaansa, sillä varmuudella että data on jo validoitu ja toiminto on valtuutettu sen suorittaessa.

Tämä erottelu tekee koodista **organisoidumpaa** (kaikki säännöt, mukautetut viestit ja pyynnön autorisoinit yhdessä koherenteissa paikassa), **uudelleenkäytettävämpää** (sama Form Request voidaan käyttää useissa päätepisteissä) ja puhtaampaa.

Automaattinen **validoinnin ja autorisoinnnin** yhdistäminen yhdessä luokassa — molemmat tarkistettu ennen kuin kontrolleri suoritetaan, hylkäämällä kelpaamattomia tai valtuuttamattomia pyyntöjä automaattisesti — on elegantti ja vähentää boilerplate-koodia.

Form Requestien ymmärtäminen, kuinka ne suoritetaan automaattisesti, ja validoinnin/autorisoinnnin irrottamisen hyödyt kontrolleista heijastaa kypsää Laravel-käytäntöä ja on tärkeä hyvin strukturoitujen sovellusten rakentamiselle, koska validointi ja autorisointi ovat kaikkialla olevia huolenaiheita ja Form Requestit ovat Laravellin puhdas, idiomatinen tapa käsitellä niitä ei-triviaalissa tapauksissa — ammattimaisuuden ja ylläpidettävyyden merkki Laravel-koodissa.