PHPackages                             yiier/yii2-rbac - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Authentication & Authorization](/categories/authentication)
4. /
5. yiier/yii2-rbac

ActiveYii2-extension[Authentication & Authorization](/categories/authentication)

yiier/yii2-rbac
===============

RBAC Auth manager for Yii2

v1.2.7(5y ago)17440BSD-4-ClausePHP

Since Sep 24Pushed 5y ago12 watchersCompare

[ Source](https://github.com/yiier/yii2-rbac)[ Packagist](https://packagist.org/packages/yiier/yii2-rbac)[ RSS](/packages/yiier-yii2-rbac/feed)WikiDiscussions master Synced 2d ago

READMEChangelog (10)Dependencies (1)Versions (13)Used By (0)

RBAC Manager for Yii 2
======================

[](#rbac-manager-for-yii-2)

RBAC Auth manager for Yii2

[![Latest Stable Version](https://camo.githubusercontent.com/795a9e167eff10b706a93252e4be3ef41cb7acbcd2a4fd986d80109ef40889b4/68747470733a2f2f706f7365722e707567782e6f72672f79696965722f796969322d726261632f762f737461626c65)](https://packagist.org/packages/yiier/yii2-rbac)[![Total Downloads](https://camo.githubusercontent.com/93eac16964af1316cecbb7e7ca3b139da15aa3fd95ee13b3b17a2352c0fa7a36/68747470733a2f2f706f7365722e707567782e6f72672f79696965722f796969322d726261632f646f776e6c6f616473)](https://packagist.org/packages/yiier/yii2-rbac)[![Latest Unstable Version](https://camo.githubusercontent.com/771e9df2732edbafaa3128d4e3db0b9c501536b80e9faecd470d124d530d0c1d/68747470733a2f2f706f7365722e707567782e6f72672f79696965722f796969322d726261632f762f756e737461626c65)](https://packagist.org/packages/yiier/yii2-rbac)[![License](https://camo.githubusercontent.com/86f5f1b795f663e1f142279888ac34d801217e358f50dc8b8850e5a214c52b73/68747470733a2f2f706f7365722e707567782e6f72672f79696965722f796969322d726261632f6c6963656e7365)](https://packagist.org/packages/yiier/yii2-rbac)

Installation
------------

[](#installation)

The preferred way to install this extension is through [composer](http://getcomposer.org/download/).

Either run

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

```

or add

```
"yiier/yii2-rbac": "*"

```

to the require section of your `composer.json` file.

Usage
-----

[](#usage)

### 配置

[](#配置)

- 修改配置文件，比如 修改 `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',
            // ],
            // 'safeDelete' => false, // 默认为 true，当为 true 时，角色有用户时，不能直接删除角色，要先去掉角色的所有用户
            // 'rulesPath' => ['@app/rbac/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',
],
```

### 可选操作

[](#可选操作)

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

```
'yiier.rbac.config' => [
    'cacheDuration' => 3600, // 缓存时间，单位是秒。默认是 30 天
    'superManId' => 12 // 拥有所有权限的用户 ID
    'freeAccessRoutes' => ['/site/login', '/site/signup', '/site/error', '/site/captcha', '/site/logout', '/order/*'], // 白名单 URL
]
```

- 使用 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` ，判断是否有权限，如果没有权限自动隐藏链接

```