Controllers ni nini katika Laravel?

Question

Accepted Answer

**Controllers** hukusanya mantiki inayohusiana ya kushughulikia maombi katika classes. Badala ya kuweka mantiki yote ndani ya closures za route, controllers hupanga vitendo vya programu (mfano, operesheni zote zinazohusiana na mtumiaji) katika methods — zikiweka routes safi na msimbo uliopangwa.

## Controller ya msingi

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

Zalisha moja kwa Artisan: `php artisan make:controller UserController`. Kila method hushughulikia kitendo kimoja, na routes huelekeza kwao.

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

**Resource controller** ina methods za kawaida za CRUD, zikioanishwa na `Route::resource` kwa routing ya kawaida ya RESTful — boilerplate ndogo kwa rasilimali za kawaida za CRUD.

## Dependency injection katika controllers

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

Service container ya Laravel **huingiza kiotomatiki** dependencies zenye type-hint kwenye constructors na methods za controller (ikiwemo `Request`) — msimbo safi unaoweza kupimwa.

## Weka controllers nyembamba

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

## Kwa nini ni muhimu

Controllers ni kipengele cha msingi cha Laravel — hupanga mantiki ya kushughulikia maombi katika classes zenye mshikamano, jambo ambalo ni muhimu kwa programu yoyote inayozidi routes za kawaida.

Kuelewa jinsi ya kuunda controllers, kuunganisha routes na methods zao, na hasa kutumia **resource controllers** na `Route::resource` (kwa CRUD ya kawaida ya RESTful yenye boilerplate ndogo) ni maarifa ya kila siku kwa kujenga programu za Laravel.

Kipengele muhimu cha Laravel ni **dependency injection ya kiotomatiki** kwenye controllers kupitia service container — dependencies zenye type-hint (services, request, mailers) hutatuliwa na kuingizwa kiotomatiki, kuwezesha msimbo safi, unaoweza kupimwa, na usiounganishwa kwa nguvu.

Muhimu kwa usawa ni mazoea bora ya kuweka controllers **nyembamba** — kushughulikia tu mambo ya HTTP (validation, kuita services, kurudisha responses) na kukabidhi mantiki ya biashara kwa services/models, jambo linaloweka msimbo unaoweza kudumishwa na kupimwa.

Controllers, pamoja na routing na models, huunda uti wa mgongo wa ushughulikiaji wa maombi wa Laravel, na kuzifanya kuwa za msingi kwa kujenga programu za Laravel zilizopangwa vizuri na za kitaalamu.