X'inhu controller f'Laravel?

Question

Accepted Answer

**Controller** jiġbdu l-loġika ta' ġestjoni tar-richiesta relatata f'klassijiet. Minflok tpoġġi l-loġika kollha f'closure ta' rotta, il-controllers jorganizzaw l-azzjonijiet ta' applikazzjoni (eż. operazzjonijiet kollha relatati mal-utent) f'metodi — u jżommu r-roti nettija u l-kodiċi organizzat.

## Controller bażiku

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

Igġenera b'Artisan: `php artisan make:controller UserController`. Kull metodu jħaddem għal azzjoni waħda, u r-roti jippuntaw lejnhom.

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

A **resource controller** għandha l-metodi CRUD standard, magħqudin ma' `Route::resource` għal routing RESTful konvenzjonali — kodice boilerplate minimu għal risorsi CRUD tipiku.

## Dependency injection f'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
    }
}
```

Il-service container ta' Laravel **awtomatikament injetta** dipendenzi ta' type-hinted fil-konstruttori u metodi tal-controller (inkluż `Request`) — kodiċi nazzid u testabbli.

## Żomm il-controllers irqieqa

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

## Għaliex Huwa Importanti

Controllers huma blokk fundamentali ta' Laravel — huma jorganizzaw il-loġika ta' ġestjoni tar-richiesta f'klassijiet kohezivi, li hija essenzjali għal kwalunkwe applikazzjoni wara roti trivjali.

L-għarfien ta' kif toħloq controllers, il-mapping ta' roti lejn il-metodi tagħhom, u speċjalment l-użu ta' **resource controller** ma' `Route::resource` (għal CRUD RESTful konvenzjonali b'kodice boilerplate minimu) huwa għarfien ta' kuljum għat-tbini ta' apps Laravel.

Karatteristika ewlenija ta' Laravel hija l-**injection ta' dipendenza awtomatika** f'controllers permezz tal-service container — dipendenzi ta' type-hinted (servizzi, ir-richiesta, mailers) huma risolti u injettati awtomatikament, li jippermettu kodiċi nazzid, testabbli u debolment akkupjat.

Egwalment importanti hija l-prattika aħjar li tżomm il-controllers **irqieqa** — iġestji biss ħtieġa HTTP (validazzjoni, ħolqod ta' servizzi, ritorn ta' responses) u ddelega l-loġika tan-negozju lill-servizzi/mudelli, li żżomm il-kodiċi mantenut u testabbli.

Controllers, flimkien mar-routing u l-mudelli, jiffurmaw l-ispina dorsali tal-ġestjoni tar-richiesta ta' Laravel, u jagħmilhom fundamentali għat-tbini ta' applikazzjonijiet Laravel organizzati tajjeb u professjonali.