Što su kontroleri u Laravelu?

Question

Accepted Answer

**Controllers** grupiraju povezanu logiku rukovanja zahtjevima u klase. Umjesto stavljanja sve logike u route closures, kontroleri organiziraju akcije aplikacije (npr. sve operacije vezane uz korisnike) u metode — čineći rute čistima i kod organiziranim.

## Osnovni kontroler

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

Generirajte jedan s Artisanom: `php artisan make:controller UserController`. Svaka metoda upravlja jednom akcijom, a rute pokazuju na njih.

## Kontroleri resursa (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()
```

**Kontroler resursa** ima standardne CRUD metode, uparene s `Route::resource` za konvencionalno RESTful rutiranje — minimalna boilerplate za tipične CRUD resurse.

## Injekcija ovisnosti u kontrolere

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

Laravelov servis kontejner **automatski injektira** type-hinted ovisnosti u kontrolere konstruktore i metode (uključujući `Request`) — čist, testabilan kod.

## Zadržite kontrolere tanke

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

## Zašto je to važno

Kontrolerit su temeljni Laravelov blok — organiziraju logiku rukovanja zahtjevima u kohezivne klase, što je neophodno za bilo koju aplikaciju nakon trivijalnih ruta.

Razumijevanje kako kreirati kontrolere, mapirati rute na njihove metode, i posebno koristiti **kontrolere resursa** s `Route::resource` (za konvencionalno RESTful CRUD s minimalnom boilerplate) je svakodnevno znanje za izgradnju Laravel aplikacija.

Ključna Laravelova značajka je **automatska injekcija ovisnosti** u kontrolere putem servis kontejnera — type-hinted ovisnosti (servisi, zahtjev, pošiljači) se automatski razriješavaju i injektiraju, omogućujući čist, testabilan, slabo povezan kod.

Jednako važna je praksa dobrog koda zadržavanja kontrolera **tankih** — rukovanje samo HTTP zahtjevima (validacija, pozivanje servisa, vraćanje odgovora) i delegiranje poslovne logike servisima/modelima, što čini kod održivim i testabilnim.

Kontrolerit, zajedno s rutiranjem i modelima, čine okosnicu Laravelovog rukovanja zahtjevima, čineći ih fundamentalnima za izgradnju dobro organiziranih, profesionalnih Laravel aplikacija.