Czym są klasy Form Request?

Question

Accepted Answer

**Form Request** classes to niestandardowe klasy żądań, które **enkapsulują logikę walidacji (i autoryzacji)** dla konkretnego żądania. Przenoszą reguły walidacji z kontrolerów do dedykowanych, wielokrotnego użytku klas — utrzymując kontrolery szczupłe i organizując walidację.

## Tworzenie i używanie 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
}
```

Gdy typ-hintujesz Form Request w metodzie kontrolera, Laravel **automatycznie uruchamia autoryzację i walidację przed wykonaniem metody** — jeśli którakolwiek z nich nie powiedzie się, żądanie zostaje odrzucone (403 dla autoryzacji, 422/redirect dla walidacji) i Twoja metoda nigdy się nie wykonuje. Tak więc wewnątrz metody wiesz, że dane są ważne i działanie jest autoryzowane.

## Korzyści

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

## Dlaczego to ważne

Klasy Form Request to ważna best practice Laravel do czystej organizacji walidacji i autoryzacji — są zalecanym podejściem do wszystkiego poza trywialną walidacją, więc ich zrozumienie jest cenne dla pisania łatwo utrzymywanego kodu Laravel.

Ich główną korzyścią jest utrzymywanie **kontrolerów szczupłych**: przenosząc reguły walidacji i logikę autoryzacji do dedykowanej klasy (którą Laravel automatycznie uruchamia przed metodą kontrolera), kontroler pozostaje skoncentrowany na swojej podstawowej logice, z pewnością, że dane zostały już zwalidowane i działanie jest autoryzowane podczas wykonywania.

Ta separacja sprawia, że kod jest bardziej **zorganizowany** (wszystkie reguły, niestandardowe komunikaty i autoryzacja dla żądania w jednym spójnym miejscu), **wielokrotnego użytku** (ta sama Form Request może być użyta w różnych punktach końcowych) i czystszy.

Automatyczne połączenie **walidacji i autoryzacji** w jednej klasie — obie sprawdzane przed uruchomieniem kontrolera, automatycznie odrzucające nieprawidłowe lub nieautoryzowane żądania — jest eleganckie i zmniejsza boilerplate.

Zrozumienie Form Requests, jak działają automatycznie i korzyści z ekstrakcji walidacji/autoryzacji z kontrolerów odzwierciedla dojrzałą praktykę Laravel i jest ważne dla budowania dobrze ustrukturyzowanych aplikacji, ponieważ walidacja i autoryzacja to wszechobecne problemy, a Form Requests to czysty, idiomatyczny sposób Laravel na radzenie sobie z nimi w przypadkach nietrywialnych — cecha zawodowego, łatwo utrzymywanego kodu Laravel.