რა არის კონტროლერები Laravel-ში?

Question

Accepted Answer

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

## ძირითადი კონტროლერი

```php
<?php
class UserController extends Controller {
    public function index() {
        return User::all();              // list users
    }
    public function show(User $user) {   // route model binding — auto-fetch by id
        return $user;
    }
    public function store(Request $request) {
        $validated = $request->validate(['name' => 'required', 'email' => 'required|email']);
        return User::create($validated);  // create
    }
}
```

გამომუშავება Artisan-ით: `php artisan make:controller UserController`. თითოეული მეთოდი ამუშავებს ერთ ქმედებას და მარშრუტები მიმართავენ მათ.

## რესურსის კონტროლერი (RESTful CRUD)

```php
// generate a controller with all 7 RESTful methods stubbed
// php artisan make:controller PostController --resource

Route::resource('posts', PostController::class);   // maps routes to the methods:
// index() create() store() show() edit() update() destroy()
```

**რესურსის კონტროლერი** აქვს სტანდარტული CRUD მეთოდები, `Route::resource`-ის სიტყვებთან საკონვენციო RESTful მარშრუტიზაციისთვის — მინიმალური ნიმუშის კოდი ტიპიური CRUD რესურსებისთვის.

## დამოკიდებულების ინჯექცია კონტროლერებში

```php
class OrderController extends Controller {
    // type-hinted dependencies are AUTO-INJECTED by Laravel's service container
    public function __construct(private OrderService $orders) {}

public function store(Request $request, Mailer $mailer) {   // method injection too
        // $request and $mailer are resolved & injected automatically
    }
}
```

Laravel-ის სერვის კონტეინერი **ავტომატურად ფილტრავს** ტიპ-მინიშნილი დამოკიდებულებებს კონტროლერის კონსტრუქტორებში და მეთოდებში (მათ შორის `Request`) — სუფთა, ტესტირებული კოდი.

## კონტროლერების თხელი შენარჩუნება

```text
✓ Controllers should handle HTTP concerns (validate input, call services, return responses)
✗ Business logic belongs in SERVICES/models, not bloated controllers ("thin controllers")
```

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

კონტროლერები არის Laravel-ის ძირითადი სამშენებლო ბლოკი — ისინი ორგანიზებენ მოთხოვნის დამუშავების ლოგიკას თავკოჰეზიური კლასებში, რაც აუცილებელია ნებისმიერი აპლიკაციისთვის ტრივიალური მარშრუტების გარეშე.

კონტროლერების შექმნის, მარშრუტების მათ მეთოდებში რუკაციის და განსაკუთრებით **რესურსის კონტროლერების** `Route::resource`-ით გამოყენების გაგება (საკონვენციო RESTful CRUD-ისთვის მინიმალური ნიმუშის კოდით) არის ყოველდღიური ცოდნა Laravel აპლიკაციების აგებისთვის.

Laravel-ის ძირითადი ფიცრია **ავტომატური დამოკიდებულების ინჯექცია** კონტროლერებში სერვის კონტეინერის მეშვეობით — ტიპ-მინიშნილი დამოკიდებულებები (სერვისები, მოთხოვნა, მეილერი) გადაჭრის ხდება და ავტომატურად ფილტრავს, რაც ხელმძღვანელობს სუფთა, ტესტირებული, სუსტი დაკავშირების კოდს.

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

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