Çfarë janë kontrollerët në Laravel?

Question

Accepted Answer

**Kontrollerët** grupojnë logjikën lidhur me trajtimin e kërkesave në klasa. Në vend që të vendosim të gjithë logjikën në mbyllje rutash, kontrollerët organizojnë veprimet e aplikacionit (p.sh. të gjitha operacionet lidhur me përdoruesin) në metoda — duke mbajtur rutât të pastra dhe kodin të organizuar.

## Një kontroller bazik

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

Gjeneroni një me Artisan: `php artisan make:controller UserController`. Secila metodë trajton një veprim, dhe rutât tregojnë drejt tyre.

## Kontrollerët e resurseve (CRUD RESTful)

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

Një **kontroller resursi** ka metodat standarde CRUD, të çiftuara me `Route::resource` për rutimin konvencional RESTful — boilerplate minimal për resurset tipike CRUD.

## Injektimi i varësisë në kontrollerë

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

Kontejneri i shërbimit të Laravel-it **injekton automatikisht** varësitë e tiparizuara në konstruktorat dhe metodat e kontrollerit (përfshirë `Request`) — kod i pastr dhe i testueshem.

## Mbajini kontrollerët të hollë

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

## Pse ka rëndësi

Kontrollerët janë një bllok ndërtimi bazë i Laravel-it — ata organizojnë logjikën e trajtimit të kërkesave në klasa koherente, e cila është thelbësore për çdo aplikacion përtej rutave banale.

Zotërimi se si të krijoni kontrollerë, të hartoni rutât në metodat e tyre, dhe veçanërisht të përdorni **kontrollerë resursesh** me `Route::resource` (për CRUD RESTful konvencional me boilerplate minimal) është njohuri e përditshme për ndërtimin e aplikacioneve Laravel.

Një tipar kryesor i Laravel-it është **injektimi automatik i varësisë** në kontrollerë përmes kontejnerit të shërbimit — varësitë e tiparizuara (shërbime, kërkesa, postues) zgjidhen dhe injektohen automatikisht, duke mundësuar kod të pastr, të testueshem dhe të lirë nga çiftimi i fortë.

Njësoj e rëndësishme është praktika më e mirë e mbajjes së kontrollerëve **të hollë** — trajtimin vetëm të shqetësimeve HTTP (validimin, thirrjen e shërbimeve, kthimin e përgjigjeve) dhe delegimin e logjikës biznesore në shërbime/modele, e cila e ruan kodin të mirëmbajtshëm dhe të testueshem.

Kontrollerët, së bashku me rutimin dhe modelet, formojnë bazën e trajtimit të kërkesave të Laravel-it, duke i bërë ato themelore për ndërtimin e aplikacioneve Laravel të mirë-organizuara dhe profesionale.