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`。各メソッドは1つのアクションを処理し、ルートはそれらを指します。

## リソースコントローラー（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メソッドを持ち、従来のRESTfulルーティング用に`Route::resource`と対になっています — 典型的な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関連の処理（検証、サービス呼び出し、レスポンス返却）のみを処理し、ビジネスロジックはサービス/モデルに委譲することで、コードの保守性とテスト可能性を保ちます。

コントローラーは、ルーティングとモデルとともに、Laravelのリクエスト処理の中枢を形成し、整理されたプロフェッショナルなLaravelアプリケーションの構築には不可欠です。