Laravelにおけるコントローラクラスを理解しよう

人気のPHPフレームワークLaravelを習得しよう 第4回

ルートパラメータ

　コントローラクラスの最後に、ルートパラメータの扱いについて紹介しておきましょう。ルートパラメータについては、連載第2回で解説しています。その際、ルートパラメータはコールバック関数の引数として渡されることを紹介しました。

　処理をコントローラクラスに記述するようになった場合、このルートパラメータはどのように記述すればいいのでしょうか。実は発想は同じで、コントローラクラス内のメソッドの引数として渡されます。

　例えば、リスト7のルートパラメータを利用したルーティング登録があるとします。

［リスト7］routes/web.php

Route::get("/chap4/whoAreYou/{name}", "Chap4Controller@whoAreYou");

　ここで登録したメソッドはwhoAreYou()です。このメソッドでnameパラメータを受け取るには、引数に記述します。リスト8のコードになります。リスト8をChap4Controllerクラスに追記してください。

［リスト8］app/Http/Controllers/Chap4Controller.php

<?php
〜省略〜
class Chap4Controller extends Controller
{
	〜省略〜
	public function whoAreYou($name)  // （1）
	{
		$data["name"] = $name;  // （2）
		return view("chap3.hello", $data);
	}
}

　（1）でwhoAreYou()メソッドを追記していますが、引数として$nameが記述されています。この$nameにURL上のパラメータが格納されます。（2）では渡されたURL上のパラメータをテンプレートに渡すために配列に格納しています。

　実際に、例えば以下のURLにアクセスしてみてください。このURLでは、URL末の「Bob」がルートパラメータにあたります。

• http://localhost/firstlaravel/public/chap4/whoAreYou/Bob

　すると、図3の画面が表示され、無事、ルートパラメータを受け取っているのがわかります。

図3：ルートパラメータが表示された画面

　なお、このルートパラメータは複数設定できます。例えば、リスト9のようなコードです。

［リスト9］routes/web.php

Route::get("/chap4/whoAreYouFull/{nameFirst}/{nameLast}", "Chap4Controller@whoAreYouFull");

　ここでは、nameFirstとnameLastの2個のルートパラメータが設定されています。

　このルーティングで処理を行うwhoAreYouFull()メソッドは、例えばリスト10のようになります。

［リスト10］app/Http/Controllers/Chap4Controller.php

<?php
〜省略〜
class Chap4Controller extends Controller
{
	〜省略〜
	public function whoAreYouFull($nameFirst, $nameLast)  // (1)
	{
		$data["name"] = $nameFirst." ".$nameLast;
		return view("chap3.hello", $data);
	}
}

　（1）にもあるように、ルートパラメータと同じ数の引数を記述すれば利用できます。

　実際に、例えば以下のURLにアクセスしてみてください。このURLでは、URL末の「Bob」と「James」がルートパラメータにあたります。

• http://localhost/firstlaravel/public/chap4/whoAreYouFull/Bob/James

　すると、図4の画面が表示され、無事、複数のルートパラメータを受け取っているのがわかります。

図4：複数ルートパラメータが表示された画面

まとめ

　今回は、ルーティング登録コールバック関数内に記述していた処理を、1つのクラスとしてまとめたコントローラクラスを紹介しました。

　次回は、ルーティングコールバック関数の処理、あるいは、今回紹介したコントローラによる処理の前後に、処理を追加する機能として、ミドルウェアを紹介します。