Laravel Guard配置咨询：用户与管理员认证方案选择及实现

一、基于users表实现双Guard的配置方法 #

如果你的管理员是拥有特殊权限的普通用户（即管理员账号本质属于users表，只是关联了额外的管理员数据），可以通过以下步骤实现双Guard共用users表认证：

1. 模型关联与权限判断 #

在App\Models\User模型中添加与admins表的关联，并实现管理员权限判断方法：

class User extends Authenticatable
{
    // 关联管理员专属数据
    public function admin()
    {
        return $this->hasOne(Admin::class);
    }

    // 判断是否为管理员
    public function isAdmin()
    {
        return !is_null($this->admin);
    }
}

2. 配置Auth Guard #

修改config/auth.php，新增admin guard，指定使用users数据提供者：

'guards' => [
    'web' => [
        'driver' => 'session',
        'provider' => 'users',
    ],
    'admin' => [
        'driver' => 'session',
        'provider' => 'users',
    ],
],

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

3. 实现管理员登录逻辑 #

创建AdminLoginController，在登录时验证用户凭证并检查管理员权限：

public function login(Request $request)
{
    $credentials = $request->validate([
        'email' => 'required|email',
        'password' => 'required',
    ]);

    // 使用admin guard验证凭证
    if (Auth::guard('admin')->attempt($credentials)) {
        $user = Auth::guard('admin')->user();
        
        // 检查是否关联管理员数据
        if (!$user->isAdmin()) {
            Auth::guard('admin')->logout();
            return back()->withErrors(['email' => '无管理员权限']);
        }

        $request->session()->regenerate();
        return redirect()->intended('/admin/dashboard');
    }

    return back()->withErrors(['email' => '登录凭证无效']);
}

4. 路由与中间件使用 #

管理员路由使用auth:admin中间件，普通用户路由使用默认的auth（即auth:web）：

// 管理员路由
Route::prefix('admin')->middleware('auth:admin')->group(function () {
    Route::get('/dashboard', [AdminController::class, 'dashboard']);
});

// 普通用户路由
Route::middleware('auth')->group(function () {
    Route::get('/profile', [UserController::class, 'profile']);
});

二、完全分离：管理员通过admins表认证的方案 #

如果管理员属于独立的身份体系（与普通用户无直接关联，如企业内部管理账号），分离认证表是更清晰的选择：

1. 配置Auth Guard与数据提供者 #

修改config/auth.php，为管理员单独配置guard和provider：

'guards' => [
    'web' => [
        'driver' => 'session',
        'provider' => 'users',
    ],
    'admin' => [
        'driver' => 'session',
        'provider' => 'admins',
    ],
],

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

2. 模型与表结构 #

创建App\Models\Admin模型，admins表需包含认证所需字段（如email、password），若需关联普通用户数据可添加user_id外键：

class Admin extends Authenticatable
{
    // 若需关联用户数据
    public function user()
    {
        return $this->belongsTo(User::class);
    }
}

三、方案选型对比 #

选型建议 #

• 若管理员是普通用户的权限升级，优先选择共用users表方案，配合角色/权限系统（如在users表加role字段）会比关联admins表更灵活。
• 若管理员与普通用户属于完全独立的身份体系，选择分离admins表方案，数据隔离更安全，后续维护更清晰。

内容的提问来源于stack exchange，提问作者Sergei Semenets