LaravelのBladeに変数を渡す方法（withメソッド、compact関数）

1. Bladeに変数を渡すとは？

1. Bladeに変数を渡すとは？

LaravelのBlade（ブレード）は、Webブラウザに表示される画面の見た目、つまり「ビュー」を作成するための便利な仕組みです。しかし、Blade単体では「誰がログインしているか」や「最新の投稿内容は何か」といった動的なデータを知ることができません。

そこで必要になるのが、コントローラからBladeへデータを届ける「変数を渡す」という作業です。コントローラが「データを用意する役割」、Bladeが「データを表示する役割」と分担されており、その間をデータが移動するイメージです。

例えば、プログラミング未経験の方でもイメージしやすいのが「挨拶」の表示です。特定のユーザーの名前を画面に出したい場合、コントローラで $name = 'テストユーザー'; という箱（変数）を作り、それをBladeに送ることで、初めて画面に「こんにちは、テストユーザーさん！」と表示できるようになります。

このように、システムの裏側で動くデータと、表側のデザインをつなぐ架け橋が「変数を渡す」という処理なのです。

2. withメソッドで変数を渡す方法

2. withメソッドで変数を渡す方法

コントローラの中でビューを返すときに、withメソッドを使って変数を渡せます。
with('変数名', 値) の形で書きます。

public function show()
{
    $name = '太郎';
    return view('welcome')->with('userName', $name);
}

この例では、$name の値「太郎」を、ビューの中で $userName という名前で使えるようにしています。

Bladeの中で変数を表示するときは、{{ $userName }} と書きます。

<p>こんにちは、{{ $userName }}さん！</p>

3. withメソッドを連続で使う方法

3. withメソッドを連続で使う方法

複数の変数を渡したい場合は、withメソッドを続けて書くこともできます。

public function show()
{
    $name = '太郎';
    $age = 25;
    return view('welcome')->with('userName', $name)->with('userAge', $age);
}

この場合、ビューの中で $userName と $userAge を使えます。

4. compact関数で変数を渡す方法

4. compact関数で変数を渡す方法

もう一つよく使う方法は、PHPのcompact関数を使う方法です。
変数名の文字列を渡すと、それらの変数をまとめて配列にしてくれます。

public function show()
{
    $name = '太郎';
    $age = 25;
    return view('welcome', compact('name', 'age'));
}

この書き方では、ビューの中で $name と $age をそのまま使えます。

compact('name', 'age') は、['name' => $name, 'age' => $age] と同じ意味です。

5. withメソッドとcompact関数の違い

5. withメソッドとcompact関数の違い

どちらも変数をビューに渡す方法ですが、
withメソッドは「変数名を自由に変えて渡せるのが特徴です。
例えばコントローラの変数名と違う名前でビューに渡せます。
一方、compact関数は元の変数名をそのまま使って渡すのが基本です。

初心者のうちは、まとめて複数の変数を渡すときはcompactを使うと書きやすく、コードもスッキリします。

6. Bladeで変数を使う基本ルール

6. Bladeで変数を使う基本ルール

Bladeの中で変数を表示するときは、必ず {{ $変数名 }} と書きます。
これはHTMLの中にPHPの値を安全に埋め込む書き方です。
例えば：

<p>ユーザー名は {{ $name }} です。</p>

Bladeの変数は、渡した名前と同じ名前で使います。
もしコントローラで with('userName', $name) と渡したら、ビューでは {{ $userName }} と使いましょう。

7. 変数を渡す時のよくある疑問

7. 変数を渡す時のよくある疑問

Q. 変数をたくさん渡したい場合は？
→ compact関数でまとめて渡すか、withメソッドを連続で使います。

Q. 変数名は変えられますか？
→ withメソッドなら自由に変えられます。compactは元の名前のまま渡します。

Q. Bladeの中で変数が使えない場合は？
→ 変数名の渡し忘れや名前間違いが多いので、コントローラの渡し方とBladeの使い方をもう一度確認しましょう。

8. 大切なポイント

8. 大切なポイント

• コントローラからビューにデータを渡すときはwithメソッドかcompact関数を使う。
• withは変数名を自由に設定可能。compactは変数名をそのまま使う。
• Bladeでは{{ $変数名 }}で変数を安全に表示できる。
• 複数の変数を渡す場合はcompactがコードがスッキリしておすすめ。
• 変数が正しく渡せているか、名前の確認をしっかりする。

まとめ

まとめ

LaravelのBladeテンプレートに変数を渡す方法として、withメソッドとcompact関数をどのように使い分ければよいか、 今回の記事でじっくりと見ていきました。改めて振り返ってみると、Bladeに変数を渡す仕組みはとてもシンプルでありながら、 実際のアプリ開発では頻繁に登場するため、確実に理解しておきたい基礎知識です。 コントローラからビューへデータを渡す流れはLaravelのMVC構造の中でも特に中心的な部分であり、 データ表示やフォーム入力値の反映、一覧ページの表示など、あらゆる場面で役立ちます。

また、withメソッドによる柔軟な変数名の指定は、表示名を自由に変えたい場合に有効で、 compact関数は複数の変数をまとめて渡す場面でコードを簡潔にできる点が魅力です。 特に、変数の数が増えるとビュー側で扱うデータも複雑になりがちですが、 compactによって配列を自動生成する仕組みを利用することで、スッキリとしたコントローラを維持できます。 Laravelのコードの読みやすさはこうした細かな設計思想によって支えられていることがよくわかります。

さらに、Bladeテンプレート側での変数表示には必ず{{ }}構文を使うという基本も忘れてはいけません。 この構文はXSS対策も兼ねているため、安全なアプリケーションを作るための重要なポイントでもあります。 LaravelのBladeは非常に直感的で、テンプレートエンジンとしても扱いやすいため、変数を正しく渡せるようになると、 サイトの構造を整えたり、柔軟に画面を作ったりする幅が広がります。

以下に、今回の記事内容を総合したサンプルコードをまとめておきます。 withメソッドとcompact関数の両方を使い分けるときのイメージをつかむ役に立つはずです。

■ withメソッドとcompact関数の併用例

public function profile()
{
    $name = '花子';
    $age = 30;
    $city = '東京';

    // withで名前を変更しつつ、compactで複数の変数もまとめて渡す
    return view('user.profile')
        ->with('displayName', $name)
        ->with('currentCity', $city)
        ->with(compact('age'));
}

■ Blade側での表示例

<h1>{{ $displayName }}さんのプロフィール</h1>
<p>年齢：{{ $age }} 歳</p>
<p>現在地：{{ $currentCity }}</p>

このように、コントローラ側で柔軟に変数名を調整しつつ、Blade側では直感的にデータを扱えます。 特に実務では「表示用の名前と処理用の名前を分けたい」という場面も少なくないため、 withメソッドの使い方を理解しておくと非常に便利です。 また、compactによってまとめて渡したい変数があるときも見通しがよくなり、 コードの統一感も保ちやすくなります。

さらに細かい点として、Bladeで変数が表示されない場合は、 コントローラから正しく変数が渡っているかを確認し、 変数名の入力ミスや、渡した名前とBlade側で使っている名前が一致しているかを見直すことで、 多くのトラブルを解決できます。 Laravelは仕組みが明確なので、慣れるとこうした問題点もすぐに判断できるようになるでしょう。

変数を渡す技術はシンプルですが、Laravelアプリケーションでは必ず必要になる部分です。 小さな動作でも確実に理解しておくことで、複雑な画面やデータ連携が必要なページを作るときにも 迷わず対応できるようになります。 今後、Bladeの繰り返し構文や条件分岐と組み合わせることで、よりダイナミックな表示処理が可能となり、 Laravelによる開発の楽しさも一段と増していきます。

この記事を読んだ人からの質問

この記事を読んだ人からの質問

プログラミング初心者からのよくある疑問／質問を解決します

LaravelのBladeテンプレートエンジンに変数を渡すとは、具体的にどのような仕組みのことを指しているのでしょうか？

LaravelのBladeに変数を渡すというのは、バックエンドであるコントローラ側で取得したり加工したりしたデータ（変数）を、フロントエンドの表示を担うビュー（Bladeファイル）へ届ける仕組みのことです。例えば、データベースから取得したユーザー名や商品の価格、最新のニュース一覧といった動的な情報を、画面上の特定の場所に表示させたい時にこの「変数を渡す」という操作が必要になります。PHPのプログラムで処理した結果を、HTMLの見た目の中に組み込むための橋渡しのような役割だと考えると分かりやすいでしょう。