Mitä ovat Laravel-kontrollerit?

Question

Accepted Answer

**Kontrollerit** ryhmittelevät toisiinsa liittyvää pyynnön käsittelylogiikkaa luokkiin. Sen sijaan, että sijoittaisit kaiken logiikan reitin sulkeumiin, kontrollerit organisoivat sovelluksen toiminnot (esim. kaikki käyttäjiin liittyvät toiminnot) menetelmiin — pitäen reitit puhtaina ja koodin organisoituna.

## Perusvalvoja

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

Luo yksi Artisanin kanssa: `php artisan make:controller UserController`. Jokainen menetelmä käsittelee yhtä toimintoa ja reitit osoittavat niihin.

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

**Resurssikontrolleri** sisältää vakio-CRUD-menetelmät, yhdistettynä `Route::resource`-komennolla perinteiseen RESTful-reititykseen — minimaalinen boilerplate-koodi tyypillisille CRUD-resursseille.

## Riippuvuuksien injektio kontrollereissa

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

Laravelin palvelusäiliö **injektoi automaattisesti** tyyppi-merkityt riippuvuudet kontrollerin rakentajiin ja menetelmiin (mukaan lukien `Request`) — siisti, testattava koodi.

## Pidä kontrollerit ohuina

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

## Miksi sillä on merkitystä

Kontrollerit ovat Laravelin ydinosa — ne organisoivat pyynnön käsittelylogiikkaa yhtenäisiksi luokiksi, mikä on välttämätöntä kaikissa sovelluksissa triviaaleista reitityksistä eteenpäin.

Kontrollerin luomisen, reittien yhdistämisen niiden menetelmiin ja erityisesti **resurssikontrollerin** käytön ymmärtäminen `Route::resource`-komennon kanssa (perinteistä RESTful CRUD:aa varten minimilaatuisella boilerplate-koodilla) on päivittäinen tieto Laravel-sovellusten rakentamisessa.

Laravelin keskeinen ominaisuus on **automaattinen riippuvuuksien injektio** kontrollereihin palvelusäiliön kautta — tyyppi-merkityt riippuvuudet (palvelut, pyyntö, postitukset) ratkaistaan ja injektoidaan automaattisesti, mikä mahdollistaa siistin, testattavan ja löyhästi kytketyn koodin.

Yhtä tärkeää on parhaiden käytäntöjen noudattaminen kontrollerien pitämisessä **ohueina** — käsittelemällä vain HTTP-huolia (validointi, palvelun kutsuminen, vastausten palauttaminen) ja delegoimalla liiketoimintalogiikkaa palveluille/malleille, mikä pitää koodin ylläpidettävänä ja testattavana.

Kontrollerit muodostavat yhdessä reitityksen ja mallien kanssa Laravelin pyynnön käsittelyn selkärangan, mikä tekee niistä perustavanlaatuisia hyvin organisoitujen, ammattimaisten Laravel-sovellusten rakentamiselle.