【Laravel】ミドルウェアでリクエスト処理を共通化する方法

当ページのリンクには広告が含まれています。
いずみ

こんな悩みを解決できる記事を書きました!

僕は現役フリーランスエンジニア(歴年)で、資格は個保有しています。

Laravelで認証チェックやログ記録などの処理を、複数のコントローラーに書かずに共通化したい」とお考えではありませんか?

Laravelのコントローラーに認証チェックやロギング処理を毎回書いていると、コードが重複しやすくなります。

ミドルウェアを使えば、リクエストとレスポンスの間に共通処理を差し込んで、コントローラーをシンプルに保つことが可能です。

いずみ

サクッと解説していきます。

ということで、本記事ではLaravelでミドルウェアを実装する方法を解説します。

スクロールできます
【当サイト】おすすめフリーランスエージェント3選
エージェント評価ポイント公式サイト
レバテックフリーランス

5.0
業界最大級のエージェント。
高単価案件が豊富。
公式
Midworks

4.8
満足度調査で
3年連続3冠を達成。
公式
ITプロパートナーズ

4.6
週2〜3向けの案件が豊富。公式
執筆者/監修者
  • フリーランスエンジニア(保有資格個、企業と直接契約
  • ブログ・アフィリエイト歴7年(2018年〜)
  • ブランドせどりで月利50万円⇨脱サラ
  • 投資(仮想通貨・FX)歴7年(2018年〜)
  • X(旧Twitter)フォロワー約1,900人
  • 運営者情報はこちら
いずみです
目次

【Laravel】ミドルウェアでリクエスト処理を共通化する方法

早速ですが、Laravelでミドルウェアを実装する方法を解説します。

ミドルウェアとは何か

ミドルウェアは、HTTPリクエストがコントローラーに届く前、またはレスポンスがブラウザに返る前に処理を差し込む仕組みです。

認証チェック、ログ記録、CORSの設定など、複数のルートで共通して必要になる処理を1箇所にまとめられます。

いずみ

認証まわりの処理をコントローラーに毎回書くと、後で修正が大変になりますよね。

ミドルウェアを作成する

まずは、Artisanコマンドでミドルウェアの雛形を作成します。

STEP
Artisanコマンドで雛形を作成する

以下のコマンドを実行すると、app/Http/Middlewareディレクトリにクラスが生成されます。

php artisan make:middleware EnsureUserIsAdmin
STEP
handleメソッドに処理を実装する

生成されたクラスのhandleメソッドに、実際の処理を書きます。

<?php

namespace App\Http\Middleware;

use Closure;
use Illuminate\Http\Request;
use Symfony\Component\HttpFoundation\Response;

class EnsureUserIsAdmin
{
    public function handle(Request $request, Closure $next): Response
    {
        if (! $request->user() || ! $request->user()->is_admin) {
            abort(403, '権限がありません。');
        }

        return $next($request);
    }
}

管理者以外のアクセスを403エラーで拒否する処理を実装しました。

いずみ

条件を満たさない場合はabortで処理を止め、満たす場合は$next($request)で後続の処理に進めます。

ミドルウェアを登録して適用する

作成したミドルウェアは、そのままではルートに適用できません。

bootstrap/app.phpでエイリアスを登録してから、ルートやコントローラーで指定します。

STEP
bootstrap/app.phpでエイリアスを登録する

withMiddlewareメソッドの中でaliasメソッドを呼び出し、短い名前をミドルウェアクラスに紐づけます。

use App\Http\Middleware\EnsureUserIsAdmin;
use Illuminate\Foundation\Configuration\Middleware;

return Application::configure(basePath: dirname(__DIR__))
    ->withMiddleware(function (Middleware $middleware) {
        $middleware->alias([
            'admin' => EnsureUserIsAdmin::class,
        ]);
    })
    ->create();
STEP
ルートにミドルウェアを適用する

登録したエイリアス名を、middlewareメソッドに渡します。

Route::get('/admin/dashboard', [DashboardController::class, 'index'])
    ->middleware('admin');
いずみ

adminというエイリアス名でルートに適用できるようになりました。

グローバルミドルウェアとして登録する方法

全リクエストに対して処理を実行したい場合は、グローバルミドルウェアとして登録します。

withMiddlewareメソッドのappendメソッドを使うと、ミドルウェアスタックの末尾に追加されます。

use App\Http\Middleware\LogRequestMiddleware;
use Illuminate\Foundation\Configuration\Middleware;

return Application::configure(basePath: dirname(__DIR__))
    ->withMiddleware(function (Middleware $middleware) {
        $middleware->append(LogRequestMiddleware::class);
    })
    ->create();

ログ記録のように、特定のルートに限定せず常に実行したい処理は、グローバルミドルウェアとして登録するのが向いています。

スクロールできます
【当サイト】おすすめフリーランスエージェント3選
エージェント評価ポイント公式サイト
レバテックフリーランス

5.0
業界最大級のエージェント。
高単価案件が豊富。
公式
Midworks

4.8
満足度調査で
3年連続3冠を達成。
公式
ITプロパートナーズ

4.6
週2〜3向けの案件が豊富。公式

【厳選】フリーランスエンジニアにおすすめなエージェント3選

フリーランスエンジニアになるにはエージェントから案件をもらう必要があります。

僕が実際に利用しているおすすめエージェントを紹介しますね。

いずみ

エージェントは必ず複数登録してください。

担当者によっては「全然案件紹介してくれない…」みたいなこともあるので…

僕は実際に5つのエージェントを使い回していますよ。

フリーランスを始めるなら「

案件数マージン率単価
約88,000件非公開
初心者福利厚生申し込み
無料
Good Point
  • 業界最大級の案件数。
  • 業界トップクラスの高単価報酬、低マージン(平均年収862万円)。
  • 案件参画中のフォローの充実。

※詳細は「【業界最大手】レバテックフリーランスとは?メリットや利用手順を解説!」を参照。

は業界最大手のフリーランスエージェントです。

とにかく案件数が多いので、とりあえず登録しておけば間違いないエージェントです!

いずみ

僕もはじめてフリーランスの案件を貰ったのはです。

保有している案件数が多いので、業務経験がなくても何かしらの案件は紹介してもらえますよ(僕はJavaの経験3年でも案件を貰えました)。

手厚い保障を重視したいなら「

案件数マージン率単価
約10,000件非公開
初心者福利厚生申し込み
無料
Good Point
  • 手厚い保障で正社員並みの安心感。
  • 還元率60%超え&単価公開でクリアな契約。
  • 給与保障制度(審査あり)。

は手厚い保障が特徴のフリーランスエージェントです。

フリーランスを目指しているけど不安な方や保障を重視したい方におすすめです。

いずみ

僕も何度か案件を紹介してもらいました。

自分のスキルに合った案件を紹介してもらえましたし、電話のやり取りも非常に丁寧でした。

週2〜3日の案件探しなら「

案件数マージン率単価
約5,000件非公開
初心者福利厚生申し込み
経験者向け無料
Good Point
  • IT案件に特化したフリーランスエージェント。
  • 週2〜3日の案件が豊富。
  • リモート案件が多く、直エンドなので単価も高い。

※詳細は「【週2・3案件】ITプロパートナーズとは?メリットや利用手順を解説!」を参照。

はIT案件に特化したフリーランスエージェントです。

週2〜3日から参画できる案件が豊富なので、起業したい人にもおすすめです。

いずみ

週2〜3日の案件はある程度スキルがないと紹介してもらえない印象です。

とはいえ、週5の案件ももちろんありますし、僕が利用した時は迅速・丁寧に対応していただきました!

よくある質問

ミドルウェアはどこに配置すればいいですか?

app/Http/Middlewareディレクトリに配置するのが標準です。

Artisanコマンドのmake:middlewareを実行すると、自動的に同ディレクトリへクラスが生成されます。

複数のミドルウェアを組み合わせて使えますか?

middlewareメソッドに配列でエイリアス名を渡すと、複数のミドルウェアを順番に適用できます。

Route::get('/admin/dashboard', [DashboardController::class, 'index'])
    ->middleware(['auth', 'admin']);

ミドルウェアの実行順序はどう決まりますか?

グローバルミドルウェアは、bootstrap/app.phpに登録した順番で実行されます。

ルートミドルウェアは、middlewareメソッドに渡した配列の順番で実行されます。

まとめ

今回は、Laravelでミドルウェアを実装する方法について解説しました。

以下が本記事のまとめになります。

まとめ
  • Artisanコマンドのmake:middlewareで雛形を作成し、handleメソッドに処理を書く。
  • bootstrap/app.phpのwithMiddlewareでエイリアスを登録すると、ルートに指定できる。
  • 全リクエストに適用したい処理は、appendメソッドでグローバルミドルウェアとして登録する。
まとめ
  • おすすめ本
¥2,673 (2023/07/23 15:53時点 | Amazon調べ)
\楽天ポイント4倍セール!/
楽天市場

Laravelの勉強なら「」が分かりやすくておすすめですよ♪

いずみ

最後までお読みいただき、ありがとうございました!

スクロールできます
【当サイト】おすすめフリーランスエージェント3選
エージェント評価ポイント公式サイト
レバテックフリーランス

5.0
業界最大級のエージェント。
高単価案件が豊富。
公式
Midworks

4.8
満足度調査で
3年連続3冠を達成。
公式
ITプロパートナーズ

4.6
週2〜3向けの案件が豊富。公式
  • クソおすすめ本
¥4,480 (2024/06/01 23:28時点 | Amazon調べ)
\楽天ポイント4倍セール!/
楽天市場
いずみ

海外のエンジニアがどういった思考で働いているかが理解できます。

海外に行く気はないけど海外エンジニアの動向が気になる雑魚エンジニアにおすすめです(本当におすすめな本しか紹介しないのでご安心を)。

この記事が気に入ったら
フォローしてね!

シェアしてね!
  • URLをコピーしました!
目次