花了几天时间认真的写了一个 RBAC 模块

说明

项目地址 https://github.com/yiier/yii2-rbac，有问题欢迎反馈。

安装

先安装 composer，然后在项目根目录执行下面命令安装模块：

php composer.phar require --prefer-dist yiier/yii2-rbac "*"

使用

配置

修改配置文件，比如修改 config/main.php，添加：

return [
    'modules' => [
        'rbac' => [
            'class' => 'yiier\rbac\Module',
            // 'ignoreModules' => ['gii', 'debug', 'rbac'],
            // 'menus' => [
            //    'rbac' =>'RBAC',
            //    'permissions' =>'Permissions',
            //    'roles' =>'Roles',
            //    'users' =>'Users',
            //    'rules' =>'Rules',
            // ],
            // 'userClassName' => 'app\models\User',
            // 'idField' => 'id',
            // 'usernameField' => 'shop_name',
            // 'mainLayout' => '@app/views/layout/rbac.php',
            // 'isAdvanced' => true, // 如果使用的是高级模板
            // 'advancedConfigs' = [ //如果你还有其他应用需要加入控制
            //     [
            //           '@common/config/main.php',
            //           '@common/config/main-local.php',
            //           '@frontend/config/main.php',
            //           '@frontend/config/main-local.php',
            //      ],
            //      [
            //           '@common/config/main.php',
            //           '@common/config/main-local.php',
            //           '@api/config/main.php',
            //           '@api/config/main-local.php',
            //      ],
            //      [
            //           '@common/config/main.php',
            //           '@common/config/main-local.php',
            //           '@backend/config/main.php',
            //           '@backend/config/main-local.php',
            //      ],
            //    ],
        ],
    ],
    'components' => [
        'authManager' => [
            'class' => 'yii\rbac\DbManager',
        ],
    ],
];

执行数据库操作，生成表，命令如下：

php yii migrate --migrationPath=@yii/rbac/migrations/

控制访问，修改配置文件，比如修改 config/main.php，添加：

'components' => [
    // ...
],
'as access' => [
    'class' => 'yiier\rbac\components\AccessControl',
    // 'allowActions' => ['site/login', 'site/error', 'site/captcha', order/*] //白名单
],

可选操作

修改默认参数，修改 config/params.php 添加：

'yiier.rbac.config' => [
    'cacheDuration' => 3600, // 缓存时间，默认是 30 天，单位是秒
    'superManId' => 12 //拥有所有权限
]

使用 rbac 模块的自带菜单

echo  \yii\widgets\Menu::widget(
    [
        'options' => [
            'class' => 'sidebar-menu'
        ],
        'items' => [
            [
                'label' => Yii::t('app', 'Dashboard'),
                'url' => Yii::$app->homeUrl,
                'icon' => 'fa-dashboard',
                'active' => Yii::$app->request->url === Yii::$app->homeUrl
            ],
            \Yii::$app->getModule('rbac')->getInstance()->getItems() // add menu
        ]
    ]
);

使用 \yiier\rbac\helpers\Html::a ，判断是否有权限，如果没有权限自动隐藏链接

<?= \yiier\rbac\helpers\Html::a(Yii::t('rbac', 'Clear Cache'), ['clear-cache']) ?>

使用 yiier\rbac\widgets\Menu::widget ，判断是否有权限，如果没有权限自动隐藏菜单中的链接

echo  yiier\rbac\widgets\Menu::widget(
    [
        'options' => [
            'class' => 'sidebar-menu'
        ],
        'items' => [
            [
                'label' => Yii::t('app', 'Dashboard'),
                'url' => Yii::$app->homeUrl,
                'icon' => 'fa-dashboard',
                'active' => Yii::$app->request->url === Yii::$app->homeUrl
            ],
            \Yii::$app->getModule('rbac')->getInstance()->getItems() // add menu
        ]
    ]
);

使用 yiier\rbac\widgets\SpuerMenu::widget ，判断是否有权限，如果没有权限自动隐藏菜单中的链接，并且能实现自动高亮：

echo  yiier\rbac\widgets\SpuerMenu::widget(
    [
        'options' => [
            'class' => 'sidebar-menu'
        ],
        'items' => [
            [
                'label' => Yii::t('app', 'Dashboard'),
                'url' => Yii::$app->homeUrl,
                'icon' => 'dashboard',
            ],
            [
                'label' => Yii::t('app', 'Create Product'), 
                'icon' => 'plus', 
                'url' => ['/product/create'], 
                'strict' => true
            ],
            \Yii::$app->getModule('rbac')->getInstance()->getItems() // add menu
        ]
    ]
);