Laravel 6.x基于角色实现邮箱唯一性验证方案咨询

嘿，作为Laravel老玩家，刚好帮朋友处理过一模一样的需求——用Spatie权限包时让邮箱在同一角色下唯一，不同角色可以重复。结合Laravel 6.x的特性，给你两个靠谱的方案：

方案一：自定义验证规则（灵活适配多角色场景） #

如果你的用户可能拥有多个角色，或者不想动数据库结构，自定义验证规则是最稳妥的选择。

步骤1：生成自定义规则 #

在终端运行：

php artisan make:rule EmailUniqueForRole

步骤2：编写规则逻辑 #

打开app/Rules/EmailUniqueForRole.php，修改passes方法：

public function passes($attribute, $value)
{
    // 获取当前请求中的角色ID或角色名称（根据你的表单字段调整）
    $role = request()->input('role_id') ?? request()->input('role_name');
    
    // 如果是更新操作，排除当前用户ID
    $userId = request()->route('user')?->id ?? null;

    // 关联查询：检查该邮箱是否已被同一角色的用户占用
    return !DB::table('users')
        ->join('model_has_roles', 'users.id', '=', 'model_has_roles.model_id')
        ->join('roles', 'model_has_roles.role_id', '=', 'roles.id')
        ->where('users.email', $value)
        ->when(is_numeric($role), function($query) use ($role) {
            $query->where('roles.id', $role);
        }, function($query) use ($role) {
            $query->where('roles.name', $role);
        })
        ->when($userId, function($query) use ($userId) {
            $query->where('users.id', '!=', $userId);
        })
        ->exists();
}

// 自定义错误提示
public function message()
{
    return '该邮箱已被同一角色的用户使用，请更换邮箱。';
}

步骤3：在验证中使用规则 #

不管是在表单请求类还是控制器里，都可以这样用：

// 表单请求示例（app/Http/Requests/StoreUserRequest.php）
public function rules()
{
    return [
        'email' => ['required', 'email', new EmailUniqueForRole],
        'role_id' => ['required', 'exists:roles,id'],
        // 其他字段规则...
    ];
}

方案二：数据库联合索引 + 内置验证（适合单角色用户） #

如果你的系统里每个用户只拥有一个角色，可以给users表加个role_id字段，然后创建联合唯一索引，再配合Laravel内置的unique规则实现。

步骤1：添加role_id字段并创建联合索引 #

生成迁移文件：

php artisan make:migration add_role_id_to_users_table

打开迁移文件，编写逻辑：

public function up()
{
    Schema::table('users', function (Blueprint $table) {
        $table->unsignedBigInteger('role_id')->nullable()->after('email');
        $table->foreign('role_id')->references('id')->on('roles')->onDelete('set null');
        
        // 创建联合唯一索引：email + role_id 组合唯一
        $table->unique(['email', 'role_id']);
    });
}

public function down()
{
    Schema::table('users', function (Blueprint $table) {
        $table->dropForeign(['role_id']);
        $table->dropUnique(['email', 'role_id']);
        $table->dropColumn('role_id');
    });
}

运行迁移：

php artisan migrate

步骤2：使用内置unique规则 #

在验证时，给unique规则添加额外条件，指定role_id匹配当前请求的角色：

public function rules()
{
    $roleId = request()->input('role_id');
    $userId = request()->route('user')?->id;

    return [
        'email' => [
            'required',
            'email',
            Rule::unique('users')->where(function ($query) use ($roleId) {
                return $query->where('role_id', $roleId);
            })->ignore($userId)
        ],
        'role_id' => ['required', 'exists:roles,id'],
        // 其他字段规则...
    ];
}

小提示 #

• 如果用Spatie的多角色功能（一个用户多个角色），优先选方案一，因为方案二的单角色字段不适用。
• 测试更新场景时，别忘了排除当前用户，避免自己跟自己冲突。

内容的提问来源于stack exchange，提问作者Lb Abid