Ce sunt controlerele în Laravel?

Question

Accepted Answer

**Controlerele** grupează logica de gestionare a cererii conexe în clase. În loc să punem toată logica în closure-uri de rută, controlerele organizează acțiunile unei aplicații (de exemplu, toate operațiile legate de utilizator) în metode — păstrând rutele curate și codul organizat.

## Un controler de bază

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

Generează-l cu Artisan: `php artisan make:controller UserController`. Fiecare metodă gestionează o acțiune, iar rutele le indică.

## Controlerele de resurse (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 **controler de resurse** are metodele standard CRUD, împerecheat cu `Route::resource` pentru rutarea RESTful convențională — boilerplate minim pentru resursele CRUD tipice.

## Injectarea dependenței în controlerele

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

Conteinerul de servicii Laravel **injectează automat** dependențele cu type-hint în constructorii și metodele controlerului (inclusiv `Request`) — cod curat și testabil.

## Ține controlerele subțiri

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

## De ce conteaza

Controlerele sunt un bloc de construcție central al Laravel — organizează logica de gestionare a cererii în clase coezive, ceea ce este esențial pentru orice aplicație dincolo de rutele triviale.

Înțelegerea modului de creare a controlerelor, maparea rutelor la metodele lor și, în special, utilizarea **controlerelor de resurse** cu `Route::resource` (pentru CRUD RESTful convențional cu boilerplate minim) este cunoștințe zilnice pentru construirea aplicațiilor Laravel.

O caracteristică cheie a Laravel este **injectarea automată de dependență** în controlerele prin containerul de servicii — dependențele cu type-hint (servicii, cererea, mailers) sunt rezolvate și injectate automat, permițând cod curat, testabil și slab cuplat.

La fel de important este buna practică de a ține controlerele **subțiri** — gestionând doar preocupări HTTP (validare, apelarea serviciilor, returnarea răspunsurilor) și delegând logica de afaceri către servicii/modele, ceea ce menține codul ușor de întreținut și testabil.

Controlerele, împreună cu rutarea și modelele, formează coloana vertebrală a gestionării cererii Laravel, făcând-le fundamentale pentru construirea aplicațiilor Laravel bine organizate și profesionale.