Mik a Form Request osztályok?

Question

Accepted Answer

A **Form Request** osztályok olyan egyéni kérelemfeldolgozó osztályok, amelyek **az adott kérelem validációs (és engedélyezési) logikáját encapsulálják**. Ezek a validációs szabályokat az irányítók közül a dedikált, újrafelhasználható osztályokba helyezik — az irányítókat vékonynak és a validációt szervezettnek tartva.

## Form Request létrehozása és használata

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

Mikor egy Form Requestre type-hint-eznek az irányító metódusban, a Laravel **automatikusan futtatja az engedélyezést és az validációt, mielőtt a metódus végrehajtódna** — ha valamelyik meghiúsul, a kérelem elutasítódik (403 az engedélyezéshez, 422/átirányítás az validációhoz) és a metódus sosem fut le. Tehát a metóduson belül tudja, hogy az adatok érvényesek és a művelet engedélyezett.

## Az előnyök

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

## Miért fontos

A Form Request osztályok az adott kérelem validációjának és engedélyezésének tiszta szervezésére vonatkozó fontos Laravel best practice — a triviális validációnál túlmutató bármi esetében ajánlott megközelítés, ezért azok megértése értékes a karbantartható Laravel alkalmazások írásához.

Fő előnyük az **irányítók vékony megtartása**: a validációs szabályok és az engedélyezési logika áthelyezésével egy dedikált osztályba (amelyet a Laravel automatikusan futtat az irányító metódusa előtt), az irányító az alapvető logikájára marad fókuszálva, azzal az biztosítással, hogy az adatok már validáltak és a művelet engedélyezett a végrehajtás során.

Ez az elválasztás az kódot nagyobb mértékben **szervezetté** (minden szabály, egyéni üzenet és engedélyezés egy adott kérelemhez egy összetartó helyen), **újrafelhasználhatóvá** (ugyanaz a Form Request több végponton is használható) és tisztábbá teszi.

A **validáció és engedélyezés** automatikus kombinációja egy osztályban — mindkettő az irányító futása előtt ellenőrzött, az érvénytelen vagy engedély nélküli kérelmeket automatikusan elutasítva — elegáns és csökkenti a boilerplate kódot.

A Form Requesteket értelmezni, hogy miként futnak automatikusan és a validáció/engedélyezés irányítóból való kinyerésének előnyeit a érett Laravel gyakorlat tükrözi és a jól strukturált alkalmazások felépítéséhez fontos, mivel a validáció és engedélyezés mindenütt jelen lévő problémák és a Form Requestek a Laravel tiszta, idiomatikus módja ezek kezelésének a nem triviális esetek esetén — a professzionális, karbantartható Laravel kód jellemzője.