CRUDアプリの拡張（検索）

2018/03/07 2018/03/09

前回は、CRUDアプリの削除処理を終えました。

これで一通り、Webアプリでの基本となる機能を学びました。

今回はもう少し一歩踏み出して検索機能をつけてみます。

一覧表示には通常、検索機能が必要になるのでこの機能もセットで勉強したほうがいいかもしれません。

チュートリアル

追加すべき機能は主に３つになります。

・一覧画面に検索フォームを追加（ビュー）
・一覧画面を表示するメソッド getIndex() に検索機能を追加（コントローラー）
・検索結果のページネーションの際にkeywordを持ちまわるようにする（ビュー）

手順

１）検索フォームの追加（ビュー）
２）ページネーションの改修（ビュー）
３）検索機能の追加（コントローラー）
４）動作確認

１）検索フォームの追加（ビュー）

検索結果は一覧画面になるので検索フォームはGET送信になります。

一覧画面のルーティングがGETで処理をしているからです。

routes.php
1	`Route::get('list',` `'StudentController@getIndex');` `//一覧`

ＨＴＭＬですが若干、レイアウトを変更しました。

list.blade.php：
 <div class="row" style="margin-bottom: 30px;">
  <div class="col-sm-10" style="margin-bottom: 10px;">
  <form method="get" action="" class="form-inline">
  <div class="form-group">
     <input type="text" name="keyword" class="form-control" value="{{$keyword}}" placeholder="検索キーワード">
  </div>
  <input type="submit" value="検索" class="btn btn-info">
  </form>
  </div>
  <div class="col-sm-2">
  <a href="/student/new" class="btn btn-warning"><i class="glyphicon glyphicon-plus"></i> 新規登録</a>
  </div>
 </div>
：

list.blade.php
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15	`：` `<div` `class="row"` `style="margin-bottom: 30px;">` `<div` `class="col-sm-10"` `style="margin-bottom: 10px;">` `<form` `method="get"` `action=""` `class="form-inline">` `<div` `class="form-group">` `<input` `type="text"` `name="keyword"` `class="form-control"` `value="{{$keyword}}"` `placeholder="検索キーワード">` `</div>` `<input` `type="submit"` `value="検索"` `class="btn btn-info">` `</form>` `</div>` `<div` `class="col-sm-2">` `<a` `href="/student/new"` `class="btn btn-warning"><i` `class="glyphicon glyphicon-plus"></i> 新規登録</a>` `</div>` `</div>` `：`

２）ページネーションの改修（ビュー）

ページネーションの記述は以下のように変更します。

list.blade.php：
{{-- {!! $students->render() !!}--}}
 {!! $students->appends(['keyword'=>$keyword])->render() !!}
：

list.blade.php
1 2 3 4	`：` `{{-- {!!` `$students->render() !!}--}}` `{!!` `$students->appends(['keyword'=>$keyword])->render() !!}` `：`

【ポイント】
ページネーションに検索文字列を付け加えたい場合は appendsメソッドを使います。

３）検索機能の追加（コントローラー）

検索用のルートやメソッドを新規に定義はせず、getIndexメソッドを改良します。

StudentController.phppublic function getIndex(Request $rq)
{
//キーワード受け取り
$keyword = $rq->input('keyword');
 
//クエリ生成
$query = \App\Student::query();
 
//もしキーワードがあったら
if(!empty($keyword))
{
$query->where('email','like','%'.$keyword.'%')->orWhere('name','like','%'.$keyword.'%');
}
 
//ページネーション
$students = $query->orderBy('id','desc')->paginate(10);
return view('student.list')->with('students',$students)->with('keyword',$keyword);
}

StudentController.php
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18	`public` `function` `getIndex(Request` `$rq)` `{` `//キーワード受け取り` `$keyword` `=` `$rq->input('keyword');` `//クエリ生成` `$query` `= \App\Student::query();` `//もしキーワードがあったら` `if(!empty($keyword))` `{` `$query->where('email','like','%'.$keyword.'%')->orWhere('name','like','%'.$keyword.'%');` `}` `//ページネーション` `$students` `=` `$query->orderBy('id','desc')->paginate(10);` `return` `view('student.list')->with('students',$students)->with('keyword',$keyword);` `}`

まず、eloquentでクエリを生成して、チェーンメソッドで Where句やページネーションを追加します。

ページネーションについての仕組みについてわからなければ、以前このブログでエントリーをしているので、そちらを参照ください。

DBの操作について（一覧表示＆ページネーション）

また、クエリにwhere句をチェーンで繋げる箇所は

StudentController.php：
  //もしキーワードがあったら
  if(!empty($keyword))
  {
  $query->where('email','like','%'.$keyword.'%');
  $query->orWhere('name','like','%'.$keyword.'%');
  }
：

StudentController.php
1 2 3 4 5 6 7 8	`：` `//もしキーワードがあったら` `if(!empty($keyword))` `{` `$query->where('email','like','%'.$keyword.'%');` `$query->orWhere('name','like','%'.$keyword.'%');` `}` `：`