Laravel 5.8 自定义用户表与认证字段配置问题及解决

问题描述 #

我正在开发Laravel 5.8应用，现有users_custom表存储用户数据，.env数据库配置正确可正常连接，但遇到两个认证相关的问题：

1. 想要将认证用户名字段从默认的email改为username，尝试在app/Http/Controllers/Auth/LoginController.php中重写方法后，始终收到错误提示："These credentials do not match our records."
2. 当前users_custom表中的密码采用旧MD5加密格式，需要兼容Laravel默认的哈希格式，且无需让用户重新设置密码。

补充信息：

• users_custom表结构：id（UNIQUE，int(5)）、username（varchar(100)）、password（varchar(100)）、passphrase（varchar(200)，供DialogFlow使用，Laravel无需访问），表中无email字段。
• 已在User模型中定义protected $table='users_custom';。

解决方案 #

一、自定义认证字段（从email改为username）

我已经找到正确的解决方式，无需自定义整个Auth控制器，直接使用默认的Auth控制器和User模型即可，只需两步：

1. 确保User模型中已正确指定自定义表名：

// app/User.php
protected $table = 'users_custom';

2. 在LoginController中添加username()方法，明确指定认证使用的字段：

// app/Http/Controllers/Auth/LoginController.php
public function username() {
    return 'username';
}

完成这两步后，Laravel就会使用username字段来进行用户认证，不再默认寻找email字段，之前的"These credentials do not match our records."错误也会消失。

二、兼容旧MD5密码

为了让Laravel既能验证旧的MD5密码，又能在用户登录后自动将密码更新为Laravel标准的哈希格式（避免后续一直依赖MD5），需要在User模型中重写validateCredentials方法：

// app/User.php
use Illuminate\Auth\Authenticatable;
use Illuminate\Contracts\Auth\Authenticatable as AuthenticatableContract;
use Illuminate\Support\Facades\Hash;

class User extends Model implements AuthenticatableContract
{
    use Authenticatable;

    protected $table = 'users_custom';

    /**
     * 重写验证凭证方法，兼容MD5密码
     */
    public function validateCredentials(\Illuminate\Contracts\Auth\Authenticatable $user, array $credentials)
    {
        $plainPassword = $credentials['password'];
        
        // 判断存储的密码是否为MD5格式（32位十六进制字符串）
        if (strlen($user->password) === 32 && ctype_xdigit($user->password)) {
            // 验证MD5密码
            if (md5($plainPassword) === $user->password) {
                // 自动将密码更新为Laravel哈希格式
                $user->password = Hash::make($plainPassword);
                $user->save();
                return true;
            }
            return false;
        }
        
        // 正常验证Laravel哈希密码
        return Hash::check($plainPassword, $user->password);
    }
}

这个方法的逻辑是：

• 当用户登录时，先检查数据库中存储的密码是否是MD5格式；
• 如果是，就用输入的密码生成MD5值和存储的值对比，验证通过后自动把密码更新为Laravel的哈希格式并保存；
• 如果不是MD5格式，就用Laravel默认的哈希验证方式。

这样设置后，用户完全不需要重新设置密码，第一次登录后密码就会自动升级为安全的哈希格式，后续登录也会使用标准验证流程。

内容的提问来源于stack exchange，提问作者Apoorv Pal