Laravel – dump()とdd()

2021-07-07 / tau / コメントする

概要

PHPのvar_dump()と同じような変数表示機能を提供する。

dump()

dump()は変数の内容をブラウザー上に表示する。

たとえばコントローラー内で以下の記述があるとき

$array = [
  ['山本一郎', 32, '090-1111-2222'],
  ['佐藤次郎', 45, '090-3333-4444'],
  ['鈴木三郎', 28, '090-5555-6666'],
];

dump($array);

.....

return view('drop_sample', $vars);

$array = [

['山本一郎', 32, '090-1111-2222'],

['佐藤次郎', 45, '090-3333-4444'],

['鈴木三郎', 28, '090-5555-6666'],

];

dump($array);

.....

return view('drop_sample', $vars);

ビューの内容に先立って、dump()による変数の内容が表示される。配列などの場合、個別にその内容を展開・折りたたみできる。

dd()

dump()の場合、エラーが生じてビューにエラーメッセージが表示されるとdump()の結果が表示されない。

dd()を使うと、その時点でブラウザーにdump()と同じ内容を表示し、実行が停止する(dump and die)。

Laravel – ルートパラメーターのwhereによる検証

2021-07-05 / tau / コメントする

概要

ルートパラメーターがURIに含まれて送られてきた時、ルーティングの段階で、正規表現を使って検証することができる。

検証の結果正規表現にマッチすれば処理され、マッチしなければ”404 Not Found”エラーとなる。

ルーティングの書き方

以下の様に、通常のルーティングのget()メソッドにwhere()を適用する。

Route::get('パス/パラメーター', ルーティング先)->where('パラメーター', '正規表現');

1	Route::get('パス/パラメーター', ルーティング先)->where('パラメーター', '正規表現');

たとえば以下は、ルートパラメーターが2桁の整数(00や01などを含む)であることを検証している。数字2桁ならValidと表示され、数値の桁が違ったり、数字以外の文字が含まれている場合は404エラーとなる。

Route::get('/request_where/{param}', function() { return 'Valid';})
  ->where('param', '^\d{2}$');

1 2	Route::get('/request_where/{param}', function() { return 'Valid';}) ->where('param', '^\d{2}$');

リクエスト先がコントローラー・アクションでもこれは使える。以下の例ではリクエストパラメーターが数字2桁の場合だけアクションが実行され、そうでなければ404エラーとなる。

Route::get('/request_where/{param}', 'SampleController@requestWhere')
  ->where('param', '^\d{2}$');

1 2	Route::get('/request_where/{param}', 'SampleController@requestWhere') ->where('param', '^\d{2}$');

Laravel – POSTリクエストパラメーター

2021-07-05 / tau / コメントする

概要

Laravelでは、フォームからPOSTされたリクエストパラメーターもクエリーパラメーターと同じようにRequestオブジェクトを介して取得できる。

formからのメソッド(POST)にしたがって、actionで指定した送信先に、リクエストパラメーターがHTTPリクエストのボディーに含められて送信される
actionの送信先からコントローラーのアクションにルーティング
アクションでパラメーターを取得して利用

フォーム

例として、以下のフォームを含むビューでリクエストを受け付ける。

入力項目＝パラメーターはuser_nameとpost
メソッドはPOST
actionのターゲット取得にurl()ビューヘルパーを使っている
form開始タグの直後に@csrfディレクティブがあるが、これはCSRF(Cross Script Request Forgery)を防止するためのトークンを埋め込むためのもので、デフォルトではこれがないとフォーム送信時に”419 Page Expired”エラーになる

{{-- request_form.blade.pphpのform部分 --}}

<form method="post" action="{{ url('/request_result') }}">
  @csrf
  <div>
    <label>名前:
      <input type="text" name="user_name">
    </label>
  </div>
  <div>
    <label>コメント:
      <input type="text" name="post">
    </label>
  </div>
  <input type="submit" value="送信">
</form>

@csrf

<div>

<label>名前:

</label>

</div>

<div>

<label>コメント:

</label>

</div>

</form>

ルーティング

フォームからの送信が送られるactionのターゲットをコントローラーのアクションにルーティングする。この時はパラメーターについて特に関与しない。

以下は上記の例のルーティング例。

Route::post('/request_result', 'SampleController@showRequestResult');

1	Route::post('/request_result', 'SampleController@showRequestResult');

コントローラー

ルーティングされたコントローラーのアクションで、リクエストパラメーターを取得して利用する。

必須事項

クエリーパラメーターのコントローラーにおける必須事項を参照。

アクションにおけるパラメーターの取得

Requestオブジェクトのinput()メソッド

アクションの引数で指定したRequestオブジェクトのinput()メソッドで引数にパラメーター名を指定すると、これに対応したパラメーターの値が得られる。

$request->input('パラメーター名');

$requestはアクションの引数名で任意
パラメーター名はフォーム各要素のname属性で指定した名前

冒頭の例に対応したコントローラーの記述例は以下のとおり。

<?php

namespace App\Http\Controllers;

use Illuminate\Http\Request;

class SampleController extends Controller
{
  public function showRequestResult(Request $request) {
    $user_name = $request->input('user_name');
    $comment = $request->input('comment');

    return view('samples.request_result', [
      'title' => 'POSTリクエストの処理',
      'user_name' => $user_name,
      'comment' => $comment,
    ]);
  }
}

<?php

namespace App\Http\Controllers;

use Illuminate\Http\Request;

class SampleController extends Controller

{

public function showRequestResult(Request $request) {

$user_name = $request->input('user_name');

$comment = $request->input('comment');

return view('samples.request_result', [

'title' => 'POSTリクエストの処理',

'user_name' => $user_name,

'comment' => $comment,

]);

}

ビューはこれらの値を使って表示される。

request()関数

Requestオブジェクトのinput()メソッドではなく、request()関数の引数にパラメーター名を指定してもパラメーターの値を取得できる。

request('パラメーター名');

先の例のアクションの部分をこれで書き換えると以下の様になる。

  public function showRequestResult(Request $request) {
    $user_name = request('user_name');
    $comment = request('comment');

    return view('samples.request_result', [
      'title' => 'POSTリクエストの処理',
      'user_name' => $user_name,
      'comment' => $comment,
    ]);
  }

public function showRequestResult(Request $request) {

$user_name = request('user_name');

$comment = request('comment');

return view('samples.request_result', [

'title' => 'POSTリクエストの処理',

'user_name' => $user_name,

'comment' => $comment,

]);

}

Laravel – url()

2021-07-05 / tau / コメントする

概要

url()は、パス文字列を与えてドメイン名を含むURLを返すヘルパー。

ドメイン名

引数に空文字列''を与えると、ドメイン名が得られる。

url('')
→ localhost:3000

1 2	url('') → localhost:3000

ドメインを含むパスの生成

引数のパスに文字列を与えると、ドメイン名の後にそれが付加されたパスが生成される。引数文字列の先頭に'/'があるかどうかは関係なく、ドメイン名にパスが連ねられたURLが得られている。

url('abc/def')
→ localhost:3000/abc/def

url('/abc/def')
→ localhost:3000/abc/def

url('abc/def')

→ localhost:3000/abc/def

url('/abc/def')

→ localhost:3000/abc/def

現在のURLに関する情報

url()に引数を与えない場合はIlluminate\Routing\UrlGeneratorインスタンスが戻り値となり、そのメソッドによって現在のURLに関する様々な情報が得られる。

url()->current()は現在のフルパスでクエリーは含まない
url()->full()は現在のフルパスでクエリーも含む
url()->previous()は直前にいたページのURL

たとえば現在のURLがクエリーを含む以下の用であるとする。

http://localhost:3000/example/path?x=123

また1つ前に表示していたページのURLが以下だったとする。

http://localhost:3000/old

url()->current()
→http://localhost:3000/example/path

url()->full()
→http://localhost:3000/example/path?x=123

url()->previous()
→http://localhost:3000/old

url()->current()

→http://localhost:3000/example/path

url()->full()

→http://localhost:3000/example/path?x=123

url()->previous()

→http://localhost:3000/old

Laravel – クエリーパラメーター

2021-07-05 / tau / コメントする

概要

クエリーパラメーターは、フォームの送信時にGETメソッドを指定した時に送信されるパラメーター形式。

ルートパラメーターが直接URIの一部としてパラメーターの値を送るのに対して、クエリーパラメーターはパラメーターの名前と値をセットで送る。たとえば以下の様に。

http://www.my_bbs.com/search_post?user_id=10

このパラメーターをコントローラーで取得するには、以下の2通りの方法がある。

アクションの引数でRequestオブジェクトを指定し、その属性でパラメーター名を指定する。
アクション内でrequest()関数の引数にパラメーター名を指定する

いずれの場合も、コントローラーで以下の指定が必要。

use Illuminate\Http\Request;

ルーティング

ルーティング設定では、パラメーターを送信するパスとそれを受け取るコントローラー・アクションを指定するだけで、特別の記述はない。

Route::get('パス', 'ルーティング先');

たとえばmy_bbsというアプリケーションで以下のようにルーティングを設定した場合、

Requeset::get('/search_post/', 'PostController@searchPost');

1	Requeset::get('/search_post/', 'PostController@searchPost');

リクエスト側のURLは以下のようになる。

http://www.my_bbs.com/search_post?user_id=5

複数のパラメーターを送る場合は以下の様に'&'で区切る。

http://www.my_bbs.com/search_post?user_id=5&keyword=hello

ルーティングではパラメーターの数や名前には関与せず、コントローラー・アクションにおいてこれらを扱う。

コントローラー

必須事項

Request使用の宣言

コントローラー定義前に以下の定義が必要。artisanでコントローラーを生成すると、この定義は自動的に含まれる。

use Illuminate\Http\Request;

アクションの引数での`Request`オブジェクト指定

コントローラーでクエリーパラメーターを扱うのに、Requestパラメーターをアクションの引数に指定する方法と、request()関数を使う方法があるが、いずれの場合でも、アクションの引数にRequestクラスのオブジェクトを引数として指定する。

public function アクション名(Request $request) { ... }

引数の変数名は、必ずしも$requestでなくてもよい。

共通のコントローラー・アクションの形式

上記2つをまとめたコントローラー・アクションの一般形は以下のとおり。

<?php

namespace App\Http\Controllers;

use Illuminate\Http\Request;

class コントローラー名 extends Controller
{
  public function アクション名(Request $request) {
    .....
  }
}

<?php

namespace App\Http\Controllers;

use Illuminate\Http\Request;

class コントローラー名 extends Controller

{

public function アクション名(Request $request) {

.....

}

アクションにおけるパラメーターの取得

Requestオブジェクトの属性からパラメーターを受け取る方法

アクションの引数に指定したオブジェクトの属性値に、パラメーター名を指定して値を取り出す。引数の変数名は$requestである必要はなく任意。

$request->パラメーター名

たとえば先のリクエストの項で挙げた例の場合、以下のような処理例となる。ビューではコントローラーで設定された変数を使う。

<?php

namespace App\Http\Controllers;

use Illuminate\Http\Request;

class PostController extends Controller
{
  public function searchPost(Request $request) {
    $user_id = $request->user_id;

    return view(
      'samples.posts',
      [
        'title' => 'クエリーパラメーターのサンプル',
        'user_id' => $user_id,
      ]
    );
  }
}

<?php

namespace App\Http\Controllers;

use Illuminate\Http\Request;

class PostController extends Controller

{

public function searchPost(Request $request) {

$user_id = $request->user_id;

return view(

'samples.posts',

[

'title' => 'クエリーパラメーターのサンプル',

'user_id' => $user_id,

]

);

}

複数パラメーターが送られる場合は、Request引数の属性で順次パラメーター名を指定して取り出す。

  public function searchPost(Request $request) {
    $user_id = $request->user_id;
    $post_id = $request->post_id;

    return view(
      'samples.route_parameter',
      [
        'title' => 'ルートパラメーターのサンプル',
        'user_id' => $user_id,
        'post_id' => $post_id,
      ]
    );
  }

public function searchPost(Request $request) {

$user_id = $request->user_id;

$post_id = $request->post_id;

return view(

'samples.route_parameter',

[

'title' => 'ルートパラメーターのサンプル',

'user_id' => $user_id,

'post_id' => $post_id,

]

);

}

request()関数にパラメーター名を指定して受け取る方法

request()関数の引数に、クエリーのパラメーター名を指定して値を取り出す。

request('パラメーター名');

上記の複数パラメーターの例をこの方法で書き換えると以下のとおり。

  public function searchPost(Request $request) {
    $user_id = request(user_id);
    $post_id = request(post_id);

    return view(
      'samples.route_parameter',
      [
        'title' => 'ルートパラメーターのサンプル',
        'user_id' => $user_id,
        'post_id' => $post_id,
      ]
    );
  }

public function searchPost(Request $request) {

$user_id = request(user_id);

$post_id = request(post_id);

return view(

'samples.route_parameter',

[

'title' => 'ルートパラメーターのサンプル',

'user_id' => $user_id,

'post_id' => $post_id,

]

);

}

パラメーター省略時

リクエスト送信時にパラメーターを送信した時など、コントローラーで想定したパラメーターが存在しないときはエラーにならず、値が空文字列となる。

Laravel – ルーティング

2021-07-04 / tau / コメントする

ルーティングの基本形

Route::メソッド('パス', ルーティング先);

たとえばGETメソッドで'ドメイン/bbs/show_posts'がリクエストされ、そのコントローラがBbsController、メソッドがshowPostsの場合は以下のように書く。

Route::get('/bbs/show_posts', 'BbsController@showPosts');

1	Route::get('/bbs/show_posts', 'BbsController@showPosts');

メソッド

HTTPメソッドに対応したRouteクラスのスタティックメソッドが準備されている。

get
post
put
patch
delete
options

URL

HTTPリクエストで指定されるURLを記述する。

ドメイン以下のパスを書く
頭の'/'はあってもなくてもよい

たとえばGETメソッドによるhttp://www.my_site/bbs/show_postsへのリクエストを扱う場合は以下のようになる。

Route::get('/bbs/show_posts', ...);

1	Route::get('/bbs/show_posts', ...);

または

Route::get('bbs/show_posts', ...);

1	Route::get('bbs/show_posts', ...);

ルーティング先

コントローラーとアクションを指定

'コントローラー名@アクション名'で指定する。

たとえば上記のURLへのリクエストをBbsControllerコントローラーのshowPostsアクションにルーティングしたい場合は以下のように指定する。

Route::get('/bbs/show_posts', 'BbsController@showPosts);

1	Route::get('/bbs/show_posts', 'BbsController@showPosts);

シングルアクションコントローラーを指定

'コントローラー名'で指定する。

たとえば上記のURLへのリクエストでシングルアクションコントローラー'ShowPosts'にルーティングしたい場合は以下のように指定する。

Route::get('/bbs/show_posts', 'ShowPosts);

1	Route::get('/bbs/show_posts', 'ShowPosts);

直接ビューを指定

コントローラーを介さずに直接ビューを指定する方法。無名関数を使い、戻り値にビューを指定したview()関数を渡す。

Route::get('パス', function () { return view('ビュー'); });

たとえば先のURLへのリクエストでビューファイルが以下のように配置されているとする。

resources/views/bbs/profile.blade.php

この場合のルーティングは以下のようになる。

Route::get('/bbs/show_posts', function() {
  return view('bbs.profile');
});

Route::get('/bbs/show_posts', function() {

return view('bbs.profile');

});

ビューで参照する変数がある場合、以下のようにコントローラーと同じように無名関数の中で設定できる。

Route::get('/bbs/show_posts', function() {
  $title = 'プロフィール;

  return view('bbs.profile');
});

Route::get('/bbs/show_posts', function() {

$title = 'プロフィール;

return view('bbs.profile');

});

直接出力

無名関数の戻り値に直接文字列を渡すと、それがそのまま送信される。

Route::get('パス', function () { return '文字列'; });

以下の例では、ブラウザーに単に「こんにちは」とだけ表示される。

Route::get('URL', function () { return 'こんにちは'; });

1	Route::get('URL', function () { return 'こんにちは'; });

直接HTMLを送ることも可能。

Route::get('URL', function () { return '
<!DOCTYPE html>
<html lang="ja">
  <head>
  .....
</html>
'; });

Route::get('URL', function () { return '

<!DOCTYPE html>

<head>

.....

</html>

'; });

ルートパラメーター

ルートパラメーターは、以下の様にリクエストURIの一部としてパラメーターの値が送信される。

http://ドメイン/.../パラメーター

パラメーターの値のみ送り、それを扱う変数の名前はLaravelで指定する。

Larave- コントローラーの基礎

2021-07-03 / tau / コメントする

コントローラーの生成

artisanで作成する

php artisan make:controller コントローラー名

$ php artisan make:controller SampleController
Controller created successfully.

1 2	$ php artisan make:controller SampleController Controller created successfully.

コントローラーが配置される場所。

app/Http/Controllers

$ ls -Al app/Http/Controllers/

drwxrwxrwx. 2 vagrant vagrant 205  7月  1 20:44 Auth
-rwxrwxrwx. 1 vagrant vagrant 361  7月  1 20:14 Controller.php
-rw-rw-r--. 1 vagrant vagrant 123  7月  3 11:18 SampleController.php

$ ls -Al app/Http/Controllers/

drwxrwxrwx. 2 vagrant vagrant 205 7月 1 20:44 Auth

-rwxrwxrwx. 1 vagrant vagrant 361 7月 1 20:14 Controller.php

-rw-rw-r--. 1 vagrant vagrant 123 7月 3 11:18 SampleController.php

初期状態のコントローラーの内容。

<?php

namespace App\Http\Controllers;

use Illuminate\Http\Request;

class コントローラー名 extends Controller
{
    //
}

<?php

namespace App\Http\Controllers;

use Illuminate\Http\Request;

class コントローラー名 extends Controller

{

}

$ cat app/Http/Controllers/SampleController.php
<?php

namespace App\Http\Controllers;

use Illuminate\Http\Request;

class SampleController extends Controller
{
    //
}

$ cat app/Http/Controllers/SampleController.php

<?php

namespace App\Http\Controllers;

use Illuminate\Http\Request;

class SampleController extends Controller

{

}

一般的な構成

ビューの基礎で使ったblade_sampleはルーティングファイルに変数などを記述して呼び出していた。しかし一般的には、ビューに必要な処理はコントローラーのメソッド＝アクションを記述し、ルーティングではコントローラーのアクションを呼び出す、という方法が取られる。

そこで、このルーティングに書かれた処理をコントローラーに記述しなおし、ルーティングはコントローラーを呼び出すだけの構成に変更する。

コントローラーの記述

先に生成したSampleControllerクラスのメソッドとして、sampleAction()を定義し、その中に変数定義などの処理とビューの呼び出しを記述する。

?php

namespace App\Http\Controllers;

use Illuminate\Http\Request;

class SampleController extends Controller
{
  public function sampleAction() {
    $assoc_array = [
        'head' => 'bladeテンプレートでの変数展開',
        'mechanism1' => '連想配列をview()の第2引数に渡す',
        'mechanism2' => 'それを受け取ったビューでは、キーが変数名、値が変数の内容となる',
        'escaped' => 'HTML特殊文字は<strike>自動的に</strike>エスケープされる',
        'unescaped' => '{{...}}}ではなく{!!...!!}で囲むとエスケープ<strike>される</strike>されない', 
    ];

    return view('samples.blade_sample', $assoc_array);
  }
}

?php

namespace App\Http\Controllers;

use Illuminate\Http\Request;

class SampleController extends Controller

{

public function sampleAction() {

$assoc_array = [

'head' => 'bladeテンプレートでの変数展開',

'mechanism1' => '連想配列をview()の第2引数に渡す',

'mechanism2' => 'それを受け取ったビューでは、キーが変数名、値が変数の内容となる',

'escaped' => 'HTML特殊文字は<strike>自動的に</strike>エスケープされる',

'unescaped' => '{{...}}}ではなく{!!...!!}で囲むとエスケープ<strike>される</strike>されない',

];

return view('samples.blade_sample', $assoc_array);

}

ルーティングでのアクションの定義

ルーティングの無名関数で処理を記述していた部分を、アクション呼び出しの書き方に変更する。

Route::get('sample_action', 'SampleController@sampleAction');

1	Route::get('sample_action', 'SampleController@sampleAction');

このように変更することで、ルーティングはURLとメソッドをアクションに結びつけることに専念し、シンプルになる。

Laravel – レイアウト

2021-07-01 / tau / コメントする

概要

複数のビューで共通の部分がある場合、それらをまとめたビューを作って親とする(レイアウト)
共通レイアウトの中で、個々のビューごとに内容が異なる部分に@yieldディレクティブを書く
個々のビューの最初で、レイアウトとして使うビューを@extendsで指定する
レイアウトの中で@yieldを書いた部分の具体の内容を@sectionディレクティブで書く
異なるレイアウトでまとめられる部分がある場合は親のレイアウトにまとめて、異なる部分を親レイアウトの@yieldと子レイアウトの@sectionで書き、階層化する

レイアウトとビュー

レイアウトもビューファイルだが、複数のビューで共通化できる部分をまとめたのがレイアウト。

個別のページごとの内容に対応する部分を、レイアウト中で@yieldディレクティブで名前を付けて仮置きしておく。

たとえば以下は各ページ共通のヘッダーをレイアウトに持たせて、個別ページのタイトルと内容はtitle、contentという名前で仮置きしている。

{{-- views/layouts/common.blade.php --}}

<!DOCTYPE html>
<html lang="ja">
  <head>
    <meta charset="utf-8">
    <title>@yield('title')</title>
  </head>
  <body>
    <header style="background-color: #ccc">
      <p>共通レイアウトに各ページ共通のヘッダーなどを置けます</p>
    </header>
    @yield('content')
  </body>
</html>

<!DOCTYPE html>

<head>

<title>@yield('title')</title>

</head>

<body>

<p>共通レイアウトに各ページ共通のヘッダーなどを置けます</p>

</header>

@yield('content')

</body>

</html>

個別のページでは、

レイアウトとして使うビューを@extendsディレクティブで指定する
レイアウト中@yieldで仮置きした部分に対応する内容を@sectionディレクトリーで具体に書いていく

@extends('layouts.common')

@section('title', '個別ページ')

@section('content')
  <p>個々のページの内容</p>
@endsection

@extends('layouts.common')

@section('title', '個別ページ')

@section('content')

<p>個々のページの内容</p>

@endsection

この例では、全体のレイアウトとして上で準備したビューファイルを指定して、タイトルと内容を@sectionディレクティブで具体に書いている。

@sectionディレクティブには以下の書き方がある。

2つ目の引数で内容を渡す方法
@section～@endsectionの間に具体の内容を書く方法

レイアウトの階層化と継承

レイアウトが一部共通部分を持ちながら、いくつかの種類に分けられるような場合、レイアウトを階層化する。

例えばログイン前のページ、ログイン後のページが複数あり、ログイン前後でヘッダーメニューの構成が変わる場合。

ログイン前後でヘッダーメニューの内容は異なるが、ヘッダーメニューがあるという点は共通。

共通レイアウト

まず、大元のlayouts/common.blade.phpを以下のように準備する。

{{-- views/layouts/common.blade.php --}}

<!DOCTYPE html>
<html lang="ja">
  <head>
    <meta charset="utf-8">
    <title>@yield('title')</title>
  </head>
  <body>
    @yield('header')
    @yield('content')
  </body>
</html>

<!DOCTYPE html>

<head>

<title>@yield('title')</title>

</head>

<body>

@yield('header')

@yield('content')

</body>

</html>

このレイアウトでは、タイトル、ヘッダー、内容の3つを@yieldでプレースホルダーとしている。

個別レイアウト

次に、ログイン前とログイン後それぞれのレイアウトを準備する。

全体構造は共通のcommonから@extendsで継承し、それぞれで異なる内容となる@yield('header')に対応する部分だけを具体に書いていく。

個々のページによって異なる@yield('title')と@yield('content')についてはここでは対応せず、具体のビューで内容を埋める。

以下はログイン前のレイアウト。

{{-- views/layouts/logged_out.blade.php --}}

@extends('layouts.common')

@section('header')
  <header>
    {{-- ここにログイン前のメニューを書く --}}
  </header>
@endsection

@extends('layouts.common')

@section('header')

</header>

@endsection

また、以下はログイン後のレイアウト。

{{-- views/layouts/logged_in.blade.php --}}

@extends('layouts.common')

@section('header')
  <header>
    {{-- ここにログイン後のメニューを書く --}}
  </header>
@endsection

@extends('layouts.common')

@section('header')

</header>

@endsection

個別ビュー

個別のビューでは、大元の共通レイアウトを継承したログイン前／後いずれかのレイアウトを指定する。そして未対応@yield('title')と@yield('content')に対応する内容を@sectionで埋めていく。

たとえばログイン前のログインページの例。

@extends('layouts.logged_out')

@section('title', 'ログインページ')

@section('content')
  <h1>{{ 'ログインページ' }}</h1>
  {{-- ここにログインページの内容を書く --}}
@endsection

@extends('layouts.logged_out')

@section('title', 'ログインページ')

@section('content')

<h1>{{ 'ログインページ' }}</h1>

@endsection

またログイン後のトップページの例は以下の通り。

@extends('layouts.logged_in')

@section('title', 'トップページ')

@section('content')
  <h1>{{ 'トップページ' }}</h1>
  {{-- ここにトップページの内容を書く --}}
@endsection

@extends('layouts.logged_in')

@section('title', 'トップページ')

@section('content')

<h1>{{ 'トップページ' }}</h1>

@endsection

Laravel – ビューの基礎

2021-07-01 / tau / コメントする

基本的なビューの表示方法

概要

routes/viewsディレクトリー下かそのサブディレクトリー下にビューファイルを置き、ルーティングでそれを指定する。

ビューファイル名には.blade.phpが付加され、HTML以外にLaravelの機能を持たせるための記述を含む、Bladeテンプレートとして扱われる。

ビューファイルは
- resources/viewsディレクトリー下、あるいはそのサブディレクトリー下に置く
- ファイル名は[ビュー名].blade.phpにする
ルーティングでビューファイルを指定するときは
- 無名関数の処理内容をreturn view('ビュー名');とする
  - ビュー名はビューファイル名から.blade.phpを除いたもの
- ビューファイルをサブディレクトリー下に配置した場合、resources/viewより下のパスを、デリミターを'.'として記述する

例1

Laravelプロジェクト生成直後に表示される”Laravel”の初期ページ。ルーティングファイルに以下だけ記述されている。

Route::get('/', function () {
    return view('welcome');
});

Route::get('/', function () {

return view('welcome');

});

また、resource/viewsディレクトリーにはwelcome.blade.phpファイルのみ準備されている。

[vagrant@localhost laravel_tutorial]$ ls resources/views
welcome.blade.php

1 2	[vagrant@localhost laravel_tutorial]$ ls resources/views welcome.blade.php

内容は以下のとおり。

<!DOCTYPE html>
<html lang="{{ str_replace('_', '-', app()->getLocale()) }}">
    <head>
        <meta charset="utf-8">
        <meta name="viewport" content="width=device-width, initial-scale=1">

        <title>Laravel</title>

        <!-- Fonts -->
        <link href="https://fonts.googleapis.com/css2?family=Nunito:wght@200;600&display=swap" rel="stylesheet">

        <!-- Styles -->
        <style>
            .....
        </style>
    </head>
    <body>
        <div class="flex-center position-ref full-height">
            .....

            <div class="content">
                <div class="title m-b-md">
                    Laravel
                </div>

                <div class="links">
                    <a href="https://laravel.com/docs">Docs</a>
                    <a href="https://laracasts.com">Laracasts</a>
                    <a href="https://laravel-news.com">News</a>
                    <a href="https://blog.laravel.com">Blog</a>
                    <a href="https://nova.laravel.com">Nova</a>
                    <a href="https://forge.laravel.com">Forge</a>
                    <a href="https://vapor.laravel.com">Vapor</a>
                    <a href="https://github.com/laravel/laravel">GitHub</a>
                </div>
            </div>
        </div>
    </body>
</html>

<!DOCTYPE html>

<html lang="{{ str_replace('_', '-', app()->getLocale()) }}">

<head>

<title>Laravel</title>

<style>

.....

</style>

</head>

<body>

.....

Laravel

</div>

<a href="https://laracasts.com">Laracasts</a>

<a href="https://forge.laravel.com">Forge</a>

<a href="https://vapor.laravel.com">Vapor</a>

<a href="https://github.com/laravel/laravel">GitHub</a>

</div>

</body>

</html>

例2

resourcesディレクトリーの下にsamplesディレクトリーをつくり、その中にview_sample.blade.phpというファイル名で以下の内容のファイルを作成する。

<!DOCTYPE html>
<html lang="ja">
  <head>
    <meta charset="utf-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <meta http-equiv="X-UA-Compatible" content="ie=edge">
    <title>はじめてのView</title>
    <title>簡単なView</title>
  </head>
  <body>
    <h1>簡単なView</h1>
    <p>
      Viewファイルはルーティングファイル(web.php)から呼ばれて表示される。
    </p>
  </body>
</html>

<!DOCTYPE html>

<head>

<title>はじめてのView</title>

<title>簡単なView</title>

</head>

<body>

<h1>簡単なView</h1>

<p>

Viewファイルはルーティングファイル(web.php)から呼ばれて表示される。

</p>

</body>

</html>

routes/web.phpファイルに以下のルーティングを追加する。

Route::get('/view_sample', function() {
    return view('samples.view_sample');
});

Route::get('/view_sample', function() {

return view('samples.view_sample');

});

サーバーが起動している状態でブラウザーからドメイン/view_sampleにアクセスすると、view_sample.blade.phpがパースされて表示される。

この場合のビューファイルとview()メソッドでの指定の仕方は以下のとおり。

ビューファイルをviewsディレクトリーのサブディレクトリーsamples下に作成
- views/samples/view_sample.blade.php
view()メソッドで呼び出すときは'.blade.php'を除き、パスのデリミターを'.'にした形で指定
- samples.view_sample

URIの/view_sampleとファイル名のview_sample.blade.phpは必ずしも同じである必要はない。

変数の展開

概要

ビューファイル内に、PHPの変数を埋め込んで内容を反映させることができる。

ビューに対して変数を渡すときは、[変数名]=>[内容]を要素とする連想配列で渡す
ビュー側では、連想配列のキーが変数名、値が内容として解釈される
ビュー内で{{ 変数 }}とすると変数の内容が展開され、HTMLに埋め込まれる

例

resources/samplesディレクトリー下に、ファイル名blade_sample.blade.phpで以下の内容のファイルを作成する。

<!DOCTYPE html>
<html lang="ja">
  <head>
    <meta charset="utf-8">
    <meta name="viewport" content="with=device-width, initial-scale=1.0">
    <meta http-equiv="X-UA-Compatible" content="ie=edge">
    <title>{{ $head }}</title>
  </head>
  <body>
    <h1>{{ $head }}</h1>
    <ul>
      <li>{{ $mechanism1 }}</li>
      <li>{{ $mechanism2 }}</li>
    </ul>
  </body>
</html>

<!DOCTYPE html>

<head>

</head>

<body>

<ul>

<li>{{ $mechanism1 }}</li>

<li>{{ $mechanism2 }}</li>

</ul>

</body>

</html>

このビューに対して、routes/web.php内で以下の様にルーティングを設定。

Route::get('blade_sample', function() {
    $assoc_array = [
      'head' => 'bladeテンプレートでの変数展開',
      'mechanism1' => '連想配列をview()の第2引数に渡す',
      'mechanism2' => 'それを受け取ったビューでは、キーが変数名、値が変数の内容となる',
    ];
    return view('samples.blade_sample', $assoc_array);
});

Route::get('blade_sample', function() {

$assoc_array = [

'head' => 'bladeテンプレートでの変数展開',

'mechanism1' => '連想配列をview()の第2引数に渡す',

'mechanism2' => 'それを受け取ったビューでは、キーが変数名、値が変数の内容となる',

];

return view('samples.blade_sample', $assoc_array);

});

ビューファイルのパース時に変数が展開され、内容がHTMLに埋め込まれるため、ブラウザーでの表示結果は以下のようなイメージになる。

bladeテンプレートでの変数展開

連想配列をview()の第2引数に渡す
それを受け取ったビューでは、キーが変数名、値が変数の内容となる

出力エスケープ

変数埋め込みで内容を展開する際、HTML特殊文字はエンティティーに変換されるが、エスケープを抑制してHTML特殊文字をそのまま出力する方法もある。

概要

ビューで{{ ... }}とするとHTMLの特殊文字はLaravelによってエスケープされる
{!! ... !!}とするとHTMLの特殊文字はエスケープされず、HTMLとして機能する

例

ルーティングファイルweb.phpに以下の2行を追加する。

Route::get('blade_sample', function() {
    $assoc_value = '変数内容になる値は、リテラルでも任意の前の変数でもよい';
    $assoc_array = [
      'head' => 'bladeテンプレートでの変数展開',
      'mechanism1' => '連想配列をview()の第2引数に渡す',
      'mechanism2' => 'それを受け取ったビューでは、キーが変数名、値が変数の内容となる',
      'escaped' => 'HTML特殊文字は<strike>自動的に</strike>エスケープされる',
      'unescaped' => '{{...}}}ではなく{!!...!!}で囲むとエスケープ<strike>される</strike>されない',
    ];
    return view('samples.blade_sample', $assoc_array);
});

Route::get('blade_sample', function() {

$assoc_value = '変数内容になる値は、リテラルでも任意の前の変数でもよい';

$assoc_array = [

'head' => 'bladeテンプレートでの変数展開',

'mechanism1' => '連想配列をview()の第2引数に渡す',

'mechanism2' => 'それを受け取ったビューでは、キーが変数名、値が変数の内容となる',

'escaped' => 'HTML特殊文字は<strike>自動的に</strike>エスケープされる',

'unescaped' => '{{...}}}ではなく{!!...!!}で囲むとエスケープ<strike>される</strike>されない',

];

return view('samples.blade_sample', $assoc_array);

});

また、先に作成したビューファイルblade_sample.blade.phpに以下の2行を追加する。

<!DOCTYPE html>
<html lang="ja">
  <head>
    <meta charset="utf-8">
    <meta name="viewport" content="with=device-width, initial-scale=1.0">
    <meta http-equiv="X-UA-Compatible" content="ie=edge">
    <title>{{ $head }}</title>
  </head>
  <body>
    <h1>{{ $head }}</h1>
    <ul>
      <li>{{ $mechanism1 }}</li>
      <li>{{ $mechanism2 }}</li>
    </ul>
    <p>{{ $escaped }}</p>
    <p>{!! $unescaped !!}</p>
  </body>
</html>

<!DOCTYPE html>

<head>

</head>

<body>

<ul>

<li>{{ $mechanism1 }}</li>

<li>{{ $mechanism2 }}</li>

</ul>

<p>{{ $escaped }}</p>

<p>{!! $unescaped !!}</p>

</body>

</html>

この場合のブラウザーの表示結果は以下のイメージ。

bladeテンプレートでの変数展開

連想配列をview()の第2引数に渡す
それを受け取ったビューでは、キーが変数名、値が変数の内容となる

HTML特殊文字は<strike>自動的に</strike>エスケープされる

{{…}}}ではなく{!!…!!}で囲むとエスケープされるされない

Bladeテンプレート内にコメントを書くことができ、HTMLへのパース時にはコメント行は無視される。

概要

Bladeテンプレートのコメントは{{-- ... --}}で記述する
Bladeのコメントはパース後のHTMLには現れない

例

最初に使ったview_sample.blade.phpファイルに以下の2行を追加する。

<!DOCTYPE html>
<html lang="ja">
  <head>
    <meta charset="utf-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <meta http-equiv="X-UA-Compatible" content="ie=edge">
    <title>はじめてのView</title>
    <title>簡単なView</title>
  </head>
  <body>
    <h1>簡単なView</h1>
    {{-- Blade用のコメント文はパース時に無視される --}}
    <!-- HTML用のコメントはHTMLソースに残る -->
    <p>
      Viewファイルはルーティングファイル(web.php)から呼ばれて表示される。
    </p>
  </body>
</html>

<!DOCTYPE html>

<head>

<title>はじめてのView</title>

<title>簡単なView</title>

</head>

<body>

<h1>簡単なView</h1>

<p>

Viewファイルはルーティングファイル(web.php)から呼ばれて表示される。

</p>

</body>

</html>

これがパースされた後のHTMLソースは以下の様になり、Blade用のコメントはソースに反映されていない。

<!DOCTYPE html>
<html lang="ja">
  <head>
    <meta charset="utf-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <meta http-equiv="X-UA-Compatible" content="ie=edge">
    <title>はじめてのView</title>
    <title>簡単なView</title>
  </head>
  <body>
    <h1>簡単なView</h1>
    
    <!-- HTML用のコメントはHTMLソースに残る -->
    <p>
      Viewファイルはルーティングファイル(web.php)から呼ばれて表示される。
    </p>
  </body>
</html>

<!DOCTYPE html>

<head>

<title>はじめてのView</title>

<title>簡単なView</title>

</head>

<body>

<h1>簡単なView</h1>

<p>

Viewファイルはルーティングファイル(web.php)から呼ばれて表示される。

</p>

</body>

</html>

ディレクティブ

概要

Bladeテンプレート内に条件分岐やループなどを行うディレクティブを書くことができる。

ディレクティブはBladeテンプレートに記述し、ロジック制御やレイアウト処理などPHPとしての処理を埋め込む
ディレクティブは@キーワード...のように記述する

例

まず、ルーティングでビューに配列を渡す。

Route::get('/directive_sample', function() {
  $dreams = ['一富士', '二鷹', '三茄子'];
  return view('samples.directive_sample', [
      'head' => '初夢',
      'dreams' => $dreams]);
});

Route::get('/directive_sample', function() {

$dreams = ['一富士', '二鷹', '三茄子'];

return view('samples.directive_sample', [

'head' => '初夢',

'dreams' => $dreams]);

});

ビューでは、配列の要素を一つずつ取り出して表示させている。

<!DOCTYPE html>
<html lang="ja">
  <head>
    <meta charset="utf-8">
    <meta name="viewport" content="with=device-width, initial-scale=1.0">
    <meta http-equiv="X-UA-Compatible" content="ie=edge">
    <title>{{ $head }}</title>
  </head>
  <body>
    <h1>{{ $head }}</h1>
    <ol>
      @foreach($dreams as $dream)
        <li>{{ $dream }}</li>
      @endforeach
    </ol>
  </body>
</html>

<!DOCTYPE html>

<head>

</head>

<body>

<ol>

@foreach($dreams as $dream)

<li>{{ $dream }}</li>

@endforeach

</ol>

</body>

</html>

ここで使われている@foreachや@endforeachがディレクティブで、ビューの中でPHPの処理・制御をしたり、レイアウトを扱ったりすることができる。

ディレクティブの詳細はこちら。

レイアウト

レイアウトに関するディレクティブを使って、ファイルの共通のレイアウトをまとめることができる。

概要

共通レイアウトのビューを親とする
- プレースホルダーとして@yieldディレクティブを書く
- @yieldごとにその場所に入るべきセクション名を指定
共通レイアウトを利用するビューを子とする
- 親とするレイアウトビューを@extendsディレクティブで指定する
- 親の各@yieldに対応するセクションを@sectionディレクティブで定義し、その内容を記述する

例

共通のレイアウトとして、views/layouts/common.blade.phpを以下の内容で準備する。

titlle要素に'title'セクションの内容を反映
main要素に'content'セクションの内容を反映
header要素の部分は、このページが変わっても同じ内容が表示される

<!DOCTYPE html>
<html lang="ja">
  <head>
    <meta charset="utf-8">
    <title>@yield('title')</title>
  </head>
  <body>
    <header style="background-color: #ccc">
      共通レイアウトに各ページ共通のヘッダーなどを置けます
    </header>
    <main>
      @yield('content')
    </main>
  </body>
</html>

<!DOCTYPE html>

<head>

<title>@yield('title')</title>

</head>

<body>

共通レイアウトに各ページ共通のヘッダーなどを置けます

</header>

<main>

@yield('content')

</main>

</body>

</html>

この共通レイアウトを使うページを、views/samples/layout_sample.blade.phpとして以下の内容で準備する。

@extendsディレクティブで、レイアウトとして使うビューを指定している
1つ目の@sectionディレクティブでtitleセクションに反映させる内容を$title変数で与えている
2つ目の@sectionディレクティブでcontentsセクションに反映させる内容を記述している

{{-- レイアウトファイルを指定 --}}
@extends('layouts.common')

{{-- @yield('title') の内容 --}}
@section('title', $title)

{{-- @yield('content') の内容--}}
@section('content')
  <h1>{{ $title }}</h1>
  @for ($i = 1; $i <= 10; $i++)
      @if ($i % 3 == 0)
        <p>{{ $i }}は3の倍数</p>
      @elseif ($i % 5 == 0)
        <p>{{ $i }}は5の倍数</p>
      @endif
  @endfor
@endsection

@extends('layouts.common')

@section('title', $title)

@section('content')

<h1>{{ $title }}</h1>

@for ($i = 1; $i <= 10; $i++)

@if ($i % 3 == 0)

@elseif ($i % 5 == 0)

@endif

@endfor

@endsection

これらについて以下のルーティングを設定し、ブラウザーからアクセスする。

Route::get('/layout_sample', function() {
    return view('samples.layout_sample', [
        'title' => 'レイアウトの例',
    ]);
});

Route::get('/layout_sample', function() {

return view('samples.layout_sample', [

'title' => 'レイアウトの例',

]);

});

出力イメージは以下の様になる。

共通レイアウトに各ページ共通のヘッダーなどを置けます

bladeテンプレートでの変数展開

3は3の倍数
5は5の倍数
6は3の倍数
9は3の倍数
10は5の倍数

スタイル

概要

publicディレクトリー下、あるいはそのサブディレクトリー下にCSSファイルを配置する
linkタグでCSSファイルを指定する

publicディレクトリー以下に配置されたファイルをlinkタグで指定するには、以下の様に記述する。

<link rel="stylesheet" href="{{ asset('publicより下のパス') }}">

1	<link rel="stylesheet" href="{{ asset('publicより下のパス') }}">

例

たとえばpublicディレクトリー下にcssディレクトリーを作成し、その下にstayles.cssを作成、CSSを記述したとする。

このファイルをビューから呼び出すには、以下の様に記述する。

<link rel="stylesheet" href="{{ asset('css/styles.css') }}">

1	<link rel="stylesheet" href="{{ asset('css/styles.css') }}">

Larave – ディレクティブ

2021-07-01 / tau / コメントする

概要

ディレクティブ(directive)はBladeテンプレート内に記述し、テンプレート内でPHPの処理・制御をおこなったり、共通のレイアウトを扱うといった処理を指示する。

ディレクティブは@キーワードのように書き、そのキーワードに応じて必要な表現が続く。

ロジック制御系ディレクティブ

分岐系ディレクティブ

@if

@if (条件)
  .....
@elseif (条件)
  .....
@else
  .....
@endif

@if (条件)

.....

@elseif (条件)

.....

@else

.....

@endif

@unless

@unless (条件)
  .....
@else
  .....
@endunless

@unless (条件)

.....

@else

.....

@endunless

@empty

@empty (変数)
  .....
@else
  .....
@endempty

@empty (変数)

.....

@else

.....

@endempty

@isset

@isset (変数)
  .....
@else
  .....
@endisset

@isset (変数)

.....

@else

.....

@endisset

ループ系ディレクティブ

@for

@for (初期条件; 終了条件; 変更)
  .....
@endfor

@for (初期条件; 終了条件; 変更)

.....

@endfor

@foreach

@foreach (コレクション as 変数)
  .....
@endforeach

@foreach (コレクション as 変数)

.....

@endforeach

@forelse…@empty

@forelse (コレクション as 変数)
  ....コレクションがemptyでない場合
@empty
  ....コレクションがemptyの場合
@endfor

@forelse (コレクション as 変数)

....コレクションがemptyでない場合

@empty

....コレクションがemptyの場合

@endfor

@while

@while (継続条件)
  .....
@endwhile

@while (継続条件)

.....

@endwhile

@break

PHPのbreakと同じ使い方。

@continue

PHPのcontinueと同じ使い方。

$loop変数

`$loop->index`	現在のインデックス(0, 1, 2, …)
`$loop->iteration`	現在の繰り返し数(1, 2, 3, …)
`$loop->remaining`	あと何回繰り返すか
`$loop->count`	配列の要素数
`$loop->first`	繰り返しの最初かどうか
`$loop->last`	繰り返しの最後かどうか
`$loop->depth`	繰り返しのネストの深さ
`$loop->parent`	ネストしている場合の親のループ変数

共通化・再利用関係ディレクティブ

レイアウト関係ディレクティブ

レイアウト関係はこちらにまとめている。

@extends/@yields/@section

@extendsでレイアウトとして使う親のビューを指定
@yieldで個別ビューで埋めるべきプレースホルダーを指定
個別ビューやサブレイアウトで@sectionを指定し、対応する@yieldを具体の内容で埋める

@show

@parent

部分HTML関係ディレクティブ

@include

@includeディレクティブは、別に準備された共通の部分ビューをその場所に読み込む。第2引数に連想配列を指定して、引数を渡すことができる。

@include('ビュー')

@include('ビュー', 連想配列)

@include('ビュー')

@include('ビュー', 連想配列)

例として、以下は共通して読み込まれる部分ビュー。

{{-- view/samples/include_sub.blade.php --}}

<ul>
  <li>inludeされた共通HTML</li>
  <li>{{ $item }}</li>
</ul>

<ul>

<li>inludeされた共通HTML</li>

</ul>

そして以下は、@includeで上のHTMLを読み込むビュー。

{{-- view/samples/include_sumple.blade.php --}}

<!DOCTYPE html>
<html lang="ja">
  <head>
    <meta charset="utf-8">
    <title>&#64;includeサンプル</title>
  </head>
  <body>
    <h1>&#64;includeサンプル</h1>
    <p>以下は1つ目の&#64;include。</p>
    @include('samples.include_sub', ['item' => '1つ目の@include'])
    <p>以下は2つ目の&#64;include。</p>
    @include('samples.include_sub', ['item' => '2つ目の@include'])
  </body>
</html>

<!DOCTYPE html>

<head>

<title>@includeサンプル</title>

</head>

<body>

<h1>@includeサンプル</h1>

<p>以下は1つ目の@include。</p>

@include('samples.include_sub', ['item' => '1つ目の@include'])

<p>以下は2つ目の@include。</p>

@include('samples.include_sub', ['item' => '2つ目の@include'])

</body>

</html>

@component/@slot

@includeと同じように共通の部分ビューを読み込むが、変数を指定するのに連想配列で渡す方法と@slotディレクティブで指定する方法がある。

@component('ビュー', 連想配列)

@component('ビュー')
  @slot('変数名')
    部分HTML
  @endslot
  .....
@endcomponent

@component('ビュー', 連想配列)

@component('ビュー')

@slot('変数名')

部分HTML

@endslot

.....

@endcomponent

以下は@componentで読み込まれる部品側のファイル。

{{-- views/samples/component_example.blade.php --}}

<h3>{{ $os_title }}</h3>
<p>{{ $os_list }}</p>

<h3>{{ $os_title }}</h3>

そして以下は、この部品を読み込んで使う親のファイル。

{{-- views/samples/component_sample.blade.php --}}

<!DOCTYPE html>
<html lang="ja">
  <head>
    <meta charset="utf-8">
    <title>&#64;componentサンプル</title>
  </head>
  <body>
    <h1>&#64;componentのサンプル</h1>
    @component('samples.component_example')
      @slot('os_title')
      　使用中のOS
      @endslot
      @slot('os_list')
        <li>Windows10</li>
        <li>CentOS7</li>
        <li>AmaxonLinux2</li>
        <li>DewwBSD</li>
      @endslot
    @endcomponent
  </body>
</html>

<!DOCTYPE html>

<head>

<title>@componentサンプル</title>

</head>

<body>

<h1>@componentのサンプル</h1>

@component('samples.component_example')

@slot('os_title')

　使用中のOS

@endslot

@slot('os_list')

<li>Windows10</li>

<li>CentOS7</li>

<li>AmaxonLinux2</li>

<li>DewwBSD</li>

@endslot

@endcomponent

</body>

</html>

@each

@eachディレクティブは、配列やコレクションの内容を取り出しながら、その内容を繰り返してビューに適用していく。

@each('ビュー', コレクション, '変数名')

@each('ビュー', コレクション, '変数名', 'ビュー2')

@each('ビュー', コレクション, '変数名')

@each('ビュー', コレクション, '変数名', 'ビュー2')

ビュー2はコレクションが空のときに使われるビュー。

たとえば以下のような部分ビューを準備しておいて、

{{-- views/samples/each_sub.blade.php --}}

<li>{{ $item }}</li>

以下のように@eachを使うことで、配列の要素1つずつに同じ部分ビューの内容を適用させることができる。

{{-- views/samples/each_sample.blade.php --}}

<!DOCTYPE html>
<html lang="ja">
  <head>
    <meta charset="utf-8">
    <title>&#64;eachサンプル</title>
  </head>
  <body>
    <h1>&#64;eachのサンプル</h1>
    <h1>使用しているOS</h1>
    @php
      $os_list = ['Windows10', 'CentOS7', 'AmazonLinux2', 'FreeBSD'];
    @endphp
    <ul>
      @each('samples.each_sub', $os_list, 'item')
    </ul>
  </body>
</html>

<!DOCTYPE html>

<head>

<title>@eachサンプル</title>

</head>

<body>

<h1>@eachのサンプル</h1>

<h1>使用しているOS</h1>

@php

$os_list = ['Windows10', 'CentOS7', 'AmazonLinux2', 'FreeBSD'];

@endphp

<ul>

@each('samples.each_sub', $os_list, 'item')

</ul>

</body>

</html>

この結果、@componentの時と同じようなリストが配列の要素に対応して作られる。

@import/@component/@eachの使い分け

これら3つを使い分けるシーンについて、以下のように考えてみた。

@import: ある程度の規模の定型部分ビューの一部を変数で与えながら再利用する場合。
@component: 個別ビューでHTMLの一部を設定しながら一定の構造を持たせる場合。
@each: コレクションの内容に応じたリスト項目の表示など、部分HTMLに対して定型で内容が変化する場合。

概要

dump()

dd()

概要

ルーティングの書き方

概要

フォーム

ルーティング

コントローラー

必須事項

アクションにおけるパラメーターの取得

Requestオブジェクトのinput()メソッド

request()関数

概要

ドメイン名

ドメインを含むパスの生成

現在のURLに関する情報

概要

ルーティング

コントローラー

必須事項

Request使用の宣言

アクションの引数でのRequestオブジェクト指定

共通のコントローラー・アクションの形式

アクションにおけるパラメーターの取得

Requestオブジェクトの属性からパラメーターを受け取る方法

request()関数にパラメーター名を指定して受け取る方法

パラメーター省略時

ルーティングの基本形

メソッド

URL

ルーティング先

コントローラーとアクションを指定

シングルアクションコントローラーを指定

直接ビューを指定

直接出力

ルートパラメーター

コントローラーの生成

一般的な構成

コントローラーの記述

ルーティングでのアクションの定義

概要

レイアウトとビュー

レイアウトの階層化と継承

共通レイアウト

個別レイアウト

個別ビュー

基本的なビューの表示方法

概要

例1

例2

変数の展開

概要

例

出力エスケープ

概要

例

コメント

概要

例

ディレクティブ

概要

例

レイアウト

概要

例

スタイル

概要

例

概要

ロジック制御系ディレクティブ

分岐系ディレクティブ

@if

@unless

@empty

@isset

ループ系ディレクティブ

@for

@foreach

@forelse…@empty

アクションの引数での`Request`オブジェクト指定