Что такое контроллеры в Laravel?

Question

Accepted Answer

**Контроллеры** группируют связанную логику обработки запросов в классы. Вместо того чтобы размещать всю логику в замыканиях маршрутов, контроллеры организуют действия приложения (например, все операции, связанные с пользователем) в методы — сохраняя маршруты чистыми и код организованным.

## Базовый контроллер

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

Создайте его с помощью Artisan: `php artisan make:controller UserController`. Каждый метод обрабатывает одно действие, а маршруты указывают на них.

## Контроллеры ресурсов (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()
```

**Контроллер ресурса** содержит стандартные методы CRUD, связанные с `Route::resource` для условного маршрутизирования RESTful — минимальный шаблонный код для типичных ресурсов CRUD.

## Внедрение зависимостей в контроллеры

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

Контейнер сервисов Laravel **автоматически внедряет** типизированные зависимости в конструкторы и методы контроллеров (включая `Request`) — чистый, тестируемый код.

## Сохраняйте контроллеры тонкими

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

## Почему это важно

Контроллеры — это основной строительный блок Laravel — они организуют логику обработки запросов в целостные классы, что необходимо для любого приложения, выходящего за рамки тривиальных маршрутов.

Понимание того, как создавать контроллеры, сопоставлять маршруты с их методами и особенно использовать **контроллеры ресурсов** с `Route::resource` (для условного RESTful CRUD с минимальным шаблонным кодом), — это повседневные знания при создании приложений Laravel.

Ключевая особенность Laravel — **автоматическое внедрение зависимостей** в контроллеры через контейнер сервисов — типизированные зависимости (услуги, запрос, почтовые программы) автоматически разрешаются и внедряются, обеспечивая чистый, тестируемый и слабо связанный код.

Единственно важная практика — сохранение контроллеров **тонкими** — обработка только проблем HTTP (проверка, вызов сервисов, возврат ответов) и делегирование бизнес-логики сервисам/моделям, что сохраняет код maintainable и тестируемым.

Контроллеры вместе с маршрутизацией и моделями составляют основу обработки запросов Laravel, делая их фундаментальными для создания хорошо организованных, профессиональных приложений Laravel.