ルートパラメータ
コントローラクラスの最後に、ルートパラメータの扱いについて紹介しておきましょう。ルートパラメータについては、連載第2回で解説しています。その際、ルートパラメータはコールバック関数の引数として渡されることを紹介しました。
処理をコントローラクラスに記述するようになった場合、このルートパラメータはどのように記述すればいいのでしょうか。実は発想は同じで、コントローラクラス内のメソッドの引数として渡されます。
例えば、リスト7のルートパラメータを利用したルーティング登録があるとします。
Route::get("/chap4/whoAreYou/{name}", "Chap4Controller@whoAreYou");
ここで登録したメソッドはwhoAreYou()です。このメソッドでnameパラメータを受け取るには、引数に記述します。リスト8のコードになります。リスト8をChap4Controllerクラスに追記してください。
<?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の画面が表示され、無事、ルートパラメータを受け取っているのがわかります。
なお、このルートパラメータは複数設定できます。例えば、リスト9のようなコードです。
Route::get("/chap4/whoAreYouFull/{nameFirst}/{nameLast}", "Chap4Controller@whoAreYouFull");
ここでは、nameFirstとnameLastの2個のルートパラメータが設定されています。
このルーティングで処理を行うwhoAreYouFull()メソッドは、例えばリスト10のようになります。
<?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の画面が表示され、無事、複数のルートパラメータを受け取っているのがわかります。
まとめ
今回は、ルーティング登録コールバック関数内に記述していた処理を、1つのクラスとしてまとめたコントローラクラスを紹介しました。
次回は、ルーティングコールバック関数の処理、あるいは、今回紹介したコントローラによる処理の前後に、処理を追加する機能として、ミドルウェアを紹介します。
