「先日書いた記事(以下のリンク)の内容が間違っているのではないか?」 と疑心暗鬼になり、連想配列についてさらに調べてみました。
変数をそのままビューに渡してもOK?!
前回の記事でコントローラからビューに渡すデータを連想配列としてまとめるのが一般的であるという説明とともに以下のようなコードを載せました。
結論から言うと、以下のコードは正しいです。return view内の第二引数のところで、変数($data)をそのままビューに渡す形になっており、連想配列の形では渡していません。
しかし、渡している変数が単数です。そして、その変数は配列ではなく連想配列であるため正しいのです。
前回の記事内の記述
コントローラ側の記述は以下
class TestController extends Controller
{
public function index(Request $request)
{
$
data = [
'name' => 'taro',
'city' => 'tokyo',
'sport' => 'soccer',
'age' => 12
];
return view('test.index', $
data);
}
}
ビュー側の記述は以下
名前:{{ \$name }}
出身:{{ \$city }}
得意なスポーツ:{{ \$sport }}
年齢:{{ \$age }}
ビューに複数の変数を渡す
ただし、複数の変数を渡す場合は連想配列の形で変数をコントローラからビューに渡す必要があるのです。
複数の変数を渡す場合のコードの例を以下に載せておきます。
コントローラ側の記述は以下
class TestController extends Controller
{
public function index(Request $
request)
{
$data = [
'name' => 'taro',
'city' => 'tokyo',
'sport' => 'soccer',
'age' => 12
];
$computer = [
'type' => 'mac',
'year' => 2018
];
return view('test.index', ['data' => $
data, 'computer' => $
computer]);
}
}
ビュー側の記述は以下
<!-- 名前、出身地、得意なスポーツ、年齢を表示 -->
名前:{{ $data['name'] }}
出身:{{ $data['city'] }}
得意なスポーツ:{{ $data['sport'] }}
年齢:{{ $data['age'] }}
<!-- コンピュータの情報を表示 -->
コンピュータの種類:{{ $computer['type'] }}
年式:{{ $computer['year'] }}
ビューに渡す変数が配列の場合
今までの例では、ビューに渡す変数が連想配列の場合を取り扱ってきました。しかし、ビューに渡す変数が配列の場合、return view内の第二引数で、そのまま変数をビューへ渡して良いのでしょうか?
答えは、連想配列の形でなければなりません。コードの例を以下に載せておきます。
コントローラ側の記述は以下
class TestController extends Controller
{
public function index(Request $request)
{
$
data = [
[
'name' => 'taro',
'city' => 'tokyo',
'sport' => 'soccer',
'age' => 12
],
[
'name' => 'jiro',
'city' => 'osaka',
'sport' => 'baseball',
'age' => 14
],
[
'name' => 'hanako',
'city' => 'kyoto',
'sport' => 'basketball',
'age' => 13
]
];
return view('test.index', ['data' => $data]);
}
}
ビュー側の記述は以下
@
foreach($
data as $
item)
名前:{{ $
item['name'] }}
出身:{{ $
item['city'] }}
得意なスポーツ:{{ $
item['sport'] }}
年齢:{{ $
item['age'] }}
@
endforeach
コントローラ側とビュー側で変数名を変更して使用する
実は、コントローラ側とビュー側で変数名を変更して使用したい場合も、変数($data)をそのままビューに渡す形では正しい記述とならず、連想配列の形で変数をビューに渡さなければなりません。以下のコードの例を記載します。
コントローラ側の記述は以下
class TestController extends Controller
{
public function index(Request $request)
{
// コントローラ側では$dataを使用
$
data = [
'name' => 'taro',
'city' => 'tokyo',
'sport' => 'soccer',
'age' => 12
];
// ビューに渡す際にキー名を'userInfo'に変更
return view('test.index', ['userInfo' => $data]);
}
}
ビュー側の記述は以下
名前:{{ $userInfo['name']}}
出身:{{ $userInfo['city']}}
得意なスポーツ:{{ $userInfo['sport'] }}
年齢:{{ $userInfo['age'] }}
連想配列の形で変数をビューに渡すのが間違いない方法!
結論としては、連想配列の形で変数をビューに渡しておけば間違いないです。一般的にコントローラからビューに変数を渡す際は、連想配列の形で渡しましょうと習うようです。
連想配列の形で渡しておけば、コントローラからビューに渡す変数が単数あろうと複数あろうと、変数(自体)が配列であろうと連想配列であろうと正しく動作してくれます。
一応、渡す変数が単数かつ変数が連想配列の場合は、直接変数をビューに渡す記述もできるということを知っておけば、直接変数をビューに渡す記述に出くわした際、あたふたすることもないでしょう(笑)。
最後に前回の記事で載せたコードの変数を、連想配列の形でビューへ渡すバージョンにして載せておきます。
コントローラ側の記述は以下
class TestController extends Controller
{
public function index(Request $request)
{
$
data = [
'name' => 'taro',
'city' => 'tokyo',
'sport' => 'soccer',
'age' => 12
];
return view('test.index', ['data' => $
data]);
}
}
ビュー側の記述は以下
名前:{{ $
data['name'] }}
出身:{{ $
data['city'] }}
得意なスポーツ:{{ $
data['sport'] }}
年齢:{{ $
data['age'] }}
補足:['data' => $data] と compact('data')
コントローラ側とビュー側で変数名を変更して使用したい場合を先ほど取り上げました。この場合return view内の第二引数を連想配列の形にするということでしたが、この第二引数の部分の書き方は二つのパターンあるのです。
一つ目は、['data' => $data]を使った以下のような書き方
class TestController extends Controller
{
public function index(Request $request)
{
$
data = [
'name' => 'taro',
'city' => 'tokyo',
'sport' => 'soccer',
'age' => 12
];
return view('test.index', ['data' => $
data]);
}
}
二つ目は、compact('data')を使った以下のような書き方
class TestController extends Controller
{
public function index(Request $request)
{
$
data = [
'name' => 'taro',
'city' => 'tokyo',
'sport' => 'soccer',
'age' => 12
];
return view('test.index', compact('data'));
}
}
'data' => $data] と compact('data')の使い分け
1.コントローラ側とビュー側で変数名を変更する場合
['data' => $
data]を使用します。
例:return view('test.index', ['userInfo' => $data]);
2.変数名を変更する必要がない場合
compact('data')を使用します。
例:return view('test.index', compact('data'));
compactは、指定した変数名を文字列として受け取り、その変数をキー(名前)と値のペアにして連想配列として作成し、それをビューに渡すための関数です。
つまり、compactを使う場合は、コントローラ側とビュー側で'変数名を変更しない'という前提のもとに使われるのです。