Yii Srbac 非常简单方便的权限控制方法

在开发一个有多种用户的网络应用时，对权限的判断总是一个很麻烦的事情。

Yii支持RBAC(Role-Based Access Control)，结合filter，就给我们提供了非常简单方便的权限控制方法。

其实RBAC的原理很简单。

先梳理一下默认的Yii的授权filter:accessControl。它是根据accessRules按照用户的身份(users)来验证并授权的，默认的有*(任何用户),@(通过登录验证的用户),admin(管理员)。通过一系列这些accessRules，指定了这三种身份用户的各自可调用的action的权限。

而RBAC和默认的按照users的原理一样。通过指定”roles”来限定对应角色用户的可用action的权限。用”roles”替换”users”即可，因为Yii的accessControl是支持roles的。通过这种方式，在Contoller内部，通过指定accessRules就可以控制权限。在其他地方，比如控制一些view的显示的时候，可以用Yii::app()->user->checkAccess(role)来进行权限判断。

下面是安装的方法:

下载 srbac

Srbac 可以在如下地址下载：

Yii 扩展页面： http://www.yiiframework.com/extension/srbac/
Google 项目页面： http://code.google.com/p/srbac/downloads/list
也可以使用如下命令签出最新的开发代码：

svn checkout http://srbac.googlecode.com/svn/trunk/ srbac-read-only

安装 srbac

要安装 srbac 模块,首先解压压缩文件到Yii应用的模块目录，如果把srbac作为一个模块的话，就要在protected文件夹下新建一个文件夹modules，然后把解压得到的文件夹复制过来。

然后编辑配置文件如下:

在protected/config/main中

首先应该有db的配置：

'db'=>array(
'connectionString' => 'mysql:host=localhost;dbname=blog',
'emulatePrepare' => true,
'username' => 'root',
'password' => 'guohao',
'charset' => 'utf8',
'tablePrefix' => 'tbl_',
),

配置authManager组件：
'authManager'=>array(
'class'=>'CDbAuthManager',// Manager 的类型
'connectionID'=>'db',//使用的数据库组件
'itemTable'=>'items',// 授权项目表 (默认:authitem)
'assignmentTable'=>'assignments',// 授权分配表 (默认:authassignment)
'itemChildTable'=>'itemchildren',// 授权子项目表 (默认:authitemchild)
),
items,assignments,itemchildren三个表的名字可随意改动。表结构请到framework/web/auth/schema.sql

'modules'=>array(
'srbac' => array(
'userclass'=>'User', //可选,默认是 User
'userid'=>'id', //可选,默认是 userid
'username'=>'username', //可选，默认是 username
'debug'=>true, //可选,默认是 false
'pageSize'=>10, //可选，默认是 15
'superUser' =>'Authority', //可选，默认是 Authorizer
'css'=>'srbac.css', //可选，默认是 srbac.css
'layout'=>
'application.views.layouts.main', //可选,默认是
// application.views.layouts.main, 必须是一个存在的路径别名
'notAuthorizedView'=>
'srbac.views.authitem.unauthorized', // 可选,默认是unauthorized.php
//srbac.views.authitem.unauthorized, 必须是一个存在的路径别名
'alwaysAllowed'=>array(    //可选,默认是 gui
'SiteLogin','SiteLogout','SiteIndex','SiteAdmin',
'SiteError', 'SiteContact'),
'userActions'=>array(//可选,默认是空数组
'Show','View','List'),
'listBoxNumberOfLines' => 15, //可选,默认是10
'imagesPath' => 'srbac.images', //可选,默认是 srbac.images
'imagesPack'=>'noia', //可选,默认是 noia
'iconText'=>true, //可选,默认是 false
'header'=>'srbac.views.authitem.header', //可选,默认是
// srbac.views.authitem.header, 必须是一个存在的路径别名
'footer'=>'srbac.views.authitem.footer', //可选,默认是
// srbac.views.authitem.footer, 必须是一个存在的路径别名
'showHeader'=>true, //可选,默认是false
'showFooter'=>true, //可选,默认是false
'alwaysAllowedPath'=>'srbac.components', //可选,默认是 srbac.components
// 必须是一个存在的路径别名
),

),

//srbac作为一个模块，所以要声明一下才能使用。

查看srbac属性列表可以得到每个属性的详细信息。

导入 SbaseController(for using the auto checking access feature)：

'import'=>array(

'application.modules.srbac.controllers.SBaseController',

),

这样就配置完了。接着你可以访问http://localhost/app/index.php?r=srbac/authitem

进入安装页面后如果有变红的项目，说明你的配置有问题，请修改为正确的配置。然后点击安装。

然后完成安装，显示成功后，你进入项目，找到protected\modules\srbac\views\authitem\install可以把这个文件夹删掉，也可以重命名。然后找到protected\modules\srbac\controllers\AuthitemController.php

修改

protected function beforeAction($action) {

//if(!$this->module->isInstalled() && $action->id != "install") {

// $this->redirect(array("install"));

// $this->actionInstall();

// return false;

//}

if($this->module->debug) {

return true;

}

if( Yii::app()->user->checkAccess(Helper::findModule('srbac')->superUser) ||

!Helper::isAuthorizer()) {

return true;

} else {

parent::beforeAction($action);

}

}

因为这个地方判断每次都是新安装srbac。当你安装完成后，这里就没用了。可以注释掉了。

再访问链接http://localhost/app/index.php?r=srbac/authitem/authitem

就可以看到管理界面了。

使用方法:

1、主要还是姓名（name）建立好，例如：admin@articleIndex（admin是module，article是controller，Index是action）。规则就是一个业务判断语句，例如：

$bizRule='return Yii::app()->user->id==$params["post"]->authID;';

2、controller直接继承SbaseController就可以自动调用了。

汉化:

1、修改中文化语言文件（srbac/message/zh_cn/srbac.php，其中默认的zh修改为zh_cn），添加数组："TYPES"=>array("操作","任务","角色"),

2、修改AuthItem模型中的$TYPES，默认是一个英文数组，改为public static
$TYPES ;

3、为AuthItem模型添加getTYPES()方法；

public function getTYPES(){
self::$TYPES = Helper::translate('srbac','TYPES');
}

4、重写构造函数，如下：

public function  __construct($scenario = 'insert') {
parent::__construct($scenario);
$this->getTYPES();
}