ThinkPHP的Auth類認證

 Auth 類已經在ThinkPHP代碼倉庫中存在很久了，但是因為一直沒有出過它的教程， 很少人知道它， 它其實比RBAC更方便 。 
RBAC是按節點進行認證的，如果要控制比節點更細的權限就有點困難了，比如頁面上面的操作按鈕， 我想判斷用戶權限來顯示這個按鈕， 如果沒有權限就不會顯示這個按鈕；  再比如我想按積分進行權限認證，  積分在0-100時能干什么， 在101-200時能干什么。  這些權限認證用RABC都很困難。

     用Auth來判斷用戶權限，其原理就是，根據事先訂立好的規則來判斷該用戶指定的屬性是否符合規則要求。 通常情況下，只是一個簡單的判斷，就是通過$auth->check();返回值，來判斷該用戶是否符合規則。有些時候這樣的判斷我們在控制器里做，判斷后執行不同的代碼，或者是在模板中調用，判斷后顯示不同的模板內容，比如不同的用戶顯示不同菜單等，這樣在模板調用的時候，就會帶來很多麻煩。
    下面介紹 Auth權限認證， 它幾乎是全能的， 除了能進行節點認證， 上面說的RABC很難認證的兩種情況，它都能實現。 
Auth權限認證是按規則進行認證。我先說說它的原理。   在數據庫中我們有  規則表（think_auth_rule） ,用戶組表(think_auth_group), 用戶組明細表（think_auth_group_access）
     我們在規則表中定義權限規則 ， 在用戶組表中定義每個用戶組有哪些權限規則，在用戶組明顯表中 定義用戶所屬的用戶組。 下面舉例說明。 
     我們要判斷用戶是否有顯示一個操作按鈕的權限， 首先定義一個規則， 在規則表中添加一個名為 show_button 的規則。  然后在用戶組表添加一個用戶組，定義這個用戶組有show_button  的權限規則（think_auth_group表中rules字段存得時規則ID，多個以逗號隔開）， 然后在用戶組明細表定義 UID 為1 的用戶 屬於剛才這個的這個用戶組。
ok，表數據定義好后， 判斷權限很簡單

    import('ORG.Util.Auth');//加載類庫
     $auth=new Auth();
     if($auth->check('show_button',1)){// 第一個參數是規則名稱,第二個參數是用戶UID
      //有顯示操作按鈕的權限
    }else{
      //沒有顯示操作按鈕的權限
    }

 

Auth類同樣可以做像RBAC一樣的對節點進行認證。 我們只要將規則名稱，定義為節點名稱就行了。 
     和RABC一樣 在公共控制器CommonAction 中定義_initialize 方法，

<?php
 class CommonAction extends Action{
     public function _initialize(){
        import('ORG.Util.Auth');//加載類庫
        $auth=new Auth();
        if(!$auth->check(MODULE_NAME.'-'.ACTION_NAME,session('uid'))){
             $this->error('你沒有權限');
        }
     }
 }

 

這時候我們可以在數據庫中添加的節點規則， 格式為： “控制器名稱-方法名稱”

Auth 類 還可以多個規則一起認證 如： 

 $auth->check('rule1,rule2',uid); 

表示 認證用戶只要有rule1的權限或rule2的權限，只要有一個規則的權限，認證返回結果就為true 即認證通過。   默認多個權限的關系是 “or” 關系，也就是說多個權限中，只要有個權限通過則通過。   我們也可以定義為 “and” 關系

$auth->check('rule1,rule2',uid,'and'); 

第三個參數指定為"and" 表示多個規則以and關系進行認證， 這時候多個規則同時通過認證 才有權限。只要一個規則沒有權限則就會返回false。

Auth認證，一個用戶可以屬於多個用戶組。   比如我們對 show_button這個規則進行認證， 用戶A 同時屬於 用戶組1 和用戶組2 兩個用戶組 ， 用戶組1 沒有show_button 規則權限， 但如果用戶組2 有show_button 規則權限，則一樣會權限認證通過。  

     $auth->getGroups(uid)
     

通過上面代碼，可以獲得用戶所屬的所有用戶組，方便我們在網站上面顯示。

Auth類還可以按用戶屬性進行判斷權限， 比如 按照用戶積分進行判斷， 假設我們的用戶表 (think_members) 有字段 score  記錄了用戶積分。
   我在規則表添加規則時，定義規則表的condition 字段，condition字段是規則條件， 默認為空 表示沒有附加條件， 用戶組中只有規則 就通過認證。 如果定義了 condition字段， 用戶組中有規則 不一定能通過認證， 程序還會判斷是否滿足 附加條件。  比如我們添加幾條規則：
name字段： grade1 ,   condition字段： {score}<100
     name字段： grade2,   condition字段： {score}>100 and {score}<200
     name 字段:  grade3, condition字段  : {score}>200 and {score}<300

這里 {score} 表示 think_members 表 中字段 score的值。

那么這時候
$auth->check('grade1',uid) 是判斷用戶積分是不是0-100
$auth->check('grade2',uid) 判斷用戶積分是不是在100-200
$auth->check('grade3',uid) 判斷用戶積分是不是在200-300

Auth 類認證的使用方法 大致如上，是否有點相見恨晚的感覺？ 

----------------------------------------------------

在使用Auth類前需要配置config.php

'AUTH_CONFIG'=>array(
         'AUTH_ON' => true, //認證開關
         'AUTH_TYPE' => 1, // 認證方式，1為時時認證；2為登錄認證。
         'AUTH_GROUP' => 'think_auth_group', //用戶組數據表名
         'AUTH_GROUP_ACCESS' => 'think_auth_group_access', //用戶組明細表
         'AUTH_RULE' => 'think_auth_rule', //權限規則表
         'AUTH_USER' => 'think_members'//用戶信息表
     )

需要導入數據庫

-- ----------------------------
 -- think_auth_rule，規則表，
 -- id:主鍵，name：規則唯一標識, title：規則中文名稱 status 狀態：為1正常，為0禁用，condition：規則表達式，為空表示存在就驗證，不為空表示按照條件驗證
 -- ----------------------------
  DROP TABLE IF EXISTS `think_auth_rule`;
 CREATE TABLE `think_auth_rule` (  
     `id` mediumint(8) unsigned NOT NULL AUTO_INCREMENT,  
     `name` char(80) NOT NULL DEFAULT '',  
     `title` char(20) NOT NULL DEFAULT '',  
     `status` tinyint(1) NOT NULL DEFAULT '1',  
     `condition` char(100) NOT NULL DEFAULT '',  
     PRIMARY KEY (`id`),  
     UNIQUE KEY `name` (`name`)
 ) ENGINE=MyISAM  DEFAULT CHARSET=utf8;
 -- ----------------------------
 -- think_auth_group 用戶組表， 
 -- id：主鍵， title:用戶組中文名稱， rules：用戶組擁有的規則id， 多個規則","隔開，status 狀態：為1正常，為0禁用
 -- ----------------------------
  DROP TABLE IF EXISTS `think_auth_group`;
 CREATE TABLE `think_auth_group` ( 
     `id` mediumint(8) unsigned NOT NULL AUTO_INCREMENT, 
     `title` char(100) NOT NULL DEFAULT '', 
     `status` tinyint(1) NOT NULL DEFAULT '1', 
     `rules` char(80) NOT NULL DEFAULT '', 
     PRIMARY KEY (`id`)
 ) ENGINE=MyISAM  DEFAULT CHARSET=utf8;
 -- ----------------------------
 -- think_auth_group_access 用戶組明細表
 -- uid:用戶id，group_id：用戶組id
 -- ----------------------------
 DROP TABLE IF EXISTS `think_auth_group_access`;
 CREATE TABLE `think_auth_group_access` (  
     `uid` mediumint(8) unsigned NOT NULL,  
     `group_id` mediumint(8) unsigned NOT NULL, 
     UNIQUE KEY `uid_group_id` (`uid`,`group_id`),  
     KEY `uid` (`uid`), 
     KEY `group_id` (`group_id`)
 ) ENGINE=MyISAM DEFAULT CHARSET=utf8;

最后需要下載Auth類文件到你的項目中，大家可以下載我上傳的附件， Auth類在ThinkPHP代碼倉庫中的位置在： https://github.com/liu21st/extend/blob/master/Extend/Library/ORG/Util/Auth.class.php