ミドルウェアについて

今回はミドルウェアについてエントリーします。

 

ミドルウェアについて

リクエスト時とかレスポンス時にフィルタリングとしての機能をミドルウェアといいます。

例えばログインしていないと実行出来ないように制限をかけたい場合(認証チェック)などでミドルウェアの機能を利用します。

 

ミドルウェアの作成手順

【1】artisanコマンドでミドルウェアのスケルトンを生成

【2】ミドルウェアの編集

【3】ミドルウェアの登録

【4】ミドルウェアの設定

 

【1】artisanコマンドでミドルウェアのスケルトンを生成

artisanコマンドでミドルウェアのスケルトンを生成することができます。

php artisan make:middleware MyMiddleware

上記のコマンドでapp/Http/Middleware/MyMiddleware.phpが生成されます。

ちなみにLaravel5.2ではデフォルトで4つのミドルウェアがすでに用意されています。

 

【2】ミドルウェアの編集

artisanコマンドで作成したミドルウェアのクラスにはhandleメソッドがあります。

ここでミドルウェアで処理をするプログラムを記載します。

構文

<?php
namespace App\Http\Middleware;

use Closure;

class MyMiddleware {

  public function handle($request, Closure $next)
  {
    // ここに処理を記述します。

    return $next($request); #(1)
  }

}

 

【3】ミドルウェアの登録

ミドルウェアを作っただけでは使えません。

/app/Http/Kernel.php でミドルウェアを登録する必要があります。

ミドルウェアを登録するポイントは3つあります。

・全ての処理に共通して処理を行う場合・・・$middleware に登録します。

・複数のミドルウェアをまとめて(グループ)登録する場合・・・$middlewareGroups に登録します。

・単体で使うミドルウェアを登録しておく場合・・・$routeMiddleware にキーと共に登録します。

 

全ての処理に共通して処理を行う場合

protected $middleware = [
  \Illuminate\Foundation\Http\Middleware\CheckForMaintenanceMode::class,
  Middleware\OneMiddleware::class,
  Middleware\TwoMiddleware::class,
];

 

複数のミドルウェアをまとめて(グループ)登録する場合

protected $middlewareGroups = [
    'num' => [
      Middleware\ThreeMiddleware::class,
      Middleware\ForeMiddleware::class,
    ]
];

 

単体で使うミドルウェアを登録しておく場合

protected $routeMiddleware = [
  'five' => Middleware\FiveMiddleware::class,
  'six' => Middleware\SixMiddleware::class,
];

 

【4】ミドルウェアの設定

ミドルウェアの設定は主に二つやり方があります。

（1）ルーターでミドルウェアを使用する
（2）コントローラでミドルウェアを使用する

 

（1）ルーターでミドルウェアを使用する

ルータでミドルウェアを使用する場合は

１）普通に指定する
２）ミドルウェアを複数指定する
３）グループで指定する

の３つやり方があります。

１）普通に指定する

Route::get('admin/profile', ['middleware' => 'auth', function () {
  // 実行したい処理を記述
}]);

 

２）ミドルウェアを複数指定する

Route::get('/', ['middleware' => ['first', 'second'], function () {
  // 実行したい処理を記述
}]);

 

３）グループで指定する

<?php
Route::group(['middleware' => ['num']], function () {
    // 実行したい処理を記述
});

 

（2）コントローラでミドルウェアを使用する

<?php
namespace App\Http\Controllers;

...

class ArticlesController extends Controller {
  public function __construct()
  {
  $this->middleware('auth', ['except' => ['index', 'show']]);
  }
  ...
}

Laravel5.2におけるミドルウェアについては以上です。

 

-実践知識