Laravelのルーティングにカスタムミドルウェアをネームで登録する方法

1. カスタムミドルウェアを作成する

1. カスタムミドルウェアを作成する

まずは自分でカスタムミドルウェアを作ります。ターミナルで以下のコマンドを実行します。

php artisan make:middleware CheckRole

これで app/Http/Middleware/CheckRole.php が作成されます。このファイル内でユーザーの権限チェックなどの処理を書きます。

namespace App\Http\Middleware;

use Closure;
use Illuminate\Http\Request;

class CheckRole
{
    public function handle(Request $request, Closure $next, $role)
    {
        if (! $request->user() || $request->user()->role !== $role) {
            abort(403, 'アクセスが禁止されています');
        }

        return $next($request);
    }
}

2. ミドルウェアに名前をつけて登録する

2. ミドルウェアに名前をつけて登録する

作成したミドルウェアを名前でルートに登録するには、app/Http/Kernel.php の $routeMiddleware 配列に追加します。

protected $routeMiddleware = [
    'auth' => \App\Http\Middleware\Authenticate::class,
    'role' => \App\Http\Middleware\CheckRole::class, // 名前登録
];

この例では、CheckRole ミドルウェアを 'role' という名前で登録しています。

3. ルートで名前を使ってミドルウェアを呼び出す

3. ルートで名前を使ってミドルウェアを呼び出す

ルート定義でミドルウェア名を使うと、登録したカスタムミドルウェアが適用されます。例えば、管理者専用ページの場合は以下のように書きます。

use Illuminate\Support\Facades\Route;

Route::get('/admin', function () {
    return '管理者専用ページです';
})->middleware('role:admin');

ここで 'role:admin' と書くことで、CheckRole ミドルウェアが呼ばれ、ユーザーのロールが admin かどうかチェックされます。

4. 複数ミドルウェアの組み合わせ

4. 複数ミドルウェアの組み合わせ

ルートに複数のミドルウェアを適用することもできます。配列で指定するだけです。

Route::get('/dashboard', function () {
    return 'ダッシュボードページ';
})->middleware(['auth', 'role:editor']);

これで、まず認証が行われ、その後に権限チェックが実行されます。順序も Laravel が正しく処理してくれます。

5. ネーム登録のメリット

5. ネーム登録のメリット

• コードがシンプルで読みやすくなる
• 複数のルートで同じミドルウェアを簡単に使える
• パラメータ付きミドルウェアも柔軟に適用できる
• ミドルウェアの切り替えや変更も Kernel.php で一元管理できる

6. 注意点

6. 注意点

• ネーム登録したミドルウェア名はユニークにする
• ミドルウェアの順序によって処理が変わる場合があるため、依存関係を意識する
• テスト環境で必ず動作確認を行う

7. 実践的な使い方

7. 実践的な使い方

例えば、ブログサイトで投稿編集ページにアクセスする場合、ログインしているユーザーで、さらに編集権限を持つユーザーだけがアクセスできるように設定できます。

Route::get('/post/edit/{id}', function ($id) {
    return "投稿ID {$id} の編集ページ";
})->middleware(['auth', 'role:editor']);

これで未ログインユーザーや編集権限のないユーザーはアクセスできず、セキュアな運用が可能です。