如何自定义 Laravel 中间件 'auth:api'？-php教程-PHP中文网

如何自定义 Laravel 中间件 'auth:api'？

聖光之護

发布： 2025-07-17 16:42:01

原创

872人浏览过

如何自定义 laravel 中间件 'auth:api'？

本文旨在指导开发者如何自定义 Laravel 框架中默认的 auth:api 中间件，以满足特定 API 认证需求，例如基于特定 Bearer Token 的验证。通过创建自定义中间件并修改 Kernel.php 文件，您可以轻松实现个性化的 API 认证逻辑。

在 Laravel 中，中间件是处理 HTTP 请求的强大机制，允许您在请求到达应用程序之前或之后执行特定操作。默认的 auth:api 中间件通常用于验证 API 请求的身份。然而，在某些情况下，您可能需要自定义此中间件以满足特定的认证需求，例如接受具有特定 Bearer Token 的请求。以下步骤将指导您如何实现这一目标。

1. 创建自定义中间件

首先，您需要创建一个新的中间件类，用于实现您的自定义认证逻辑。您可以使用 Artisan 命令 make:middleware 来生成中间件文件：

php artisan make:middleware CustomApiAuth

登录后复制

这将在 app/Http/Middleware 目录下创建一个名为 CustomApiAuth.php 的文件。

2. 实现自定义认证逻辑

打开 CustomApiAuth.php 文件，并修改 handle 方法以实现您的自定义认证逻辑。以下是一个示例，演示如何验证请求是否包含特定的 Bearer Token：

<?php

namespace App\Http\Middleware;

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

class CustomApiAuth
{
    /**
     * Handle an incoming request.
     *
     * @param  \Closure(\Illuminate\Http\Request): (\Symfony\Component\HttpFoundation\Response)  $next
     */
    public function handle(Request $request, Closure $next): Response
    {
        $token = $request->bearerToken();

        // 检查 Bearer Token 是否存在且与预期值匹配
        if (!$token || $token !== 'your_specific_bearer_token') {
            return response()->json(['message' => 'Unauthorized'], 401);
        }

        return $next($request);
    }
}

登录后复制

在上面的示例中，handle 方法首先获取请求的 Bearer Token。然后，它检查 Token 是否存在以及是否与预期的值（your_specific_bearer_token）匹配。如果 Token 无效，则返回一个 401 Unauthorized 响应。否则，请求将传递给下一个中间件。

3. 注册自定义中间件

百度文心百中

百度大模型语义搜索体验中心

查看详情

接下来，您需要在 app/Http/Kernel.php 文件中注册您的自定义中间件。找到 $routeMiddleware 数组，并将您的中间件添加到其中：

protected $routeMiddleware = [
    'auth' => \App\Http\Middleware\Authenticate::class,
    'auth.basic' => \Illuminate\Auth\Middleware\AuthenticateWithBasicAuth::class,
    'cache.headers' => \Illuminate\Http\Middleware\SetCacheHeaders::class,
    'can' => \Illuminate\Auth\Middleware\Authorize::class,
    'guest' => \App\Http\Middleware\RedirectIfAuthenticated::class,
    'throttle' => \Illuminate\Routing\Middleware\ThrottleRequests::class,
    'throttle:api' => \Illuminate\Routing\Middleware\ThrottleRequestsWithRedis::class,
    'verified' => \Illuminate\Auth\Middleware\EnsureEmailIsVerified::class,
    'custom.api.auth' => \App\Http\Middleware\CustomApiAuth::class, // 添加自定义中间件
];

登录后复制

请注意，您需要为您的中间件指定一个别名（例如，custom.api.auth）。

4. 应用自定义中间件

现在，您可以将您的自定义中间件应用于您的 API 路由。在 routes/api.php 文件中，使用 middleware 方法来应用您的中间件：

Route::middleware('custom.api.auth')->group(function () {
    // 您的 API 路由
    Route::get('/protected', function () {
        return response()->json(['message' => 'Authenticated']);
    });
});

登录后复制

这将确保只有通过您的自定义认证逻辑的请求才能访问 /protected 路由。

注意事项