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

生徒

「Laravelでルートに中間処理ってどうやって追加するんですか？よくミドルウェアって聞くんですが…」

先生

「ミドルウェアは、ルートにアクセスする前後に実行される特別な処理のことです。例えば、ログインチェックやアクセス制限などの中間処理を挟みたいときに使います。」

生徒

「中間処理って具体的にはどういうことなんでしょうか？」

先生

「イメージとしては、ルートにたどり着く前にチェックポイントがあって、通っていいかどうか判断したり、処理を追加したりする感じですね。では、Laravelでの使い方を詳しく説明します！」

1. ミドルウェアとは？

ミドルウェアとは、Laravelのルート処理の前後に挟むことができる「中間処理」のことです。英語の「middleware」は「中間のソフトウェア」という意味で、Laravelでは「ルートの処理をする前後に実行するプログラム」と覚えるとわかりやすいです。

例えば、サイトにアクセスしたユーザーが「ログインしているか」をチェックしたり、「アクセス権限があるか」を確かめたりすることに使います。

2. なぜミドルウェアを使うの？

ルートに中間処理を追加することで、同じ処理を何度も書かなくて済み、コードがすっきりします。また、セキュリティ強化や処理の共通化ができるので、アプリケーションの品質が上がります。

例えば、ログインしていない人を特定のページに入れさせたくない場合、毎回ログインチェックのコードを書くのは大変ですよね。そこでミドルウェアを使えば、ルートにまとめてチェックを設定できます。

3. Laravelに標準である主なミドルウェアの例

auth：ユーザーがログインしているか確認する
guest：ログインしていないユーザー専用のページに使う
throttle：アクセスの回数制限をかける
verified：メールアドレスが認証済みかチェックする

これらはLaravelにあらかじめ用意されている便利なミドルウェアです。

4. ミドルウェアの登録と確認

ミドルウェアは、app/Http/Kernel.phpというファイルに登録されています。ここで使いたいミドルウェアを確認できます。

例えば、authミドルウェアは次のように登録されています。


protected $routeMiddleware = [
    'auth' => \App\Http\Middleware\Authenticate::class,
    // 他のミドルウェアもここに登録
];

この名前（ここでは'auth'）をルートで指定して使います。

5. ルートにミドルウェアを追加する方法

ルートにミドルウェアを設定するには、ルート定義でmiddlewareメソッドを使います。

例：ログインしている人だけがアクセスできるルート


Route::get('/dashboard', function () {
    return 'ログインユーザーのダッシュボード';
})->middleware('auth');

ここで->middleware('auth')をつけることで、このルートにアクセスするときに「auth」ミドルウェアが先に動き、ログインしていなければログインページにリダイレクトされます。

6. 複数のルートに一括でミドルウェアを設定する方法

似たようなルートがたくさんあって、それぞれに同じミドルウェアを設定したい場合は、Route::groupを使うと便利です。


Route::middleware(['auth'])->group(function () {
    Route::get('/profile', function () {
        return 'プロフィールページ';
    });
    Route::get('/settings', function () {
        return '設定ページ';
    });
});

こうすると、グループ内のルートすべてに「auth」ミドルウェアが適用されます。

7. 自分でミドルウェアを作る方法（簡単な例）

Laravelでは、自分専用のミドルウェアを作ることもできます。例えば、アクセス時間を制限するミドルウェアを作ってみましょう。

まず、コマンドで作成します。


php artisan make:middleware CheckAccessTime

作成されたファイルはapp/Http/Middleware/CheckAccessTime.phpです。中身を少し書き換えます。


<?php

namespace App\Http\Middleware;

use Closure;
use Illuminate\Http\Request;

class CheckAccessTime
{
    public function handle(Request $request, Closure $next)
    {
        $hour = date('H');

        if ($hour < 9 || $hour > 17) {
            return response('アクセス時間外です。9時から17時の間にアクセスしてください。');
        }

        return $next($request);
    }
}

この例では、午前9時から午後5時以外はアクセスを拒否します。$next($request)は「次の処理に進む」という意味です。

作ったミドルウェアは、先ほどのapp/Http/Kernel.phpに登録しましょう。


protected $routeMiddleware = [
    // 既存のミドルウェア
    'check.time' => \App\Http\Middleware\CheckAccessTime::class,
];

そして、ルートに適用します。


Route::get('/time-restricted', function () {
    return '時間制限付きページです';
})->middleware('check.time');

8. ポイント整理！

ミドルウェアはルート処理の前後に実行される中間処理
ログイン認証やアクセス制限などに便利
Laravelには標準で便利なミドルウェアが用意されている
ルートに->middleware('ミドルウェア名')で設定できる
複数ルートにまとめて設定するにはRoute::groupを使う
自作のミドルウェアも簡単に作成・登録できる

まとめ

Laravelのミドルウェアは、アプリケーションの「入口」にあたるルートへ到達する前後で自由に処理を差し込める、とても柔軟で便利な仕組みです。今回の記事で学んだように、ミドルウェアはアクセス制御やログインチェック、時間帯制限、権限の検証、アクセス回数の制限など、さまざまな役割を担うことができます。これらは大規模な開発だけでなく、シンプルな個人制作のアプリケーションでも役立つため、基礎として覚えておくと長く使える知識になります。

特にLaravelはミドルウェアを簡潔に設定できるように設計されており、ルートの横に->middleware('auth')のようにひとこと添えるだけで処理を自動的に通過させる仕組みが整っています。複数ルートへ一括適用できるRoute::middleware()->group()の構文は、重複したコードを大幅に減らす効果があり、可読性や管理のしやすさを確保するうえでも大きな助けとなります。また、Laravel標準で用意されているauth・guest・throttleなどのミドルウェアは、日常のWebアプリ制作で必ず役に立つ機能が揃っており、まずはこれらを使いこなすことが第一歩です。

さらに、Laravelでは自作ミドルウェアを作ることも可能で、アプリに合わせた独自の制御を加えることができます。例えば、特定の時間帯だけアクセス可能にする、特定のユーザー権限のみ許可する、ログを常に記録する、リクエストの内容をチェックするなど、自由な発想で中間処理を組み込めます。実際にコマンドでミドルウェアを生成し、Kernelへの登録を経てルートに適用する流れを理解しておけば、多様な状況に柔軟に対応できます。

また、ミドルウェアはアプリの安全性を高める役割も担っています。特に重要なページへアクセスさせるとき、ログインしているかどうかを確かめるauthミドルウェアは必須と言えるほどよく使われます。意図しないアクセスや、外部からの不正なリクエストを防ぎ、ページごとの制御を適切に行えることが、ミドルウェアの大きな強みです。

下記に、これまで学んだ内容を踏まえたシンプルなミドルウェア活用の例を掲載します。ルートに付与する書き方、自作ミドルウェアの適用例、グループ化したミドルウェアのサンプルをまとめています。

ミドルウェア活用のサンプルコード


use Illuminate\Support\Facades\Route;

// 標準ミドルウェアauthを使った例
Route::get('/dashboard', function () {
    return 'ようこそ、ダッシュボードへ';
})->middleware('auth');

// ミドルウェアをグループ化して適用
Route::middleware(['auth'])->group(function () {
    Route::get('/account', function () { return 'アカウントページ'; });
    Route::get('/settings', function () { return '設定ページ'; });
});

// 自作ミドルウェアcheck.timeを適用
Route::get('/business-hours', function () {
    return '営業時間内のみ閲覧できます';
})->middleware('check.time');

このように、Laravelのミドルウェアは「ルートに入る前のチェックポイント」として柔軟に使える強力な仕組みです。アクセス状況を判断したり、ユーザーの状態を確認したり、時間で制限したり、役割に応じて中間処理を設計すれば、より安全で整理されたWebアプリケーションへ近づきます。ミドルウェアを理解することは、Laravelを深く扱ううえで欠かせない大切なステップです。ぜひ実際のプロジェクトで活用し、その便利さを体感してみてください。

先生と生徒の振り返り会話

生徒

「ミドルウェアって名前だけ聞くと難しそうでしたが、ルートの前に置くチェックみたいな感じなんですね。理解しやすくて安心しました！」

先生

「そのとおりです。難しい印象がありますが、実は構造はとてもシンプルなんです。Laravelが使いやすいように区分してくれているので、まずは標準のauthなどから慣れるのが良いでしょう。」

生徒

「Route::middleware()->group()が便利なのも驚きました。同じ処理を何回も書かなくて済むのは大きいですね。」

先生

「そうですね。コードの量が減るだけでなく、管理がとても楽になります。あとで見返したときにも整理されている方が安心できますし、バグも防ぎやすいんですよ。」

生徒

「自作ミドルウェアの例もわかりやすかったです。時間帯で制限したり、ユーザーの権限を確認したり、応用できる場面が多そうですね。」

先生