如何以更符合CakePHP风格重构单表多用户类型，支持多角色？

我来帮你一步步完成这个重构，从数据库结构调整到CakePHP模型配置都安排得明明白白：

1. 数据库结构调整 #

我们需要新增两张表实现多角色关联，同时移除原my_users表的role字段：

1.1 创建roles表 #

用来存储所有角色类型（fighter、referee、manager）：

CREATE TABLE roles (
    id INT AUTO_INCREMENT PRIMARY KEY,
    name VARCHAR(50) NOT NULL UNIQUE, -- 存储角色标识：'fighter'/'referee'/'manager'
    display_name VARCHAR(100) NULL, -- 可选，用于前端展示的友好名称
    created DATETIME DEFAULT CURRENT_TIMESTAMP,
    modified DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP
);

-- 插入初始角色数据
INSERT INTO roles (name, display_name) VALUES
('fighter', '格斗者'),
('referee', '裁判'),
('manager', '管理员');

1.2 创建user_roles关联表（多对多中间表） #

用来关联用户与角色，实现一个用户对应多个角色：

CREATE TABLE user_roles (
    id INT AUTO_INCREMENT PRIMARY KEY,
    user_id INT NOT NULL,
    role_id INT NOT NULL,
    created DATETIME DEFAULT CURRENT_TIMESTAMP,
    FOREIGN KEY (user_id) REFERENCES my_users(id) ON DELETE CASCADE,
    FOREIGN KEY (role_id) REFERENCES roles(id) ON DELETE CASCADE,
    UNIQUE KEY unique_user_role (user_id, role_id) -- 避免同一用户重复绑定同一角色
);

1.3 删除原my_users表的role列 #

ALTER TABLE my_users DROP COLUMN role;

2. CakePHP模型配置 #

接下来创建对应模型并配置关联关系，适配你使用的CakeDC Users插件：

2.1 创建RolesTable.php #

在src/Model/Table目录下新建该文件：

<?php
namespace App\Model\Table;

use Cake\ORM\Table;
use Cake\Validation\Validator;

class RolesTable extends Table
{
    public function initialize(array $config): void
    {
        parent::initialize($config);

        $this->setTable('roles');
        $this->setDisplayField('display_name');
        $this->setPrimaryKey('id');

        // 配置与用户的多对多反向关联
        $this->belongsToMany('Users', [
            'through' => 'UserRoles',
            'foreignKey' => 'role_id',
            'targetForeignKey' => 'user_id'
        ]);
    }

    public function validationDefault(Validator $validator): Validator
    {
        $validator
            ->notEmptyString('name')
            ->maxLength('name', 50)
            ->add('name', 'unique', [
                'rule' => 'validateUnique',
                'provider' => 'table',
                'message' => '该角色名称已存在'
            ]);

        return $validator;
    }
}

2.2 创建UserRolesTable.php #

同样在src/Model/Table目录下新建：

<?php
namespace App\Model\Table;

use Cake\ORM\Table;

class UserRolesTable extends Table
{
    public function initialize(array $config): void
    {
        parent::initialize($config);

        $this->setTable('user_roles');
        $this->setPrimaryKey('id');

        // 关联用户与角色
        $this->belongsTo('Users', [
            'foreignKey' => 'user_id',
            'joinType' => 'INNER'
        ]);
        $this->belongsTo('Roles', [
            'foreignKey' => 'role_id',
            'joinType' => 'INNER'
        ]);
    }
}

2.3 修改你的UsersTable.php #

更新关联关系，替换原role字段的单值关联为多对多角色关联：

<?php
use CakeDC\Users\Model\Table\UsersTable as BaseUsersTable;

class UsersTable extends BaseUsersTable
{
    public function initialize(array $config)
    {
        parent::initialize($config);
        $this->setEntityClass('Users\Model\Entity\User');

        // 添加多对多角色关联
        $this->belongsToMany('Roles', [
            'through' => 'UserRoles',
            'foreignKey' => 'user_id',
            'targetForeignKey' => 'role_id',
            'dependent' => true // 用户删除时自动清理关联的角色绑定记录
        ]);

        // 保留你原来的其他关联（比如代码中已有的$this->belongs...）
    }
}

2.4 更新User实体（可选） #

如果需要在User实体中直接操作角色关联，可在Users\Model\Entity\User.php中添加：

<?php
namespace Users\Model\Entity;

use CakeDC\Users\Model\Entity\User as BaseUser;

class User extends BaseUser
{
    // 允许批量赋值角色关联
    protected $_accessible = [
        // 保留原有的可访问字段
        'roles' => true,
        'user_roles' => true
    ];
}

3. 使用示例 #

现在你可以这样操作用户角色：

• 给用户添加角色：

$user = $this->Users->get($userId, ['contain' => ['Roles']]);
$role = $this->Roles->findByName('fighter')->first();
$this->Users->Roles->link($user, [$role]);

• 获取用户所有角色：

$user = $this->Users->get($userId, ['contain' => ['Roles']]);
$roles = $user->roles; // 返回角色实体数组

• 检查用户是否拥有指定角色：

$hasManagerRole = $user->has('roles', function ($role) {
    return $role->name === 'manager';
});

内容的提问来源于stack exchange，提问作者meder omuraliev