რა არის Form Request კლასები?

Question

Accepted Answer

**Form Request** კლასები წარმოადგენს საკუთარი request კლასებს, რომლებიც **ინკაპსულირებენ ვალიდაციის (და ავტორიზაციის) ლოგიკას** კონკრეტული request-ისთვის. ისინი ვალიდაციის წესებს გადაადგილებენ კონტროლერებიდან ამოდელებულ, გამოსაყენებელი კლასებში — კონტროლერებს დაბალი და ვალიდაცია ორგანიზებული რაოდენობის მოთხოვნა.

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

რომელი Form Request-ის ტიპი-მინიშვნებით კონტროლერის მეთოდში, Laravel **ავტომატურად გაშვებს მის ავტორიზაციას და ვალიდაციას მეთოდის შესრულებამდე** — თუ რომელიმე წარუმატებელია, request უარყოფილია (403 ავტორიზაციისთვის, 422/გადამისამართება ვალიდაციისთვის) და თქვენი მეთოდი არ გაშვება. ასე რომ მეთოდის შიგნით, თქვენ იცით, რომ მონაცემები ვალიდია და ქმედება ავტორიზებულია.

## სარგებელი

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

## რატომ არის ეს მნიშვნელოვანი

Form Request კლასები არის Laravel-ის მნიშვნელოვანი საუკეთესო პრაქტიკა ვალიდაციის და ავტორიზაციის სუფთად ორგანიზაციისთვის — ისინი რეკომენდებული მიდგომაა რაიმე ბანალური ვალიდაციის ფარგლებს გარეთ, ასე რომ მათი გაგება ღირებული ხელმისაწვდომი Laravel აპლიკაციების დასაწერად.

თავისი ძირითადი სარგებელი არის **კონტროლერების დაბალი შენახვა**: ვალიდაციის წესებისა და ავტორიზაციის ლოგიკის გადაადგილებით ამოდელებულ კლასში (რომლებიც Laravel ავტომატურად გაშვებს კონტროლერის მეთოდის წინ), კონტროლერი რჩება ფოკუსირებული მის ძირითად ლოგიკაზე, იმ დაკვირვებით, რომ მონაცემები უკვე ვალიდირებულია და ქმედება ავტორიზებულია როდესაც იგი შესრულებულია.

ეს განცალკევება კოდს უფრო **ორგანიზებულს** (ყველა წესი, საკუთარი შეტყობინებები და request-ის ავტორიზაცია ერთ კოჰეზიური ადგილে), **გამოსაყენებელს** (იგივე Form Request შეიძლება გამოყენებული იყოს მრავალ endpoint-ში) და სუფთას.

**ვალიდაციის და ავტორიზაციის** ავტომატური კომბინაცია ერთ კლასში — ორივე შემოწმებული კონტროლერის გაშვებამდე, არასწორი ან არაავტორიზებული request-ების ავტომატური უარყოფა — ელეგანტური და ამცირებს boilerplate-ს.

Form Request-ების გაგება, როგორ გაშვება ისინი ავტომატურად და ვალიდაციის/ავტორიზაციის გამოთხოვის სარგებელი კონტროლერებიდან ასახავს მომწიფო Laravel პრაქტიკას და მნიშვნელოვანია კარგად სტრუქტურირებული აპლიკაციების აგებისთვის, რადგან ვალიდაცია და ავტორიზაცია არის სიდიდე გაზრდილი ინტერესები და Form Request-ები არის Laravel-ის სუფთა, იდიომატური გზა მათი დამუშავებისთვის არა-ტრივიალური შემთხვევების — ამის ნიშანი რომელიც პროფესიონალური, რომელიც მოთხოვნილი Laravel კოდი.