【Laravel】テンプレートエンジンのBladeとは：基本的な使い方

Bladeとは

Laravelは「Blade」という高機能なテンプレート機能を備えています。Blade（ブレード）とはLaravelでレンダリングを行うテンプレートエンジンの一つです。

Bladeファイルは「.blade.php」拡張子を使用して、「resources/views」フォルダ内に保存します。またテンプレートはMVCにおける「ビュー（View）」に相当します。

BladeではWebページを効率的にレイアウトするための機能を備えています。テンプレート継承機能では既存のテンプレートを継承して新しいテンプレートを定義できますし、コンポート機能ではレイアウトを複数のコンポーネント（部品）に分けてレイアウトを構成していきます。

このような便利な機能を備えているため、LaravelのテンプレートエンジンにはBladeを利用することがおすすめです。

Bladeの主な機能

Bladeには次の機能を備えています。

{{}}構文では自動的にHTMLをエスケープしますが、{!! !!}とすることでエスケープされてないデータを出力できます。

変数の表示

Bladeテンプレートを使ってコントローラーから渡された変数をテンプレートで表示してみます。

routeフォルダ内のweb.phpには次のようにルートを記述します。

Route::get('/', \App\Http\Controllers\IndexController::class);

次にIndexController.php（シングルアクションコントローラ）には次のように記述します。

class IndexController extends Controller
{
    public function __invoke(Request $request)
    {
        return view('index', ['name' => 'office54']);
    }
}

ここではテンプレートの呼び出しにヘルパー関数のviewを利用しています。viewヘルパー関数は第一引数にテンプレート名を指定することでテンプレートを読み込んで返します。第二引数にはテンプレートに渡すデータを配列で渡すことができます。

viewヘルパー関数は以下構文に従って使用します。

viewヘルパー関数ではテンプレートを「views」フォルダ内から検索します。例えば「test.index」と引数に指定した場合、viewsフォルダ内のtestフォルダの中にあるindexファイルを読み込みます。

またviewヘルパー関数ではwith関数を利用することで、次のように第二引数に配列を指定せずにwith関数でテンプレートに渡すデータを指定することができます。

return view('index')->with('name', 'office54');

最後にテンプレートindex.blade.phpを作成します。テンプレートは「resources」フォルダ内の「views」フォルダに配置します。

テンプレートはコントローラーごとにフォルダを用意して、その中にコントローラーで利用するテンプレートをまとめるのが一般的です。しかし管理しやすい方法があれば、このルールに従わなくても大丈夫です。

index.blade.phpには次のように記述します。

Hello, {{ $name }}.

二重波括弧内にコントローラーなどから渡された変数を記述することで、変数の値が表示されます。また変数は頭に＄マークを入れて利用します。