Laravel 8：实现路由多重认证（OR逻辑）的正确姿势-php教程-PHP中文网

Laravel 8：实现路由多重认证（OR逻辑）的正确姿势

心靈之曲

发布： 2025-10-14 10:15:00

原创

462人浏览过

Laravel 8：实现路由多重认证（OR逻辑）的正确姿势

本文旨在解决laravel 路由配置中实现多重认证“或”逻辑的常见问题。当开发者希望用户能通过多种认证方式（如sanctum或basic认证）中的任意一种访问资源时，直接将多个认证中间件链式调用会导致“与”逻辑。正确的解决方案是利用laravel的认证守卫（guards）机制，通过在路由中间件中指定多个守卫，从而实现灵活的“或”逻辑认证。

在Laravel应用开发中，为路由添加认证保护是常见的需求。然而，当需要支持多种认证方式，并且希望用户只需通过其中任意一种即可访问时，很多开发者可能会遇到困惑。例如，同时支持API令牌认证（如Sanctum）和HTTP Basic认证，并希望用户使用其中任何一种凭证都能成功登录。

理解问题：中间件与认证守卫的默认行为

Laravel的路由中间件链式调用默认采用“与”逻辑。这意味着，如果在一个路由组中定义了多个中间件，例如：

Route::group(['middleware' => ['auth:sanctum', 'auth.basic.once']], function () {
   Route::get('/images', [ImageController::class, 'index']);
});

登录后复制

上述配置会要求请求必须同时通过 auth:sanctum 和 auth.basic.once 这两个认证中间件的验证才能访问 /images 路由。这与我们期望的“或”逻辑（即通过 sanctum 或 auth.basic.once 任意一个即可）相悖。

尝试使用 | 符号来表示“或”逻辑，如 ['middleware' =youjiankuohaophpcn ['auth:sanctum|auth.basic.once']] 或 ['middleware' => 'auth:sanctum|auth.basic.once']，在Laravel的中间件定义中是无效的语法，并不能实现预期的效果。

解决方案：利用Laravel的认证守卫（Guards）

Laravel的认证系统设计允许定义多种认证守卫（Guards），每个守卫负责一种特定的认证机制。当我们需要实现“或”逻辑的多重认证时，正确的做法是将不同的认证机制配置为独立的守卫，并在路由中间件中指定这些守卫。

auth 中间件本身支持接收一个逗号分隔的守卫列表。当提供多个守卫时，auth 中间件会尝试使用列表中的任何一个守卫进行认证。只要其中一个守卫成功认证了用户，请求就会被允许通过，从而实现了“或”逻辑。

步骤一：确保认证机制已配置为守卫

如果 auth.basic.once 是一个自定义的中间件，并且其目的是作为一种独立的认证机制，那么它应该被重构或注册为一个自定义的认证守卫。Laravel的认证守卫通常在 config/auth.php 中定义。例如，如果 auth.basic.once 对应的是一个名为 basic 的守卫，那么 config/auth.php 中可能会有类似如下的配置：

降重鸟

要想效果好，就用降重鸟。AI改写智能降低AIGC率和重复率。

113

查看详情

// config/auth.php
'guards' => [
    'web' => [
        'driver' => 'session',
        'provider' => 'users',
    ],
    'sanctum' => [
        'driver' => 'sanctum',
        'provider' => 'users',
    ],
    'basic' => [ // 假设这是你的HTTP Basic认证守卫
        'driver' => 'basic', // 或自定义的驱动
        'provider' => 'users',
    ],
],

'providers' => [
    'users' => [
        'driver' => 'eloquent',
        'model' => App\Models\User::class,
    ],
    // ...
],

登录后复制

关于如何添加自定义守卫，可以查阅Laravel官方文档中关于“添加自定义守卫”的部分：Laravel Authentication - Adding Custom Guards。

步骤二：在路由中指定多个守卫

一旦你的认证机制（如Sanctum和HTTP Basic）都已作为独立的守卫（例如 sanctum 和 basic）正确配置，你就可以在路由定义中使用逗号分隔的方式来指定它们：

Route::group(['middleware' => 'auth:sanctum,basic'], function () {
   Route::get('/images', [ImageController::class, 'index']);
});

登录后复制

代码示例：

<?php

use App\Http\Controllers\ImageController;
use Illuminate\Support\Facades\Route;

/*
|--------------------------------------------------------------------------
| API Routes
|--------------------------------------------------------------------------
|
| Here is where you can register API routes for your application. These
| routes are loaded by the RouteServiceProvider within a group which
| is assigned the "api" middleware group. Enjoy building your API!
|
*/

// 此路由组要求用户通过 'sanctum' 或 'basic' 任意一种方式认证成功
Route::group(['middleware' => 'auth:sanctum,basic'], function () {
   Route::get('/images', [ImageController::class, 'index']);
});

// 其他API路由...

登录后复制

通过这种方式，当请求到达 /images 路由时，Laravel的认证中间件会尝试使用 sanctum 守卫进行认证。如果 sanctum 认证失败，它会接着尝试使用 basic 守卫进行认证。只要其中任何一个守卫成功认证了用户，请求就会被允许继续执行，从而完美实现了多重认证的“或”逻辑。

总结

实现Laravel路由的多重认证“或”逻辑，关键在于理解并正确使用认证守卫（Guards）。避免将不同的认证机制直接作为独立的中间件链式调用，因为这会导致“与”逻辑。相反，将每种认证机制配置为独立的守卫，然后在 auth 中间件中以逗号分隔的形式指定这些守卫，是实现灵活“或”逻辑认证的最佳实践。这不仅使认证配置更加清晰，也符合Laravel认证系统的设计哲学。

以上就是Laravel 8：实现路由多重认证（OR逻辑）的正确姿势的详细内容，更多请关注php中文网其它相关文章！