先生と生徒の会話形式で理解しよう

生徒

「Laravelで複数のルートに同じミドルウェアをまとめて適用する方法はありますか？」

先生

「はい、ルートグループを使うことで一括してミドルウェアを指定できます。」

生徒

「ルートグループって、どういうイメージですか？」

先生

「ルートグループは、複数の道路をまとめて一本の区画のように扱うイメージです。共通の条件（ミドルウェアやURLプレフィックス）を一度に適用できます。」

生徒

「なるほど、まとめて管理できるから便利そうですね！」

先生

「そうです。では具体的な書き方を見てみましょう。」

1. ルートグループでミドルウェアを指定する基本

Laravelでは、Route::group を使うことで複数のルートに共通の設定をまとめて適用できます。ミドルウェアを一括適用する場合もこの方法を使います。


Route::middleware(['auth'])->group(function () {
    Route::get('/dashboard', [DashboardController::class, 'index']);
    Route::get('/profile', [ProfileController::class, 'show']);
});

上記では auth ミドルウェアをグループ全体に適用しています。つまり /dashboard と /profile へのアクセス時は、ログインしていない場合リダイレクトされます。

2. 複数のミドルウェアを一括適用する

ミドルウェアは配列で複数指定できます。例えば、認証とアクセス制御を同時に行いたい場合は次のように書きます。


Route::middleware(['auth', 'verified'])->group(function () {
    Route::get('/dashboard', [DashboardController::class, 'index']);
    Route::get('/settings', [SettingsController::class, 'index']);
});

この例では、ログイン済みかつメール認証済みのユーザーのみがアクセス可能になります。配列で複数ミドルウェアを指定することで、ルートごとに個別に設定する手間を省けます。

3. URLプレフィックスと一緒に使う

ルートグループは、ミドルウェア以外にもURLプレフィックスや名前空間と組み合わせることができます。例えば管理者用ページをまとめて管理する場合は次のようにします。


Route::prefix('admin')
    ->middleware(['auth', 'admin'])
    ->group(function () {
        Route::get('/dashboard', [AdminDashboardController::class, 'index']);
        Route::get('/users', [AdminUserController::class, 'index']);
    });

この場合、URLは /admin/dashboard や /admin/users となり、auth と admin ミドルウェアが共通で適用されます。