laravel 7 でリソースコントローラを自動生成して CRUD のうちindex表示を実装する～Laravel入門～

PHPのフレームワークLaravel で blog アプリを作成しながら、laravelの使い方を説明しています。

Laravelはバージョン7を使います。

仕様と手順は、以下の記事の通りです。

laravelでログイン機能付きサイトを作ってみよう、作成予定のWebアプリケーションの概要と作業手順の概略～laravel入門～

laravelでログイン機能付きブログサイトを作ってみましょう。まず、作成予定のWebアプリケーションの概要と作業手順の概略を説明します。それぞれの細かい手順については、別の記事で補足していきます。 laravelは、現在(2...

今回は、3. アプリ作成の【7 Blog機能作成】の2回目となります。

今回の学習ポイントは次のとおり。

7. Blog機能作成
7.4. 投稿コントローラの作成
7.5. 投稿一覧の表示機能作成

いろんな書き方はあるのですが、基本的であり、応用が利きそうな方法を使って作成していきます。

なお、前回まででモデルとマイグレーションファイルを作成しましたが、もしまだの方は、作成してから、またこちらに戻ってきてくださいね。

投稿コントローラの作成と投稿一覧の表示機能の作成
- 投稿コントローラで投稿を操作する
- CRUD操作とリソースについて
7.4. 投稿コントローラの作成
7.5. 投稿一覧の表示機能作成
- Laravelのアプリケーションの構成の復習
表示テスト
- エラーが発生してしまったら
まとめ

投稿コントローラの作成と投稿一覧の表示機能の作成

投稿コントローラで投稿を操作する

今回作成するのはblogなので、記事を投稿したり、閲覧したりする機能を付けます。

そのために投稿コントローラを作って、投稿を操作します。

Laravelのコントローラには、リソースコントローラを作るオプションがあります。

これはコントローラの中でも、モデルを操作するのに特化したものです。

リソースコントローラを作って、一覧表示をさせるところまでを勉強しましょう。

CRUD操作とリソースについて

ほとんどのツールは、リソース（データ）に対して、次の４つの操作が可能です。

・作成(Create)
・読み出し(Read)
・更新(Update)
・削除(Delete)

この４つの操作は、頭文字をとって CRUD（クラッド）を呼ばれます。

今回は、投稿(Post)がリソースになりますので、Post を CRUD操作するためのコントローラを作ろうと思います。

Laravelが用意している機能に乗っかる(使う）と、一から自分で考えてこれらの操作を実装するより、だいぶ楽に実装できますよ。

7.4. 投稿コントローラの作成

では、実際にコントローラを作ってきましょう。

artisan のコントローラ作成コマンドを一覧表示させる

まずはアプリケーションディレクトリに移動し、次のartisanコマンドを実行します。

php artisan make:controller --help

1	php artisan make:controller --help

するとコントローラ作成コマンドのオプションが表示されます。

user@GA401IH-R7G1650 MINGW64 /c/data/tk/work/myapp/blog2 (master)
$ php artisan make:controller --help
Description:
  Create a new controller class

Usage:
  make:controller [options] [--] <name>

Arguments:
  name                   The name of the class

Options:
      --api              Exclude the create and edit methods from the controller.
      --force            Create the class even if the controller already exists
  -i, --invokable        Generate a single method, invokable controller class.
  -m, --model[=MODEL]    Generate a resource controller for the given model.
  -p, --parent[=PARENT]  Generate a nested resource controller class.
  -r, --resource         Generate a resource controller class.
  -h, --help             Display this help message
  -q, --quiet            Do not output any message
  -V, --version          Display this application version
      --ansi             Force ANSI output
      --no-ansi          Disable ANSI output
  -n, --no-interaction   Do not ask any interactive question
      --env[=ENV]        The environment the command should run under
  -v|vv|vvv, --verbose   Increase the verbosity of messages: 1 for normal output, 2 for more verbose output and 3 for debug

user@GA401IH-R7G1650 MINGW64 /c/data/tk/work/myapp/blog2 (master)

$ php artisan make:controller --help

Description:

Create a new controller class

Usage:

make:controller [options] [--] <name>

Arguments:

name The name of the class

Options:

--api Exclude the create and edit methods from the controller.

--force Create the class even if the controller already exists

-i, --invokable Generate a single method, invokable controller class.

-m, --model[=MODEL] Generate a resource controller for the given model.

-p, --parent[=PARENT] Generate a nested resource controller class.

-r, --resource Generate a resource controller class.

-h, --help Display this help message

-q, --quiet Do not output any message

-V, --version Display this application version

--ansi Force ANSI output

--no-ansi Disable ANSI output

-n, --no-interaction Do not ask any interactive question

--env[=ENV] The environment the command should run under

-v|vv|vvv, --verbose Increase the verbosity of messages: 1 for normal output, 2 for more verbose output and 3 for debug

-r あるいは –resource オプションを使えば、リソースコントローラを作ることができそうです。

コントローラを作成する

では、下のコマンドで投稿をコントロールする PostsController を作ってみましょう。

次のようにコマンドを打ちます

php artisan make:controller --resource PostsController

1	php artisan make:controller --resource PostsController

コントローラは複数のリソースを操作するため、 Postsのように複数形を名前に使う慣習があります。

また【–resource】オプションをつけると、コントローラ作成時に７つのメソッドが作成されます。

下のように、作成に成功しましたと表示が出たらOKです。

user@GA401IH-R7G1650 MINGW64 /c/data/tk/work/myapp/blog2 (master)
$ php artisan make:controller --resource PostsController
Controller created successfully.

user@GA401IH-R7G1650 MINGW64 /c/data/tk/work/myapp/blog2 (master)

$ php artisan make:controller --resource PostsController

Controller created successfully.

作成されたファイルの確認

このコマンドによって、下図のように、PostsController.php ファイルが作られます。

PostsControllerクラスには、あらかじめ、7つのメソッド(メンバー関数)が書かれています。

これは【–resource オプション】を付けて作成したためです。このオプションがなければ、メソッドが何もない空っぽのクラスができるところでした。

7つのメソッドは次のようになっています。

<?php

namespace App\Http\Controllers;

use Illuminate\Http\Request;
use App\Post;

class PostsController extends Controller
{
    /**
     * Display a listing of the resource.
     *
     * @return \Illuminate\Http\Response
     */
    public function index()
    {
         // 
    }

    /**
     * Show the form for creating a new resource.
     *
     * @return \Illuminate\Http\Response
     */
    public function create()
    {
        //
    }

    /**
     * Store a newly created resource in storage.
     *
     * @param  \Illuminate\Http\Request  $request
     * @return \Illuminate\Http\Response
     */
    public function store(Request $request)
    {
        //
    }

    /**
     * Display the specified resource.
     *
     * @param  int  $id
     * @return \Illuminate\Http\Response
     */
    public function show($id)
    {
        //
    }

    /**
     * Show the form for editing the specified resource.
     *
     * @param  int  $id
     * @return \Illuminate\Http\Response
     */
    public function edit($id)
    {
        //
    }

    /**
     * Update the specified resource in storage.
     *
     * @param  \Illuminate\Http\Request  $request
     * @param  int  $id
     * @return \Illuminate\Http\Response
     */
    public function update(Request $request, $id)
    {
        //
    }

    /**
     * Remove the specified resource from storage.
     *
     * @param  int  $id
     * @return \Illuminate\Http\Response
     */
    public function destroy($id)
    {
        //
    }
}

<?php

namespace App\Http\Controllers;

use Illuminate\Http\Request;

use App\Post;

class PostsController extends Controller

{

/**

* Display a listing of the resource.

* @return \Illuminate\Http\Response

public function index()

{

}

/**

* Show the form for creating a new resource.

* @return \Illuminate\Http\Response

public function create()

{

}

/**

* Store a newly created resource in storage.

* @param \Illuminate\Http\Request $request

* @return \Illuminate\Http\Response

public function store(Request $request)

{

}

/**

* Display the specified resource.

* @param int $id

* @return \Illuminate\Http\Response

public function show($id)

{

}

/**

* Show the form for editing the specified resource.

* @param int $id

* @return \Illuminate\Http\Response

public function edit($id)

{

}

/**

* Update the specified resource in storage.

* @param \Illuminate\Http\Request $request

* @param int $id

* @return \Illuminate\Http\Response

public function update(Request $request, $id)

{

}

/**

* Remove the specified resource from storage.

* @param int $id

* @return \Illuminate\Http\Response

public function destroy($id)

{

}

7つの基本メソッドの役割

上記PostsController にあるメソッドを下の表にまとめました。

アクション	用途
index	一覧表示(Read)
create	新規作成のためのフォーム表示(Create)
store	新規作成のためのデータ保存(Create)
show	1件の詳細表示(Read)
edit	既存レコードの変更のためのフォーム表示(Update)
update	既存レコードの変更のためのデータ保存(Update)
destroy	既存レコードの削除(Delete)

それぞれのメソッドでCRUDを実現していきます。

CRUDの4つの用途のために7つのアクションがある感じです。

CRUDの4つに対してアクションが7つと多いのは、次の理由のためです。

Readが、複数レコードの一覧表示と、1件だけの表示の2種類あること。
Create と Update がフォーム表示とデータ保存の2ステップ必要なこと

1つのアクションで済むのはDeleteだけ。ただし複数のレコードを一気に消したいなって思ったら、アクションをあとで追加したりできます。

なので基本は7つ、だけど後から追加する可能性もあると考えておいてください。

なお、公式マニュアルに7つの基本アクションをURIやルート名とセットに表示した表がありました。

こちらも役に立つので、載せておきますね。

7.x コントローラ Laravel
readouble.com

7.5. 投稿一覧の表示機能作成

では、手始めとして、投稿一覧の表示画面を作ってみましょう。

Laravelのアプリケーションの構成の復習

まず、Laravelでのプログラミングのデザインパターンを復習します。

Laravelは他のフレームワークのように、MVCデザインパターンを使ってます。

MVCデザインパターンとは、

データベースとのやり取りの部分をモデル(Model)クラスとして作り
html に動的に変更するデータを組み込んでページを構成する部分をビュー(View)として作り
ブラウザからのアクセス要求に対して、モデルやビューを使いながら送信する返答を作成する処理をコントローラ（Controller)クラスの中に作る

というソフトウェアのデザインです。

モデル、ビュー、コントローラの頭文字をとってMVCデザインパターンと呼んでいます。

この３つに加えて、ブラウザからの要求を読み説いて、どのコントローラを呼び出すかを判断するルーター(Router)というのがあります。

分かりやすいように図にしてみました。

Laravelの構成とMVCデザインパターン

Laravelでは、コントローラ、モデル、ビュー、ルーター部分に、プログラムコードを書いていくことになります。

ルート設定をする

まずルータの設定部分であるルート設定を行います。

ルート設定とは、リクエストURLに応じて処理の受け渡しを決定する仕組みのこと。

すべてお任せの場合は、一行で７つのアクションをすべて定義してくれる設定方法があります。

ルート設定ファイル routes/web.php ファイルに以下の１文の設定を追加してください。

Route::resource('posts', 'PostsController');

1	Route::resource('posts', 'PostsController');

これは posts という名称と、PostsController というコントローラを使って、リソースコントローラ用のルート設定を追加するという意味になります。

Route::get だとか、Route::post とかの設定で同じことを書くと７文必要になるのですが、上記のように書けば１行で済みます。

一行で書いたルート設定resource(‘posts’, ’PostsController’) の意味

上記のように書くと、実際にどのような処理の振り分けをしてくれるのか調べる artisan のコマンドが用意されています。

調べてみましょう。

コマンドを入力するターミナルソフトの横幅を大きくして、 php artisan route:list とコマンド実行してみましょう。

すると、以下のようなルート設定が表示されます。

user@GA401IH-R7G1650 MINGW64 /c/data/tk/work/myapp/blog2 (master)
$ php artisan route:list
+--------+-----------+------------------------+------------------+------------------------------------------------------------------------+------------+
| Domain | Method    | URI                    | Name             | Action                                                                 | Middleware |
+--------+-----------+------------------------+------------------+------------------------------------------------------------------------+------------+
|        | GET|HEAD  | /                      |                  | App\Http\Controllers\PagesController@index                             | web        |
|        | GET|HEAD  | about                  | about            | App\Http\Controllers\PagesController@about                             | web        |
|        | GET|HEAD  | api/user               |                  | Closure                                                                | api        |
|        |           |                        |                  |                                                                        | auth:api   |
|        | GET|HEAD  | home                   | home             | App\Http\Controllers\HomeController@index                              | web        |
|        |           |                        |                  |                                                                        | auth       |
|        | GET|HEAD  | login                  | login            | App\Http\Controllers\Auth\LoginController@showLoginForm                | web        |
|        |           |                        |                  |                                                                        | guest      |
|        | POST      | login                  |                  | App\Http\Controllers\Auth\LoginController@login                        | web        |
|        |           |                        |                  |                                                                        | guest      |
|        | POST      | logout                 | logout           | App\Http\Controllers\Auth\LoginController@logout                       | web        |
|        | POST      | password/confirm       |                  | App\Http\Controllers\Auth\ConfirmPasswordController@confirm            | web        |
|        |           |                        |                  |                                                                        | auth       |
|        | GET|HEAD  | password/confirm       | password.confirm | App\Http\Controllers\Auth\ConfirmPasswordController@showConfirmForm    | web        |
|        |           |                        |                  |                                                                        | auth       |
|        | POST      | password/email         | password.email   | App\Http\Controllers\Auth\ForgotPasswordController@sendResetLinkEmail  | web        |
|        | POST      | password/reset         | password.update  | App\Http\Controllers\Auth\ResetPasswordController@reset                | web        |
|        | GET|HEAD  | password/reset         | password.request | App\Http\Controllers\Auth\ForgotPasswordController@showLinkRequestForm | web        |
|        | GET|HEAD  | password/reset/{token} | password.reset   | App\Http\Controllers\Auth\ResetPasswordController@showResetForm        | web        |
|        | GET|HEAD  | posts                  | posts.index      | App\Http\Controllers\PostsController@index                             | web        |
|        | POST      | posts                  | posts.store      | App\Http\Controllers\PostsController@store                             | web        |
|        | GET|HEAD  | posts/create           | posts.create     | App\Http\Controllers\PostsController@create                            | web        |
|        | GET|HEAD  | posts/{post}           | posts.show       | App\Http\Controllers\PostsController@show                              | web        |
|        | PUT|PATCH | posts/{post}           | posts.update     | App\Http\Controllers\PostsController@update                            | web        |
|        | DELETE    | posts/{post}           | posts.destroy    | App\Http\Controllers\PostsController@destroy                           | web        |
|        | GET|HEAD  | posts/{post}/edit      | posts.edit       | App\Http\Controllers\PostsController@edit                              | web        |
|        | POST      | register               |                  | App\Http\Controllers\Auth\RegisterController@register                  | web        |
|        |           |                        |                  |                                                                        | guest      |
|        | GET|HEAD  | register               | register         | App\Http\Controllers\Auth\RegisterController@showRegistrationForm      | web        |
|        |           |                        |                  |                                                                        | guest      |
+--------+-----------+------------------------+------------------+------------------------------------------------------------------------+------------+

user@GA401IH-R7G1650 MINGW64 /c/data/tk/work/myapp/blog2 (master)

$ php artisan route:list

+--------+-----------+------------------------+------------------+------------------------------------------------------------------------+------------+

+--------+-----------+------------------------+------------------+------------------------------------------------------------------------+------------+

| | GET|HEAD | / | | App\Http\Controllers\PagesController@index | web |

| | GET|HEAD | password/reset/{token} | password.reset | App\Http\Controllers\Auth\ResetPasswordController@showResetForm | web |

| | GET|HEAD | posts/{post} | posts.show | App\Http\Controllers\PostsController@show | web |

| | PUT|PATCH | posts/{post} | posts.update | App\Http\Controllers\PostsController@update | web |

| | DELETE | posts/{post} | posts.destroy | App\Http\Controllers\PostsController@destroy | web |

| | GET|HEAD | posts/{post}/edit | posts.edit | App\Http\Controllers\PostsController@edit | web |

+--------+-----------+------------------------+------------------+------------------------------------------------------------------------+------------+

説明のために下に今回ルート設定に追加したPostsController関連だけ下図に抜粋します。

７個のルート設定がされています。

URIと書いてあるのが、アクセスするときのURLのディレクトリ部分です。

例えば、一番上は単に【posts】と書かれています。

https://example.com/posts

1	https://example.com/posts

のようにブラウザで /posts にアクセスすると、Actionに記述してある通り PostsController コントローラのindex メソッドを呼び出すという意味になっています。

それぞれのアクションのメソッドとURI の組み合わせを下の表に抜粋します。

メソッドと URI の組み合わせで、アクションを判断します。

アクション	URI	メソッド
index	https://example.com/posts	GET でアクセス
create	https:/example.com/posts/create	GET でアクセス
store	https:/example.com/posts	POST でアクセス
show	https:/example.com/post/{投稿ID}	GET でアクセス
edit	https:/example.com/posts/{投稿ID}/edit	GET でアクセス
update	https:/example.com/posts/{投稿ID}	PUT か PATCH でアクセス
destroy	https:/example.com/posts/{投稿ID}	DELETEでアクセス

メソッドの違いがあるので、URI部分は同じでもよく、結果としてシンプルなURIでアクセスすることができます。

補足：メソッドは大きく分けてGETとPOSTの２種類。ブラウザからのデータ送信方法が違う

Methodは次の通りです。

大きな分類のメソッド	対象メソッド	データの送信方法
GET	GET HEAD	サーバからデータを受け取るために使用する。ブラウザから情報をサーバに送りたいときは、クエリパラメータとしてURLに追加される。例：以下のURLの ? の page=1&category_id=3 の部分。 https://example.com/products?page=1&category_id=3
POST	POST PUT PATCH DELETE	サーバにデータを送信するために使用する。また結果としてサーバからはGETメソッド同様にデータを受け取る。 GETとの違いは、データを送るとき、URLに書かず、送信データの一部として送ること。このため、文字以外の画像とかバイナリデータも送ることができる。また、送信データがURLに表示されないため、パスワードなど人の目に触れさせたくないデータを送るのに向いている。

ブラウザで通常URL を指定してアクセスするときは、GET メソッドを使っています。

そのほかに、フォームを使ってブラウザからサーバーにデータを送るとき、POSTメソッドを使ったりします。

ここでは、そのほかに、PUT あるいは PATCH メソッド、DELETE メソッドが出てきています。GET あるいは HEAD 以外はフォームからアクセスするときの方式と覚えておいてください。

大きく分けると、ブラウザからサーバにデータを URLについでに書いて送る方式をGETメソッド、そうではなく送信データとして送るのがPOSTメソッドと覚えておくとよいでしょう。

そして、PUT、PATCH、DELETEメソッドというのはPOSTメソッドと同じ仕組みを使っていて、サーバー側で処理を切り分けるためだけに使っています。

コントローラを実装する

ルート設定の後は、コントローラを実装します。

今回は一覧表示を追加するので、PostsController コントローラの index メソッドを修正します。

app/Http/Controllers/PostsController.php ファイルの6行目あたりに下記を追加してください。

use App\Post;

1	use App\Post;

ここから書く【Post】は、Appフォルダの下にある【Post】のことだよ、という意味になります。

次に次の２行を最初のメソッドに追加してください。

$posts = Post::all();
return view('posts.index')->with('posts', $posts);

1 2	$posts = Post::all(); return view('posts.index')->with('posts', $posts);

追加後は下図のようになります。

短いですが、まさに、コントローラから、モデルとビューを操作して、ブラウザに返信するhtmlのデータを作成しています。

それぞれのコードを説明します。

$posts = Post::all();

1	$posts = Post::all();

で、Postモデルを使って、データベースに保存されているすべての投稿を読みだして、$posts変数に代入しています。

そして、

return view('posts.index')->with('posts', $posts);

1	return view('posts.index')->with('posts', $posts);

では、ビューの posts/index.blade.php ファイルに、今作った $posts 変数ですべての投稿のデータを渡して、htmlのページを作成しています。

return とあるので、作成したデータをこのメソッドを呼び出した人に返答して処理を終了しています。その人(人じゃないですが^^;）は、そのまま、ブラウザ（閲覧者）にhtmlのページを送ってるんですね。

今回は、Post::all() のstaticメソッドを呼び出すために、Post モデルに処理を追加する必要はありません。もともとPostモデルの継承元のクラスに備わっているためです。

ビューを実装する

最後にビューを作ります。

ビューは、基本的には php ファイルなのですが、html寄りのphpファイルになります。

つまり、htmlファイルの一部に <?php ?> タグで PHPコードを埋め込むような感じのファイルです。

ただし違いがあり、<?php ?> でPHPコードを埋め込むより、楽にデータを埋め込めるように省略表記ができるようになっています。この機能をテンプレート機能といいます。

Laravelにはblade というテンプレート処理エンジンが組み込まれています。なので、ビューのファイルの拡張子は、blade.php となっています。

コントローラから呼び出すときは、【blade.php】の部分を省略して書きます。

今回、コントローラからは、

return view('posts.index')->with('posts', $posts);

1	return view('posts.index')->with('posts', $posts);

と書きました。これは、posts/index.blade.php ファイルを呼び出すという意味です。

ですので、posts フォルダとその中の index.blade.php というファイルを作成していきましょう。

ファイルの位置

ビューのフォルダやファイルは、resources/views フォルダの下に作ります。

views フォルダの下に postsフォルダを作り、その中にindex.blade.php ファイルを作りましょう。

そしてindex.blade.phpに以下のプログラムコードを入力してください。

@extends('layouts.app')

@section('content')
<div class="container">
    @foreach ($posts as $post)
    <div class="card">
        <div class="row">
            <div class="col-md-12">
                <h2><a href="{{route('posts.show', $post->id)}}">{{$post->title}}</a></h2>
                <small>投稿者:{{$post->user->name}} 作成日:{{$post->created_at}}</small>
            </div>
        </div>
    </div>
    @endforeach
</div>
@endsection

@extends('layouts.app')

@section('content')

@foreach ($posts as $post)

<h2><a href="{{route('posts.show', $post->id)}}">{{$post->title}}</a></h2>

<small>投稿者:{{$post->user->name}} 作成日:{{$post->created_at}}</small>

</div>

@endforeach

</div>

@endsection

ファイルの中身は以下のようになります。

@記号で始まる行が、bladeテンプレートエンジンの機能になります。

これにより<?php ?>タグがなくても、変数を組み込んだり、繰り返し表示させたりと、動的なページを作成することができます。

ざっと内容を説明すると、投稿をひとつづつ、タイトルと投稿者、作成日を表示していきます。レイアウトとしては、ブートストラップにあるcss を利用しています。cardとかrowの部分ですね。

そして、タイトルをクリックしたら、詳細ページに飛ぶようにリンクを設定しています。

以下、htmlの説明は省いて、bladeテンプレートエンジンの命令について説明していきます。

bladeテンプレートエンジンの命令の説明

共通部分の指定

@extends('layouts.app')

1	@extends('layouts.app')

これは、共通部分として views/layouts/app.blade.php ファイルを使用するという意味です。

共通部分のファイルをレイアウトファイルという言い方をします。主に、htmlのヘッダ部分だとか、ページのヘッダ、フッタ部分などを共通部分として記述してます。

今回、ログイン機能を組み込んだ時に一緒にLaravelによって組み込まれた表示をそのまま使ってます。

ページ固有部分の実装

レイアウトファイルには、ページごとに違う処理を書きたい部分を指定しておくことができます。

例えば、layouts/app.blade.php には、以下の記述があります。

            @yield('content')

1	@yield('content')

これは、content というセクションの内容を埋め込んで表示するという意味になります。

さて、そして、posts/index.blade.php には @section 命令があります。

@section('content')

1	@section('content')

この命令は、@endsection までの記述をベースとなるlayouts/app.blade.phpの @yield(‘content’) の位置に埋め込んでねという命令です。

@endsection

1	@endsection

セクションの終了位置を意味します。

foreachによる繰り返し処理

@foreach ($posts as $post)

1	@foreach ($posts as $post)

これはphp のforeach と同じ意味です。コンパクトに書けるというメリットがり、また終了タグもわかりやすいというメリットがあります。

コントローラから渡された ‘posts’ という名前のデータは $posts という変数で使用できます。今回 foreach の中で、投稿１つ１つを$post という名前で参照することができます。

@endforeach

1	@endforeach

はforeachの終了位置を示します。このタグまでの記述が繰り返されます。

PHPコードの埋め込み

{{route('posts.show', $post->id)}}

1	{{route('posts.show', $post->id)}}

上の1行のコードのうち、bladeテンプレート機能は、 {{ }} の「ダブル波かっこ」になります。これは中のPHPの実行結果を表示するという意味になります。その際、htmlタグはエスケープ処理されるところが特徴です。

同じことをPHPコードで書こうとすると、

<?php echo htmlspecialchars(route('posts.show', $post->id)); ?>

1	<?php echo htmlspecialchars(route('posts.show', $post->id)); ?>

という長いコードになってしまいます。

ちなみにhtmlタグをエスケープ処理せずに表示する場合は、通常のphpコードでは次のように書きます。

<?php echo route('posts.show', $post->id); ?>

1	<?php echo route('posts.show', $post->id); ?>

bladeテンプレートでは、{!! !!} で記述を囲みます。これは、次回以降で使うので、またその時に説明しますね。

説明を続けると、 {{ }}の中の route() 関数は、blade.phpの機能ではないのですが、laravel の関数になります。つまり、route()関数はビューの中だけでなく、コントローラでも使えるということを意味します。

route()は、URL を /posts/edit などのように実際のURLで指定するのではなく、ルート設定で設定したときのルート名で指定できるというものです。

例えば、投稿の詳細表示は、下のルート設定情報の赤枠でした。今回、これを呼びたいのですが、Name のカラムに posts.show と記述があります。

route()関数は、このルート設定につけられた名前を使って、URI posts/投稿IDを自動で作ってくれます。なかなか便利な機能です。

ですが、もしかして、「普通に

href="{{ '/posts/' . $posts->id }}"

1	href="{{ '/posts/' . $posts->id }}"

と書いたほうが楽じゃないか」とか思いませんでしたか？

確かに、こう書いてある解説書も多いですし、記述も楽ですよね。

でも、まずい場合があるんです。

例えばアプリを配置したルートURLが、

http://work.localhost/myapp/blog2/public

1	http://work.localhost/myapp/blog2/public

のように http://ドメイン名/ 直下じゃないときを考えてください。

この時、

<a href="/posts/3">リンク例</a>

1	<a href="/posts/3">リンク例</a>

としてしまうと、

http://work.localhost/myapp/blog2/public/posts/3

1	http://work.localhost/myapp/blog2/public/posts/3

に飛んでほしいのに、

http://work.localhost/posts/3

1	http://work.localhost/posts/3

に飛んでしまいます。

route() 関数を使えば、ちゃんとアプリのトップURLからのURLを作成してくれます。

なのでroute()を使う癖をつけておくことをおすすめします。route を使わないときは、トップURLにディレクトリが含まれないことを確認するようにしてください。

Postモデルに変更が必要な参照

さて、ひとつだけ注意点があります。

bladeファイルには、下記のようにPHPコードを埋め込みました。

<small>投稿者:{{$post->user->name}} 作成日:{{$post->created_at}}</small>

1	<small>投稿者:{{$post->user->name}} 作成日:{{$post->created_at}}</small>

このうち、 $post->user->nameの部分は、投稿ユーザ名を表示している部分なのですが、Postモデルには、user_id はあってもユーザやユーザ名はないので、このまま実行するとエラーになります。

そうならないために、実行前に、Post モデルに変更を加える必要があります。

変更の仕方を解説します。

モデルの実装

今回、ビューから投稿ユーザ名を参照するために、モデルに以下のメソッドを追加します。

モデルは、app/Post.php のファイルです。

    public function user() {
        return $this->belongsTo('App\User');
    }

public function user() {

return $this->belongsTo('App\User');

}

追加後のPostモデルのコードは以下のようになります。

<?php

namespace App;

use Illuminate\Database\Eloquent\Model;

class Post extends Model
{
    public function user() {
        return $this->belongsTo('App\User');
    }
}

<?php

namespace App;

use Illuminate\Database\Eloquent\Model;

class Post extends Model

{

public function user() {

return $this->belongsTo('App\User');

}

これはリレーションを設定しています。

データベースのSQL言語では、例えば今回のposts テーブルからデータを読み出すときに、user_id を使って、対応する user テーブルも一緒に読み出すことができます。

そうすることで、user テーブルに定義されている name の情報も一緒に参照することができるんです。

同じことをlaravelでやるときは、リレーションを設定します。

リレーションは関係という意味ですね。

公式マニュアルには以下のようにリレーションの説明があります。

7.x Eloquent：リレーション Laravel

つまり、Post には user_id というカラムがあって、user_id と同じid をもつUser モデルと関連付けるためには、belongsTo()メソッドを使って定義するということになります。

id名がuser_id とわかりやすい名前になっているため、user_id を使うように明確に指示しなくても、belongsTo(‘App\User’); の User という名前から user_id を自動的に使ってくれます。

もし違う名前にしている場合には、belongsTo()メソッドに第二引数として、カラム名を指示してください。

例えば、user_id とせずに、author_id などと Post に定義してしまった場合、

$this->belongsTo('App\User', 'author_id');

1	$this->belongsTo('App\User', 'author_id');

のように指定してください。

メニューにブログ記事一覧へのリンクをはろう

最後に、下図のように、今回作った投稿一覧表示へのリンクを作りましょう。

先ほど、説明しましたが、メニューは共通部分になるので、

resources/views/layouts/app.blade.php ファイルに該当箇所があります。

「Right Side Of Navbar」という【ナビゲーションバーの右側】を意味するコメント文を頼りに、以下のように３行のメニューを足してください。

                        <li class="nav-item">
                            <a class="nav-link" href="{{ route('posts.index') }}">ブログ</a>
                        </li>