Yii2 Admin后台RBAC权限菜单与操作按钮控制

准备工作：路由权限分配

要实现精准的权限控制，首先需要确保用户的权限列表已覆盖所需的路由。/admin/route/index 是路由管理页面。进入该页面后，建议勾选所有左侧可用的路由并移动至右侧，以建立基础权限池。随后，登录目标用户账户，确保其在 /admin/auth/assignment 中已被分配了这些路由权限。
如果此时你发现某些页面无法访问，可能是因为全局的 as access 过滤器拦截了请求。在调试阶段，可暂时放宽限制，但正式启用时必须恢复严格的权限验证。

第1步：添加结构化的菜单数据

访问 /admin/menu/index，点击“添加菜单”。若提示无权限，请检查之前的路径或临时解除访问限制。
填写菜单基本字段时：名称 为菜单显示文字，父级名称 留空表示一级菜单，填入已有菜单名则为子菜单。路由 指向具体的访问地址（如 /admin/default/index）。映射 数值越小越靠前。

完成层级搭建后，重点在于 数据 (Data) 字段的JSON配置，它用于存放扩展属性（如图标和可见性）。以下以某个二级菜单为例：

{"icon": "fa fa-user", "visible": false}

此处定义该菜单显示一个用户图标，并在当前权限下保持隐藏状态（仅作为示例，通常用于控制不可见菜单或特殊样式）。

第2步：重构菜单渲染组件

默认情况下，dmstr\widgets\Menu 不会解析 data 字段。我们需要引入回调函数来转换数据格式。将原有的菜单调用代码替换如下：

<?php
use mdm\admin\components\MenuHelper;

$callback = function($menu) {
    $data = json_decode($menu['data'], true);
    $return = [
        'label' => $menu['name'],
        'url' => [$menu['route']],
    ];

    // 处理配置
    if ($data) {
        isset($data['visible']) && $return['visible'] = $data['visible'];
        isset($data['icon']) && $return['icon'] = $data['icon'];
        $return['options'] = $data;
    }

    // 默认图标处理
    (!isset($return['icon']) || empty($return['icon'])) && $return['icon'] = 'fa fa-circle-o';

    !empty($menu['children']) && $return['items'] = $menu['children'];
    return $return;
};

// 渲染菜单，传入回调函数
echo dmstr\widgets\Menu::widget([
    'options' => ['class' => 'sidebar-menu'],
    'items' => MenuHelper::getAssignedMenu(Yii::$app->user->id, null, $callback),
]);
?>

此段代码会读取之前设置的 JSON 数据，将其转化为 Yii2 Menu Widget 识别的属性数组，从而动态改变图标的可见性与显示内容。

第3步：实现操作按钮的权限过滤

仅控制菜单是不够的，页面上的功能按钮也需要根据权限进行展示。我们以生成的CRUD界面为例进行修改。

1. 控制新增按钮：
在视图文件顶部（或工具栏位置）使用 Helper::checkRoute() 判断当前用户是否有“创建”权限：

<?php use mdm\admin\components\Helper; ?>
<?php if(Helper::checkRoute('create')): ?>
    <?php echo Html::a('Create', ['create'], ['class' => 'btn btn-success']); ?>
<?php endif; ?>

2. 控制列表操作列（GridView）：
在 ActionColumn 的配置中使用 filterActionColumn 方法，它会检查当前权限并自动剔除无权操作的链接（如删除、更新）：

<?php
use mdm\admin\components\Helper;
echo GridView::widget([
    'columns' => [
        [
            'class' => 'yii\grid\ActionColumn',
            'template' => Helper::filterActionColumn('{view}{update}{delete}'),
        ],
    ],
]);
?>

刷新页面测试，撤销某项路由权限后，对应的按钮将从界面上消失，直接访问对应URL也会被拒绝访问，从而实现前后端双重保护。

简要总结

通过以上步骤，我们在Yii2 Admin系统中实现了：1. 通过JSON Data字段赋予菜单灵活的UI属性（图标、显隐）；2. 通过Helper类对视图层操作按钮进行细粒度控制。这种方案确保了权限逻辑的统一性，即“无权限则不可见”。在实际项目中，建议将此Helper逻辑封装并应用到所有自定义Gii生成的模板文件中。

以上就是Yii2 RBAC权限控制之菜单与按钮操作的详细内容，更多关于Yii2权限管理的资料请关注本站其它相关文章！