Cilat janë klasat Form Request?

Question

Accepted Answer

**Form Request** klasat janë klasa të personalizuara request-i që **përfshinë logjikën e validimit (dhe autorizimit)** për një kërkesë specifike. Ato lëvizin rregullat e validimit jashtë kontrolluesve në klasa të dedikuara, të riusshme — duke mbajtur kontrolluesit të hollë dhe validimin të organizuar.

## Krijimi dhe përdorimi i një 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
}
```

Kur type-hint një Form Request në një metodë kontrollueseje, Laravel **ekzekuton automatikisht autorizimin dhe validimin e tij përpara se metoda të ekzekutohet** — nëse ndonjëra dështon, kërkesa refuzohet (403 për autorizim, 422/redirect për validim) dhe metoda juaj nuk ekzekutohet kurrë. Kështu brenda metodës, e dini që të dhënat janë të vlefshme dhe veprimi është autorizuar.

## Përfitimet

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

## Pse është e rëndësishme

Form Request klasat janë një praktikë e rëndësishme Laravel për organizimin e validimit dhe autorizimit në mënyrë të pastër — ato janë qasja e rekomanduar për çdo gjë përtej validimit trivial, kështu që kuptimi i tyre është i vlefshëm për shkrimin e aplikacioneve Laravel të mirëmbajtshme.

Benefiti i tyre kryesor është mbajta e **kontrolluesve të hollë**: duke lëvizur rregullat e validimit dhe logjikën e autorizimit në një klasë të dedikuar (që Laravel ekzekuton automatikisht përpara metodës së kontrolluesit), kontrolluesja qëndron e fokusuar në logjikën e saj themelore, me sigurinë që të dhënat janë tashmë të validuara dhe veprimi autorizuar kur ekzekutohet.

Ky ndarim e bën kodin më **të organizuar** (të gjitha rregullat, mesazhet e personalizuara, dhe autorizimi për një kërkesë në një vend koherent), **të riusshëm** (e njëjta Form Request mund të përdoret në të gjithë endpoints), dhe më i pastër.

Kombinimi automatik i **validimit dhe autorizimit** në një klasë — të dyja kontrolluar përpara se kontrolluesja të ekzekutohet, duke refuzuar automatikisht kërkesa të pavlefshme ose të paautoruara — është elegant dhe zvogëlon boilerplate.

Kuptimi i Form Requests, si ato ekzekutohen automatikisht, dhe përfitimet e nxjerrjes së validimit/autorizimit nga kontrolluesit pasqyron praktikën e pjekur Laravel dhe është i rëndësishëm për ndërtimin e aplikacioneve të strukturuara mirë, pasi validimi dhe autorizimi janë shqetesime të përhapura dhe Form Requests janë mënyra e pastër, idiomatike e Laravel për t'u trajtuar për rastet jo-triviale — një karakteristikë e kodit Laravel profesional, të mirëmbajtshëm.