Cad iad na controllers i Laravel?

Question

Accepted Answer

**Controllers** group related request-handling logic into classes. Instead of putting all logic in route closures, controllers organize an application's actions (e.g. all user-related operations) into methods — keeping routes clean and code organized.

## Controller bunúsach

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

Gin ceann le Artisan: `php artisan make:controller UserController`. Láimhseálann gach modh gníomh amháin, agus cuireann imlínte pointí ar a leithéid.

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

Tá na gnáth-mhodhanna CRUD ag **resource controller**, in éineacht le `Route::resource` do chonradh RESTful traidisiúnta — boilerplate íosta do dhaingean CRUD tipiciúil.

## Instealladh eisíochta i controllersanna

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

**Isteallann** gréasán seirbhíse Laravel go huathoibríoch spleáchais atá cineál-gheal isteach i dtógálaithe agus modhanna controllersanna (lena n-áirítear an `Request`) — cód glan agus tástáilte.

## Fanaigí ar controllersanna tanaí

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

## Cén fáth a bhfuil sé tábhachtach

Is bloc bunúsach Laravel iad controllersanna — eagraíonn siad loighic láimhseála iarratas ina ranganna comhsheasmhach, rud atá riachtanach d'aon fheidhmchlár lasmuigh de bhristeacha fánach.

Tá sé ríthábhachtach a thuiscint conas controllersanna a chruthú, imlínte a dhréachú dá nmodhanna, agus go háirithe **resource controllers** a úsáid le `Route::resource` (do CRUD RESTful traidisiúnta le boilerplate ar a laghad) an ghnáth-eolais do thógáil a fheidhmchláir Laravel.

Is gné ríthábhachtach de Laravel an **instealladh eisíochta uathoibríoch** ina controllersanna trí ghréasán seirbhíse — réitítear spleáchais atá cineál-gheal (seirbhísí, an iarratas, mailers) agus instealltar go huathoibríoch, rud a chumasaíonn cód glan, inbhraite agus go foluain-nasctha.

Is é an gnáthamh is tábhachtaí chomh maith ná controllersanna a choinneáil **tanaí** — níl le déanamh ach imní HTTP a láimhseáil (bailíochtú, seirbhísí a ghlaoch, freagraí a thharraingt) agus loighic ghnó a dhíothú chuig seirbhísí/samhlacha, rud a sheachaintíonn an cód a bheith inbhraite agus tástáilte.

I leith controllersanna, mar aon le routáil agus samhlacha, is iad is dromchla iarrataí-láimhseála a dhéanann an chóras, rud a dhéanann siad bunúsach do thógáil feidhmchláir Laravel a bhíonn eagraithe go maith agus gairmiúil.