比RBAC更好的許可權認證方式（Auth類認證）

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

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

下麵介紹 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 方法，

1 <?php
2 class CommonAction extends Action{
3     public function _initialize(){
4        import('ORG.Util.Auth');//載入類庫
5        $auth=new Auth();
6        if(!$auth->check(MODULE_NAME.'-'.ACTION_NAME,session('uid'))){
7             $this->error('你沒有許可權');
8        }
9     }

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

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

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

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

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

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

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

```
1      $auth->getGroups(uid)
2     
```

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

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

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

需要導入資料庫

 1 -- ----------------------------
 2 -- think_auth_rule，規則表，
 3 -- id:主鍵，name：規則唯一標識, title：規則中文名稱 status 狀態：為1正常，為0禁用，condition：規則表達式，為空表示存在就驗證，不為空表示按照條件驗證
 4 -- ----------------------------
 5  DROP TABLE IF EXISTS `think_auth_rule`;
 6 CREATE TABLE `think_auth_rule` (  
 7     `id` mediumint(8) unsigned NOT NULL AUTO_INCREMENT,  
 8     `name` char(80) NOT NULL DEFAULT '',  
 9     `title` char(20) NOT NULL DEFAULT '',  
10     `status` tinyint(1) NOT NULL DEFAULT '1',  
11     `condition` char(100) NOT NULL DEFAULT '',  
12     PRIMARY KEY (`id`),  
13     UNIQUE KEY `name` (`name`)
14 ) ENGINE=MyISAM  DEFAULT CHARSET=utf8;
15 -- ----------------------------
16 -- think_auth_group 用戶組表， 
17 -- id：主鍵， title:用戶組中文名稱， rules：用戶組擁有的規則id， 多個規則","隔開，status 狀態：為1正常，為0禁用
18 -- ----------------------------
19  DROP TABLE IF EXISTS `think_auth_group`;
20 CREATE TABLE `think_auth_group` ( 
21     `id` mediumint(8) unsigned NOT NULL AUTO_INCREMENT, 
22     `title` char(100) NOT NULL DEFAULT '', 
23     `status` tinyint(1) NOT NULL DEFAULT '1', 
24     `rules` char(80) NOT NULL DEFAULT '', 
25     PRIMARY KEY (`id`)
26 ) ENGINE=MyISAM  DEFAULT CHARSET=utf8;
27 -- ----------------------------
28 -- think_auth_group_access 用戶組明細表
29 -- uid:用戶id，group_id：用戶組id
30 -- ----------------------------
31 DROP TABLE IF EXISTS `think_auth_group_access`;
32 CREATE TABLE `think_auth_group_access` (  
33     `uid` mediumint(8) unsigned NOT NULL,  
34     `group_id` mediumint(8) unsigned NOT NULL, 
35     UNIQUE KEY `uid_group_id` (`uid`,`group_id`),  
36     KEY `uid` (`uid`), 
37     KEY `group_id` (`group_id`)
38 ) ENGINE=MyISAM DEFAULT CHARSET=utf8;