LaravelのControllerとは？初心者でもわかる基本と活用法
はじめに
Laravelでアプリケーションを開発しようとすると、多くの方が最初に意識するのがControllerです。 プログラミング初心者の皆さんは、「Controllerって何をするところなんだろう？」と感じるかもしれませんね。 実際、初めて触れるときは専門用語やMVCという構造が難しく見えますが、一つひとつの役割を理解すれば、全体像はそれほど複雑ではありません。
ここでは、LaravelにおけるControllerの基本的な考え方と、実際の作成手順についてやさしく説明していきます。 初めてプログラミングに挑戦する方や、MVCという構造自体がまだよく分からないという方でも理解できるように進めます。 「どうやってコードを書いたらいいの？」という疑問が少しでも解消されれば嬉しいです。
この記事を読むとわかること
- LaravelのControllerの役割と、MVC構造内での位置づけ
- 具体的なControllerの作り方と、実務での利用イメージ
- Resource ControllerやSingle Action Controllerといった便利な仕組み
- Viewへのデータの渡し方やリダイレクトの基本
- コントローラを使ったシンプルなAPI実装のポイント
LaravelのControllerが担う役割
Controllerは、ユーザーからのリクエストを受け取り、必要なデータをモデルから取得し、ビューへ渡す役割を担います。 これを「ビジネスロジックをまとめる場所」と説明されることもありますが、実際にはデータの取得・保存などはモデル側で処理し、Controllerはその橋渡しを行うことが多いです。
たとえば、ユーザー登録の処理を考えてみましょう。 フォームから入力された情報を受け取るのはControllerですが、そのデータを保存するのはモデルの仕事になります。 こうした形で責任を分割することで、システムが大きくなっても保守しやすくなりますね。
一方で、現場ではControllerが肥大化することも少なくありません。 肥大化を防ぐために、処理の詳細はモデルや別のサービスクラスに任せ、Controllerでは基本的な受け渡しや流れの制御だけに集中させることが大切です。 これにより可読性や拡張性が上がり、チーム開発でも整理しやすくなります。
Controllerとルーティングの関係
Laravelでは、URLへのアクセスとControllerの呼び出しがルーティングによって結びつきます。
routes/web.php もしくは routes/api.php のファイルにて、Route::get() や Route::post() などでURLパターンとControllerメソッドを紐付ける設定を行うのが一般的です。
初心者の方にとって重要なのは、Controllerを呼び出すには、必ずルーティングで関連付けが必要ということです。 逆に言えば、ルーティングなしにControllerが単独で動くことはありません。 また、ひとつのControllerには複数のメソッドを定義できるので、URLごとに異なるメソッドを呼び出す形になります。
以下はサンプルとして、ユーザーを管理するControllerをルーティングで呼び出す例です。
UserController という名前のControllerを用意しておき、ルーティングで index や show などのメソッドを紐づけます。
コード例はあくまで基本的なイメージとして参考にしてみてください。
// routes/web.php use App\Http\Controllers\UserController; Route::get('/users', [UserController::class, 'index']); Route::get('/users/{id}', [UserController::class, 'show']);
このように記述することで、/users にアクセスしたときは UserController の index が、/users/{id} にアクセスしたときは show が呼び出されます。
Controllerの基本的な作成手順
ここからは、実際にControllerを作る手順を見てみましょう。 Laravelでは、一般的にターミナルから Artisan コマンドを使ってControllerファイルを生成します。 基本的な作成コマンドの例は次のとおりです。
php artisan make:controller UserController
このコマンドを実行すると、app/Http/Controllers ディレクトリに UserController というファイルが作成されます。
作成されたファイルを開くと、namespace や use Illuminate\Http\Request; などがあらかじめ書かれています。
以降は、必要なメソッドを追加していくだけです。
メソッド名は自由に設定できますが、後述する「リソースコントローラ」を使う場合には、一覧表示なら index、詳細表示なら show といった具合に、命名規則を統一するとコードの見通しが良くなります。
コード例：UserController
<?php namespace App\Http\Controllers; use Illuminate\Http\Request; class UserController extends Controller { // ユーザー一覧を表示するメソッド public function index() { // ここでデータベースからユーザー一覧を取得するとします $users = [ ['id' => 1, 'name' => 'Taro', 'email' => 'taro@example.com'], ['id' => 2, 'name' => 'Hanako', 'email' => 'hanako@example.com'] ]; // 取得したデータをビューへ渡す return view('users.index', ['users' => $users]); } // ユーザー詳細を表示するメソッド public function show($id) { // 実際には$idで該当ユーザーを検索 $userDetail = [ 'id' => $id, 'name' => 'Dummy User', 'email' => 'dummy@example.com' ]; return view('users.show', ['user' => $userDetail]); } }
上記の index メソッドで、ダミーのユーザーリストを $users として定義しています。
実務ではモデルを呼び出してデータベースから取り出しますが、基本的な流れは同じです。
return view('xxx') という書き方で、指定のビューにデータを渡して表示させるイメージが持ちやすいでしょう。
Resource Controllerを活用する
Laravelには、Resource Controller という便利な機能があります。
これは、CRUD操作におけるメソッドをあらかじめ用意し、その命名を統一するための仕組みです。
具体的には、index, create, store, show, edit, update, destroy といったメソッド名がデフォルトで用意され、一定の規則に沿ってURLルーティングが自動的に割り当てられます。
もしCRUD操作が主体の機能であれば、Resource Controllerを使うことでコードの構成が整理され、可読性が高まります。
手動でルーティングを細かく設定しなくても、Route::resource('users', UserController::class) のような一行で、基本的なルートがまとめて生成されるのもメリットです。
以下はResource Controllerを作成する場合の基本的なコマンドです。
php artisan make:controller UserController --resource
このコマンドで生成されたファイルには、最初からいくつかのメソッドが定義されています。 あとは、必要に応じて内部処理を追記するだけです。
Single Action Controllerについて
もう一つのユニークな方法として、Single Action Controller があります。
こちらはひとつのControllerがひとつのメソッドしか持たず、クラス内の __invoke() メソッドによって処理を行うスタイルです。
ひとつの機能だけをシンプルに実装したいときに便利です。
以下のようにコマンドで生成可能です。
php artisan make:controller SendMailController --invokable
作成されたクラス内には __invoke() という特殊なメソッドが定義され、ルーティングにもそのまま対応させることができます。
複雑な機能を詰め込む必要がない場合や、一度だけ呼び出す処理をまとめたいときには役立つでしょう。
返却方法とリダイレクト
Controllerがブラウザへ返すのはビューだけとは限りません。 JSONレスポンス を返してAPIのエンドポイントとして利用したり、別のURLへリダイレクトさせる場合もあります。
- JSONレスポンスを返したいときは、
return response()->json($data);のように書きます。 - リダイレクトしたいときは、
return redirect('/home');のように行先を指定します。
それぞれの書き方を覚えておくと、RESTful APIやフォーム送信後の画面遷移など、用途に合わせてControllerを柔軟に使い分けられます。
Controllerの中であまりに多くの処理を詰め込みすぎると、可読性が下がります。 機能が増えてきたら、モデルや別のクラスへ処理を切り分けることを検討してください。
実務での活用イメージ
実務では、Controllerの設計はプロジェクト全体の可読性や保守性に大きく影響します。 たとえばユーザー管理機能だけでも、登録、ログイン、ログアウト、プロフィール変更など多くの操作が考えられますよね。
このとき、すべてを一つのControllerに押し込めてしまうと、コードが読みづらくなります。 役割ごとにControllerを分割することで、どのメソッドがどの処理を担当しているかをはっきりさせることができます。 また、Controller単位でミドルウェアを設定してアクセス制限を行うケースもあるため、まとめ方が分かりやすいほど、メンテナンス性が高まります。
特にフォーム入力やエラーメッセージの処理、あるいはAPI通信でのエンドポイントの設計では、Controllerが窓口になります。 開発チームが複数人いる場合は、Controller名やメソッド名の付け方、リソースコントローラの使用ルールなどをあらかじめ決めておくと良いでしょう。
Controllerは「ルートとモデルやビューをつなぐ場所」という役割がメインです。 処理が複雑になる場合は、別のサービスクラスを用意するなどして責任を分割すると保守しやすくなります。
API開発でのController使用例
最近はWebアプリケーションだけでなく、モバイルアプリ向けやSPA（Single Page Application）用にRESTful APIを用意するケースも増えています。 LaravelのControllerは、このAPI設計でも役立ちます。
具体的には、JSONを返すメソッドだけをまとめたAPI用のControllerを作り、routes/api.php にルーティング定義を置くことが多いです。
たとえばユーザー一覧を取得するAPIを作るのであれば、以下のように書けます。
<?php namespace App\Http\Controllers; use Illuminate\Http\Request; class UserApiController extends Controller { public function index() { $users = [ ['id' => 1, 'name' => 'Taro', 'email' => 'taro@example.com'], ['id' => 2, 'name' => 'Hanako', 'email' => 'hanako@example.com'] ]; return response()->json($users); } }
API開発の場合、ビューを返す必要がないので、JSONレスポンスだけを返す形が多いですね。 このようなシンプルなController構成は、フロントエンドとの連携をスムーズにしてくれるでしょう。
まとめ
ここまで、LaravelのControllerがどのような役割を果たし、どんな作り方や設計方法があるのかを解説しました。 大枠としては「ルーティングとビューをつなぐ場所」であり、フォーム入力の処理やデータベースへのアクセスなど、アプリケーションの要となる部分を担います。
初心者の皆さんが最初に覚えておきたいのは、**「Controllerで全処理を完結させる必要はない」**ということです。 実際にはモデルやサービスクラスにロジックを任せ、Controllerはフローを組み立てる部分に専念する方が保守しやすくなります。
大規模開発になるほど、Controllerの分割や命名ルールが重要になります。 ぜひ、今回紹介した手順やコード例を参考に、自分なりに使いやすいControllerを設計してみてください。