如何将Yeesoft/Yii2 CMS RBAC与Yii2高级模板前端RBAC集成？

Hey there! 我刚好有过类似的场景——只用Yeesoft的RBAC管理模块，而非整套CMS，来管控Yii2高级模板前端的访问权限。给你梳理一下具体的实现步骤，帮你快速落地：

首先得保证RBAC模块在后端（管理端）能正常运行，毕竟权限分配操作是在后端做的：

• 先检查后端配置文件backend/config/main.php，确保已经注册了Yeesoft的Auth组件和模块：

'components' => [
    'authManager' => [
        'class' => 'yeesoft\auth\DbManager',
        'defaultRoles' => ['guest'],
    ],
    // 其他组件配置...
],
'modules' => [
    'auth' => [
        'class' => 'yeesoft\auth\Module',
        // 配置用户模型路径，对应你项目里的用户表模型
        'controllerMap' => [
            'assignment' => [
                'class' => 'yeesoft\auth\controllers\AssignmentController',
                'userClassName' => 'common\models\User',
            ],
        ],
        // 可选：限制只有admin角色能访问RBAC面板
        'as access' => [
            'class' => 'yii\filters\AccessControl',
            'rules' => [
                [
                    'allow' => true,
                    'roles' => ['admin'],
                ],
            ],
        ],
    ],
    // 其他模块...
],

• 运行数据库迁移，创建RBAC所需的表（权限、角色、关联表）：

yii migrate --migrationPath=@yeesoft/auth/migrations

接下来要让前端的控制器动作受权限管控，修改前端配置和控制器：

• 先在前端配置文件frontend/config/main.php里引入Auth组件，让前端能识别权限：

'components' => [
    'authManager' => [
        'class' => 'yeesoft\auth\DbManager',
        'defaultRoles' => ['guest'],
    ],
    // 其他组件...
],

• 在需要管控的前端控制器里，添加AccessControl行为，把动作和权限绑定。比如frontend/controllers/EmployeeController.php：

use yii\filters\AccessControl;

class EmployeeController extends \yii\web\Controller
{
    public function behaviors()
    {
        return array_merge(parent::behaviors(), [
            'access' => [
                'class' => AccessControl::class,
                'rules' => [
                    // 允许拥有employee_view权限的用户访问列表和详情页
                    [
                        'allow' => true,
                        'actions' => ['index', 'view'],
                        'roles' => ['employee_view'],
                    ],
                    // 允许拥有employee_edit权限的用户访问创建和编辑页
                    [
                        'allow' => true,
                        'actions' => ['create', 'update'],
                        'roles' => ['employee_edit'],
                    ],
                    // 允许拥有employee_delete权限的用户执行删除操作
                    [
                        'allow' => true,
                        'actions' => ['delete'],
                        'roles' => ['employee_delete'],
                    ],
                ],
                // 可选：未授权时跳转到登录页或提示页面
                'denyCallback' => function ($rule, $action) {
                    if (Yii::$app->user->isGuest) {
                        return $action->controller->redirect(['site/login']);
                    }
                    throw new \yii\web\ForbiddenHttpException('你没有权限执行此操作');
                },
            ],
        ]);
    }

    // 控制器的具体动作方法...
}

现在可以登录后端的RBAC管理页面（路径一般是/auth），完成权限配置：

• 创建权限：比如创建employee_view、employee_edit、employee_delete这几个权限，对应前端控制器的动作。
• 创建角色：比如创建staff（普通员工）、manager（部门经理）两个角色，给角色分配对应的权限：
  • 给staff分配employee_view和employee_edit权限
  • 给manager分配所有员工相关的权限
• 绑定用户到角色：找到你的员工用户，给他们分配对应的角色（比如把普通员工账号绑定到staff角色）。

如果需要在前端页面根据权限显示/隐藏操作按钮（比如编辑、删除按钮），可以用Yii内置的权限判断方法：

<?php use yii\helpers\Url; use yii\helpers\Html; ?>

<!-- 只有拥有employee_edit权限的用户能看到编辑按钮 -->
<?php if (Yii::$app->user->can('employee_edit')): ?>
    <a href="<?= Url::to(['employee/update', 'id' => $model->id]) ?>" class="btn btn-primary">编辑</a>
<?php endif; ?>

<!-- 只有拥有employee_delete权限的用户能看到删除按钮 -->
<?php if (Yii::$app->user->can('employee_delete')): ?>
    <?= Html::a('删除', ['delete', 'id' => $model->id], [
        'class' => 'btn btn-danger',
        'data' => [
            'confirm' => '确定要删除这条记录吗？',
            'method' => 'post',
        ],
    ]) ?>
<?php endif; ?>

• 确保你的用户模型（common\models\User）实现了yii\web\IdentityInterface接口，这是Yii RBAC关联用户的基础。
• 如果你不需要Yeesoft CMS的其他功能，完全可以只保留auth模块，其他CMS相关模块不用注册，避免冗余。
• 测试阶段建议用不同角色的账号登录前端，验证权限是否生效——比如用staff账号登录，看看能不能访问删除页面，按钮是否隐藏。

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