yii之srbac详解

一、安装篇

1、下载http://www.yiiframework.com/extension/srbac/ 将解压得到的srbac文件夹放在moudles目录下。

2、在项目的主配置文件中mai.php:

'modules'=>array(
        // uncomment the following to enable the Gii tool

        'gii'=>array(
            'class'=>'system.gii.GiiModule',
            'password'=>'123123',
            // If removed, Gii defaults to localhost only. Edit carefully to taste.
            'ipFilters'=>array('127.0.0.1','::1'),
        ),

        'srbac' => array(
            'userclass'=>'User', //default: User
            'userid'=>'userid', //default: userid
            'username'=>'username', //default:username
            'delimeter'=>'@', //default:-
            'debug'=>false, //default :false
            'pageSize'=>10, // default : 15
            'superUser' =>'Authority', //default: Authorizer
            'css'=>'srbac.css', //default: srbac.css
            'layout'=>
                'application.views.layouts.main', //default: application.views.layouts.main,
            //must be an existing alias
            'notAuthorizedView'=> 'srbac.views.authitem.unauthorized', // default:
            //srbac.views.authitem.unauthorized, must be an existing alias
            'alwaysAllowed'=>array( //default: array()
                'SiteLogin','SiteLogout','SiteIndex','SiteAdmin',
                'SiteError', 'SiteContact','UserIndex'),
            'userActions'=>array('Show','View','List'), //default: array()
            'listBoxNumberOfLines' => 15, //default : 10 'imagesPath' => 'srbac.images', // default: srbac.images 'imagesPack'=>'noia', //default: noia 'iconText'=>true, // default : false 'header'=>'srbac.views.authitem.header', //default : srbac.views.authitem.header,
            //must be an existing alias 'footer'=>'srbac.views.authitem.footer', //default: srbac.views.authitem.footer,
            //must be an existing alias 'showHeader'=>true, // default: false 'showFooter'=>true, // default: false
            'alwaysAllowedPath'=>'srbac.components', // default: srbac.components
            // must be an existing alias )
        ),


    ),

'import'=>array(
        'application.models.*',
        'application.components.*',
        'application.modules.srbac.controllers.SBaseController',
    ),

'components'=>array(
        'user'=>array(
            // enable cookie-based authentication
            'allowAutoLogin'=>true,
        ),
        
        'authManager' => array(
            'class'=>'srbac.components.SDbAuthManager',
            // The database component used
            'connectionID'=>'db',
            // The itemTable name (default:authitem)
            'itemTable'=>'authitem',
            // The assignmentTable name (default:authassignment)
            'assignmentTable'=>'authassignment',
            // The itemChildTable name (default:authitemchild)
            'itemChildTable'=>'authitemchild',
        ),

        // uncomment the following to use a MySQL database

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

配置完毕，还需要一个User模型，至少含有userid，username两个选项，与上面的配置文件中保持一致。用gii工具生成User模型。通过域名/index.php/srbac进行访问进入安装界面，以上选项都具备时，安装成功。

二、使用篇

1、使用之前的几个小问题。

（1）界面中文化

   将srbac/message下的zh文件夹复制一份为zh_cn,在main.php中添加配置选项'language'=>'zh_cn'即可。

（2）自动检测，如果没有自动检测，在需要调用权限的检查的方法时候都要进行添加代码的检测，如Yii::app()->user->checkAccess('createPost')，满足了才继续向下执行。开启自动检测需要下面两个条件：

　　　　将配置文件中的 'debug'选项设置为false，如上所示；

　　　　然后将components组件中的Controller.php中的：

class Controller extends CController

　　　　改为：

class Controller extends SBaseController

　　这样就会自动进行检测了。并且只有继承了SBaseController，才能在界面中使用自动生成opreation和task的功能。

（3）设置只有超级管理员才可以访问Srbac,安装完成后默认的都可以访问。

　　在配置文件中有这个选项：'superUser' =>'Authority',  这个Authority就是一个管理srbac的唯一的一个角色，只要将这个角色分配给一个特定的用户，那么就只有这个用户可以访问srbac了。

 (4) 明确这个srbac只是一个工具，更方便的来实现rbac，用yii单纯的代码一样可以完成工作。比如在配置好了上面的选项以后，如果用代码生成规则如下：

$auth=Yii::app()->authManager;

        $auth->createOperation('createPost','create a post');
        $auth->createOperation('readPost','read a post');
        $auth->createOperation('updatePost','update a post');
        $auth->createOperation('deletePost','delete a post');

        $bizRule='return Yii::app()->user->id==$params["post"]->authID;';
        $task=$auth->createTask('updateOwnPost','update a post by author himself',$bizRule);
        $task->addChild('updatePost');

这些数据将会写入数据表中，并且在这个Srbac也可以读到这些数据。

　　

2、srbac中是分了四层：操作、任务、角色、用户。