CakePHP4中如何获取已登录用户角色名称并在仪表盘展示？

1. 检查并设置表关联 #

首先确保UsersTable和RolesTable之间的关联已正确配置：
在src/Model/Table/UsersTable.php的initialize方法中添加：

public function initialize(array $config): void
{
    parent::initialize($config);

    $this->setTable('users');
    $this->setDisplayField('pseudo');
    $this->setPrimaryKey('id');

    // 添加与Roles表的关联
    $this->belongsTo('Roles', [
        'foreignKey' => 'role_id',
        'joinType' => 'INNER', // 根据业务需求选择INNER或LEFT
    ]);
}

2. 加载角色关联数据 #

登录用户的身份信息默认不会自动关联加载角色数据，需要手动配置：

方法一：全局身份认证时加载关联 #

在src/Controller/AppController.php的initialize方法中，修改Authentication组件配置：

public function initialize(): void
{
    parent::initialize();

    $this->loadComponent('Authentication.Authentication', [
        'loginAction' => '/users/login',
        // 其他配置项...
        // 添加身份信息的关联加载规则
        'identityOptions' => [
            'contain' => ['Roles'],
        ],
    ]);
}

配置完成后，所有登录用户的身份信息都会自动包含角色数据，视图中直接使用$administrateur->role->nom即可。

方法二：按需加载关联 #

如果不需要全局加载角色数据，可在控制器或视图中手动获取带关联的用户数据：

• 在目标控制器（如DashboardController）中处理：

public function index()
{
    $administrateur = $this->request->getAttribute('identity');
    // 重新获取用户数据并包含角色关联
    $administrateur = $this->Users->get($administrateur->id, [
        'contain' => ['Roles'],
    ]);
    $this->set(compact('administrateur'));
}

• 或直接在视图中处理：

<?php 
$administrateur = $this->request->getAttribute('identity');
// 获取Users表实例
$usersTable = \Cake\ORM\TableRegistry::getTableLocator()->get('Users');
// 重新加载带角色关联的用户数据
$administrateur = $usersTable->get($administrateur->id, [
    'contain' => ['Roles'],
]);
?>
<h6 class="mb-0"><?= $administrateur->pseudo?></h6>
<span><?= $administrateur->role->nom ?></span>

3. 避免空值报错 #

为防止用户无关联角色时出现页面错误，可添加空值判断逻辑：

<span><?= $administrateur->role?->nom ?? '无角色' ?></span>

（注：?->是PHP8+的空安全运算符，PHP7及以下版本可改用!empty($administrateur->role) ? $administrateur->role->nom : '无角色'）

内容的提问来源于stack exchange，提问作者Marc joe Ndzana ngono