Laravelでコントローラに依存注入（DI）を使う方法

先生と生徒の会話形式で理解しよう

生徒

「先生、Laravelでよく『依存注入（DI）』って聞くんですけど、何のことかよくわかりません。」

先生

「依存注入とは、プログラムの中で必要なものを自動で用意して渡してくれる仕組みのことだよ。Laravelではコントローラでよく使うね。」

生徒

「具体的にどうやって使うんですか？初心者でもわかるように教えてください！」

先生

「じゃあ、Laravelの依存注入をコントローラで使う基本的な方法を一緒に見ていこう！」

1. 依存注入（DI）とは？

依存注入（DI：Dependency Injection）とは、プログラムの中で「必要な機能や部品」を外から渡してもらう仕組みのことです。自分で“必要なものを作る”のではなく、Laravelが代わりに用意してくれるので、初心者でも複雑な処理を書かずに済むのが大きなメリットです。

たとえば、コントローラの中で「リクエスト情報を扱う部品」や「データベースを操作する部品」が必要な場合、本来であれば自分で new して作らなければいけません。しかし、依存注入を使うと Laravel がそのインスタンスを自動で準備して渡してくれるため、コードがすっきり整理されます。

イメージしやすいように、簡単な例を見てみましょう。


// 例：必要な部品を作らずにもらえるイメージ
class SampleController extends Controller
{
    public function show(MessageService $message)
    {
        // $message は Laravel が自動で用意してくれる
        return $message->hello();
    }
}

このように、DI を使えば「必要なものを勝手に持ってきてくれる」状態になり、コントローラは自分の役割に集中できます。部品の作り方を意識せずに済むので、学習中でも安心して使える基本機能と言えるでしょう。

2. なぜ依存注入が便利なの？

依存注入が便利と言われる一番の理由は、「コントローラのコードをスッキリさせられるから」です。自分で毎回 new クラス名 と書いて必要な部品を作っていると、処理が増えるたびにコードが長くなり、どこで何を作っているのか分かりにくくなってしまいます。

依存注入を使うと、「このコントローラはこの部品が欲しいです」と宣言するだけで、実際にオブジェクトを作る処理は Laravel に任せられます。コントローラ側は「もらった部品をどう使うか」だけに集中できるので、読みやすくて整理されたコードになりやすいのが特徴です。

イメージしやすいように、依存注入を使わない場合と使う場合を簡単に比べてみましょう。


// 依存注入を使わない例
class SampleController extends Controller
{
    public function show()
    {
        $service = new MessageService(); // ここで自分で作っている
        return $service->hello();
    }
}

// 依存注入を使う例
class SampleController extends Controller
{
    public function show(MessageService $service)
    {
        // $service は Laravel が自動で渡してくれる
        return $service->hello();
    }
}

上の2つはやっていることは同じですが、2つ目の「依存注入を使う例」のほうが、MessageService をどこで作るかを意識せずに済みます。「このメソッドは MessageService が必要なんだな」と一目で分かるため、プログラムの見通しが良くなります。

さらに、依存注入を使っておくと、あとから部品の中身を差し替えたいときにも便利です。たとえば、本番環境では本物の MessageService を使い、テスト環境では「テスト用の MessageService」を差し替える、といったことが簡単にできます。コントローラ側のコードはそのままで、中身だけを入れ替えられるので、保守やテストがぐっと楽になるのです。

このように、依存注入は「コードをシンプルにする」「あとから変更しやすくする」「テストしやすくする」というメリットを同時に実現してくれる仕組みです。Laravel では標準で使える機能なので、初心者のうちから少しずつ慣れておくと、コントローラ設計がとても扱いやすくなります。

3. Laravelでコントローラに依存注入を使う基本の書き方

Laravelのコントローラで依存注入を使うときは、「このメソッドではこのクラスが必要です」とメソッドの引数に書くだけでOKです。難しい設定をしなくても、Laravelが自動的にそのクラスのインスタンス（部品）を用意して渡してくれます。

一番よく登場するのが、フォーム送信などで使う Request クラスです。ユーザーが入力した値を取り出したいとき、次のようにメソッドの引数に書くだけで、$request が「使える状態」で渡されます。


use Illuminate\Http\Request;

class SampleController extends Controller
{
    public function index(Request $request)
    {
        // $request は Laravel が自動で用意してくれる
        $name = $request->input('name');

        // 取得した値を使って、シンプルなメッセージを返す例
        return "入力された名前は「" . $name . "」です。";
    }
}

このコードの流れを、プログラミング未経験の方向けに少し細かく見てみましょう。

use Illuminate\Http\Request; … 「Request というクラスをこのファイルで使います」と宣言しています。
public function index(Request $request) … index メソッドは Request クラスが必要です、という意味のサインです。
$request … フォームやURLから送られてきた入力値をまとめて持っている“箱”のような存在です。
$request->input('name') … name という名前で送られてきた値を1つ取り出しています。

ポイントは、「自分で new Request() と書いていないのに、$request がちゃんと使えるようになっている」という点です。これこそが依存注入の基本的な動き方で、「必要なクラスをメソッドの引数に書くだけで、Laravel がちょうどいいタイミングで渡してくれる」というイメージを持っておくと理解しやすくなります。

実際の開発では、Request だけでなく、自分で用意したサービスクラスなども同じように引数に書くだけで依存注入できます。「よく使う部品は引数に書いて受け取る」というパターンを覚えておくと、コントローラの設計がぐっと楽になります。

4. コンストラクタで依存注入を使う方法

前の章では、メソッドの引数にクラスを書いて依存注入を行う方法を見ました。ここではもう一歩進んで、「コントローラが作られたタイミングでまとめて部品を受け取る」コンストラクタでの依存注入の使い方を確認していきます。

コンストラクタとは、クラスの「最初のあいさつ」のようなもので、そのクラスのインスタンスが生成されたときに一度だけ呼ばれる特別なメソッドです。Laravelのコントローラでも、このコンストラクタを利用することで「このコントローラはこの部品を常に使います」と宣言することができます。

たとえば、ユーザー情報をデータベースから取得する専用クラス UserRepository を、コントローラ全体で繰り返し使いたい場合は、次のように書きます。


use App\Repositories\UserRepository;

class UserController extends Controller
{
    // コントローラの中で共有して使うためのプロパティ
    protected $users;

    // コンストラクタで UserRepository を受け取る
    public function __construct(UserRepository $users)
    {
        // 受け取ったインスタンスをプロパティに保存
        $this->users = $users;
    }

    public function index()
    {
        // どのメソッドからでも $this->users が使える
        $allUsers = $this->users->getAll();

        return view('users.index', ['users' => $allUsers]);
    }
}

このコードを、プログラミング未経験の方向けにかみ砕いて説明すると、次のようなイメージになります。

protected $users; … コントローラの中で「ユーザー情報を扱う道具」をしまっておく引き出しのようなものです。
public function __construct(UserRepository $users) … 「このコントローラを使うときは、UserRepository という道具も一緒に用意してください」と Laravel にお願いしている部分です。
$this->users = $users; … 渡してもらった道具を、自分の引き出し（プロパティ）にしまっているイメージです。
$this->users->getAll() … しまっておいた道具を取り出して、「ユーザー一覧をください」と依頼している処理です。

ポイントは、一度コンストラクタで受け取ってプロパティに保存しておけば、index メソッド以外の別のメソッド（例：show や edit など）からも同じ $this->users をそのまま使えることです。毎回 new UserRepository() と書かなくてよいので、コードの重複が減り、コントローラの見通しも良くなります。

このように、コンストラクタでの依存注入は「このコントローラで繰り返し使う共通の部品」をまとめて受け取るときにとても便利です。メソッド単位で受け取るか、コンストラクタでまとめて受け取るかを使い分けることで、Laravelのコントローラをすっきりと整理された形で書けるようになります。

5. 依存注入の裏側：Laravelのサービスコンテナ

依存注入がどうして “自動で動く” のか、その裏側を支えているのが Laravel の「サービスコンテナ」という仕組みです。サービスコンテナは、アプリ内で利用するクラスや部品をまとめて管理する専用の倉庫のような存在で、「必要になったらすぐに取り出せるように準備しておく」という役割を持っています。

例えば、コントローラで MessageService を使いたいと宣言したとき、Laravel はサービスコンテナの中から該当するクラスを探し、必要に応じて新しく作り、それをコントローラに渡してくれます。これが自動で行われるため、開発者は自分で new MessageService() と書く必要がなくなるのです。

イメージをつかみやすくするために、サービスコンテナと依存注入の関係を簡単な例で表してみます。


// サービスコンテナに登録する例（サービスプロバイダ内など）
$this->app->bind('message', function () {
    return new MessageService();
});

// コントローラで依存注入を利用
class SampleController extends Controller
{
    public function show(MessageService $message)
    {
        return $message->hello();
    }
}

サービスコンテナは、MessageService のようなクラスを「どうやって作ればよいか？」を覚えており、必要なときに取り出して渡してくれます。初心者の方は、「サービスコンテナはクラスの作り方を記録しておく箱」「DI はその箱から取り出して渡してくれる仕組み」とイメージするとスムーズに理解できます。

この仕組みのおかげで、Laravel のコードは柔軟性が高く、クラスの差し替えやテストもしやすい構造になります。サービスコンテナは普段意識しなくても動いていますが、DI を支えるとても重要な存在です。

6. 依存注入を使うとテストも楽になる

依存注入を使うことで、テストのときに本物の部品の代わりに「テスト用の部品」を渡すことができます。これを「モック」と呼びます。

モックを使うと、プログラムが正しく動いているか確かめやすくなり、バグを見つけやすくなります。初心者のうちから意識しておくと、後でとても役立ちます。

7. 大事なポイント

Laravelのコントローラでの依存注入は、必要なクラスを自動で用意してくれて、とても便利な仕組みです。RequestなどのLaravel標準クラスや、自分で作ったクラスにも使えます。

依存注入を使うことで、コードがスッキリし、部品の入れ替えやテストもしやすくなるので、初心者のうちから積極的に使っていきましょう。

まとめ

Laravelのコントローラで依存注入（DI）を使う方法について、これまでの内容をふりかえりながらより深く理解できるようにまとめていきます。依存注入という考え方は、Laravelを学び始めたばかりの初心者にとっては少し聞き慣れない言葉かもしれませんが、実際に使ってみるととても自然で、Laravelの開発をより快適にしてくれる重要な仕組みです。とくに、コンストラクタやメソッドの引数に必要なクラスを書くことで自動的にインスタンスが渡されるという特徴は、複雑な処理が増えるほどその便利さを実感できます。開発が大きくなり、データベースを操作するクラスや外部サービスと連携するクラスが増えると、依存注入のありがたみはさらに大きくなります。自分で new を使ってインスタンスを作成するコードを書かなくて済むため、コントローラがスッキリと整理された状態になり、機能の追加や修正がしやすいコードが実現できます。特に初心者の段階では、ひとつのコントローラに多くの処理を書いてしまいがちですが、依存注入を使うことでコードの責務が整理され、自然と読みやすい構造が身につきます。また、Laravelのサービスコンテナが裏側で動いている仕組みを理解すると、「必要なクラスがどうやって用意されているのか」も腑に落ちやすくなります。サービスコンテナはLaravelの心臓ともいえる仕組みで、依存されるクラスを管理し、必要なタイミングでコントローラへ渡してくれる非常に重要な存在です。この仕組みのおかげで、開発者は複雑な依存関係を意識する必要がなくなり、アプリケーションの動きに集中することができます。さらに、依存注入はテストのしやすさにも直結します。実務では「モック」と呼ばれるテスト専用のクラスを使って動作確認を行うことがよくありますが、依存注入が使われているコードであれば、テスト時に簡単にモックへ差し替えることができます。これによって、外部へのアクセスが必要なコードでも安全に検証が行え、安定したアプリケーション開発が可能になります。下記に依存注入を使ったサンプルプログラムを掲載しておくので、実際に手を動かして動作を確認してみるとより理解が深まります。

サンプルプログラム


// サービスクラスの例
namespace App\Services;

class MessageService {
    public function getMessage() {
        return "サービスからのメッセージです。";
    }
}

// コントローラでの依存注入
namespace App\Http\Controllers;

use App\Services\MessageService;

class MessageController extends Controller
{
    protected $service;

    public function __construct(MessageService $service)
    {
        $this->service = $service;
    }

    public function show()
    {
        return $this->service->getMessage();
    }
}

この例のとおり、依存注入を使うことでコントローラが必要なクラスを自動で受け取り、処理を分担しながらすっきりと整理されたコードを書くことができます。Laravelを使った開発では、依存注入は日常的に利用する重要な考え方なので、ぜひ実際のプロジェクトでも積極的に使ってみてください。

先生と生徒の振り返り会話

生徒

「依存注入って難しいものだと思っていましたが、書き方がシンプルで驚きました！」

先生

「Laravelは初心者でも扱いやすいようにデザインされているから、使っていくうちに自然と理解が深まるよ。」

生徒

「サービスコンテナが裏で動いているってわかると、どうして自動でクラスが渡されるのか納得できますね。」

先生

「その理解はとても大事だね。テストのときにモックを差し替える場面でも役立つから、今のうちに身につけておくと後で助かるよ。」

生徒

「依存注入を使いこなせるようになって、もっとLaravelの開発を楽しめるようになりたいです！」