LaravelとTwigでアクティブページの判定をしよう！

こんにちは、Webプログラマの篠田です。

今回は、PHPフレームワーク「Laravel 5.6」と「Twig」を使ったプログラムで、
Twig内で現在URLの値を取得する方法をご紹介します。

どういうときに「現在のURL」が必要になるか

「現在のURL」が必要になる場面としては、表示しているページのメニューをアクティブ表示したいときではないでしょうか。

そういったときに、コントローラー側のPHPで「現在のURL」を取得して、テンプレート側に送るという仕組みは、全コントローラーに影響するので実装は現実的ではありません。

そこで、ページの構成上必要となるメニュー部分のテンプレートで「現在のURL」が取得できれば、全コントローラーに手を加える必要がなくなります。

ベースとなるコードを用意する

ベースとなる簡単なLaravelのコードを用意します。

まずは、簡単なコントローラーを作成

「artisan」コマンドを利用して、「ItemController」と「MemberController」を作成します。

「ItemController」と「MemberController」に「index」メソッドを用意します。

読み込むTwigファイルは「views/Item/index.twig」と「views/Member/index.twig」が保存してあるとします。

ルーティングには名前をつけよう

Laravelのルーティングには、別名を付けることができます。
別名をつけることで、URLが変わったり、呼び出しコントローラーが変わっても、呼び出し側に影響が出ないようにすることができます。

「name」にかかれている「’item.index’」や「’member.index’」が別名になります。

これで、準備が完了です。

現在のURLを取得してみよう

「現在のURL」を取得するコードは下記のようになります。

「url()」は、Laravelの「url関数」を利用しています。
本来は、引数にパス（例：’/item’）を渡すことで、完全なURL（http://から始まるURL）を作成することができます。

このままでは、「現在のURL」を取得しただけで、実際にメニューをアクティブにするためには、条件を作成する必要があります。

Twigの「match」を使って、ページを認識させる

先程、取得した「現在のURL」を利用して、現在のURLがメニューに該当するURLなのかを判定するコードを作っていきましょう。

条件式に利用するのは、Twigの「matches」です。

先程の「url().current()」を使いその文字列に「'{member}’」を含んでいれば「true」という条件式を作りました。

Twigの「matches」は、正規表現を使い複雑な文字検索を可能にします。

まとめ

「現在のURL」を活用することで、簡単にアクティブページの処理を作成することができます

ただし、「現在のURL」の取得方法は、同じTwigを利用していても、フレームワークの種類によって呼び出し方が変わってきますので、注意が必要です。