Czym są kontrolery w Laravel?

Question

Accepted Answer

**Kontrolery** grupują powiązaną logikę obsługi żądań w klasy. Zamiast umieszczać całą logikę w domknięciach tras, kontrolery organizują akcje aplikacji (np. wszystkie operacje związane z użytkownikami) w metody — utrzymując trasy czyste i kod zorganizowany.

## Podstawowy kontroler

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

Wygeneruj go za pomocą Artisan: `php artisan make:controller UserController`. Każda metoda obsługuje jedną akcję, a trasy wskazują na nich.

## Kontrolery zasobów (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()
```

**Kontroler zasobów** posiada standardowe metody CRUD, połączone z `Route::resource` dla konwencjonalnego routingu RESTful — minimalne szablony dla typowych zasobów CRUD.

## Wstrzykiwanie zależności w kontrolerach

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

Kontener usług Laravel **automatycznie wstrzykuje** typowane zależności do konstruktorów i metod kontrolerów (w tym `Request`) — czysty, testowany kod.

## Trzymaj kontrolery szczupłe

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

## Dlaczego to ważne

Kontrolery są kluczowym elementem Laravel — organizują logikę obsługi żądań w spójne klasy, co jest niezbędne dla każdej aplikacji poza trywialnych trasami.

Zrozumienie, jak tworzyć kontrolery, mapować trasy na ich metody, a zwłaszcza używać **kontrolery zasobów** z `Route::resource` (do konwencjonalnego RESTful CRUD z minimalnymi szablonami) to wiedza na co dzień podczas tworzenia aplikacji Laravel.

Kluczową funkcją Laravel jest **automatyczne wstrzykiwanie zależności** do kontrolerów za pośrednictwem kontenera usług — typowane zależności (usługi, żądanie, programy pocztowe) są automatycznie rozwiązywane i wstrzykiwane, umożliwiając czysty, testowany, słabo powiązany kod.

Równie ważne jest najlepsze praktyki polegające na trzymaniu kontrolerów **szczupłych** — obsługiwanie tylko obaw HTTP (weryfikacja, wywoływanie usług, zwracanie odpowiedzi) i delegowanie logiki biznesowej do usług/modeli, co utrzymuje kod łatwy w utrzymaniu i testowaniu.

Kontrolery, razem z routingiem i modelami, tworzą kręgosłup obsługi żądań Laravel, czyniąc je fundamentalnymi do budowania dobrze zorganizowanych, profesjonalnych aplikacji Laravel.