Laravel双模型HasOne关联跨表认证：用Person的dni和User的密码登录

咱们先理清楚核心需求：用Person表的dni作为身份标识，搭配User表的password完成认证，且两张表是HasOne关联关系。下面分步骤实现：

1. 确保模型关联正确 #

假设你的关联逻辑是一个User对应一个Person（即User hasOne Person），先在User模型里定义关联：

// app/Models/User.php
public function person()
{
    return $this->hasOne(Person::class);
}

如果是一个Person对应一个User，就在Person模型里定义hasOne(User::class)，后续查询逻辑调整方向即可。

2. 重写登录控制器的认证逻辑 #

默认的LoginController（app/Http/Controllers/Auth/LoginController.php）是基于email+password认证的，咱们需要重写两个关键方法适配需求：

重写validateLogin方法 #

修改登录请求的验证规则，把默认的email替换成dni：

protected function validateLogin(Request $request)
{
    $request->validate([
        'dni' => 'required|string',
        'password' => 'required|string',
    ]);
}

重写attemptLogin方法 #

手动实现跨表查询与密码验证逻辑，这里以Person hasOne User的关联为例（如果是反向关联，调整查询方向即可）：

use Illuminate\Support\Facades\Hash;

protected function attemptLogin(Request $request)
{
    // 通过dni找到对应的Person，再关联到User
    $person = Person::where('dni', $request->dni)->first();
    
    if (!$person || !$person->user) {
        return false; // 找不到关联用户则认证失败
    }

    // 验证密码是否匹配
    if (Hash::check($request->password, $person->user->password)) {
        $this->guard()->login($person->user, $request->filled('remember'));
        return true;
    }

    return false;
}

3. 调整config/auth.php配置 #

默认配置不需要大幅修改，只需确保guard的提供者指向User模型即可：

// config/auth.php
'guards' => [
    'web' => [
        'driver' => 'session',
        'provider' => 'users',
    ],
],

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

4. 调整登录视图（可选） #

把登录表单里的email输入框改成dni，比如：

<!-- resources/views/auth/login.blade.php -->
<div class="form-group">
    <label for="dni">DNI</label>
    <input id="dni" type="text" class="form-control @error('dni') is-invalid @enderror" name="dni" value="{{ old('dni') }}" required autocomplete="dni" autofocus>
    @error('dni')
        <span class="invalid-feedback" role="alert">
            <strong>{{ $message }}</strong>
        </span>
    @enderror
</div>

这样整个认证流程就通了：用户输入dni和密码后，控制器会通过dni找到关联的User，验证密码匹配后完成登录。

内容的提问来源于stack exchange，提问作者gerson hoyle