Cosa sono i controller in Laravel?

Question

Accepted Answer

I **controller** raggruppano la logica correlata di gestione delle richieste in classi. Invece di inserire tutta la logica nelle closure delle route, i controller organizzano le azioni di un'applicazione (ad es. tutte le operazioni relative agli utenti) in metodi — mantenendo le route pulite e il codice organizzato.

## Un controller di base

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

Generane uno con Artisan: `php artisan make:controller UserController`. Ogni metodo gestisce un'azione e le route puntano ad essi.

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

Un **resource controller** ha i metodi CRUD standard, abbinati a `Route::resource` per il routing RESTful convenzionale — boilerplate minimo per le risorse CRUD tipiche.

## Dependency injection nei controller

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

Il service container di Laravel **inietta automaticamente** le dipendenze con type hint nei costruttori e nei metodi del controller (inclusa la `Request`) — codice pulito e testabile.

## Mantieni i controller snelli

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

## Perché è importante

I controller sono un componente fondamentale di Laravel — organizzano la logica di gestione delle richieste in classi coese, essenziale per qualsiasi applicazione al di là di route banali.

Comprendere come creare controller, mappare le route ai loro metodi e soprattutto utilizzare **resource controller** con `Route::resource` (per CRUD RESTful convenzionale con boilerplate minimo) è conoscenza quotidiana per costruire app Laravel.

Una caratteristica chiave di Laravel è l'**iniezione di dipendenze automatica** nei controller tramite il service container — le dipendenze con type hint (servizi, la request, mailer) vengono risolte e iniettate automaticamente, abilitando codice pulito, testabile e debolmente accoppiato.

Egualmente importante è la best practice di mantenere i controller **snelli** — gestendo solo le questioni HTTP (validazione, chiamata di servizi, restituzione di risposte) e delegando la logica di business a servizi/modelli, il che mantiene il codice manutenibile e testabile.

I controller, insieme al routing e ai modelli, formano la spina dorsale della gestione delle richieste di Laravel, rendendoli fondamentali per costruire applicazioni Laravel ben organizzate e professionali.