Yii Srbac 權限管理擴展完整指南：從安裝到實戰應用

Yii Srbac 權限管理擴展完整指南：從安裝到實戰應用

在 Yii 框架開發中，基於角色的存取控制（RBAC）是實現精細權限管理的核心機制。雖然 Yii 內建的 authManager 元件已提供 RBAC 基礎架構，但缺乏視覺化管理介面。Srbac 作為官方推薦的擴展模組，完美填補了這一空白，讓開發者能輕鬆以圖形化方式管理角色、任務與操作。

核心概念：RBAC 權限層級結構

理解 Srbac 必須先掌握四個核心實體的關係：

• 授權項目：權限判斷的基本單位，分為三類：
• 角色：最高層級，由多個任務組成（如「管理員」、「編輯」）
• 任務：中間層級，由多個操作組成（如「文章管理」、「用戶管理」）
• 操作：最底層權限，不可再分（如「刪除文章」、「發布評論」）

此外，業務規則是一段 PHP 代碼片段，在權限檢查時動態執行，可實現「僅允許作者刪除自己的文章」等複雜邏輯。

資料庫結構：三張核心表

Srbac 依賴以下三張表存儲權限數據：

1. authassignment（用戶-角色關聯表）

2. authitem（授權項目表）

3. authitemchild（父子層級關係表）

權限檢查核心方法

使用 CWebUser::checkAccess() 進行權限驗證：

if (Yii::app()->user->checkAccess($operation, $params)) {
    // $operation：角色、任務或操作名稱
    // $params：傳遞給業務規則的參數陣列
    // 執行受保護操作
}

實戰範例：文章刪除權限控制

$params = array('uid' => $article->author_id);
if (Yii::app()->user->checkAccess('delArticle', $params)) {
    // 通過業務規則驗證：當前用戶 ID 是否等於文章作者 ID
    $article->delete();
}

Srbac 運作原理深度解析

1. 模組初始化配置

在模組配置文件中定義資料表映射：

public function init() {
    Yii::app()->authManager->itemTable = 'AuthItem';
    Yii::app()->authManager->itemChildTable = 'AuthItemChild';
    Yii::app()->authManager->assignmentTable = 'UserAssignment';
}

2. 控制器繼承 SBaseController

class ProductController extends SBaseController { ... }
class SBaseController extends Controller { ... }

3. beforeAction 權限攔截邏輯

protected function beforeAction($action) {
    $del = Helper::findModule('srbac')->delimeter;
    $mod = $this->module !== null ? $this->module->id . $del : "";
    $controller = str_replace("/", ".", $this->id);
    $contrArr = explode("/", $controller);
    $contrArr[sizeof($contrArr)-1] = ucfirst($contrArr[sizeof($contrArr)-1]);
    $controller = implode(".", $contrArr);
    if (sizeof($contrArr) == 1) $controller = ucfirst($controller);
    
    $access = $mod . $controller . ucfirst($this->action->id);
    
    // 白名單檢查
    if (in_array($access, $this->allowedAccess())) return true;
    
    // 未安裝或除錯模式跳過驗證
    if (!Yii::app()->getModule('srbac')->isInstalled()) return true;
    if (Yii::app()->getModule('srbac')->debug) return true;
    
    // 核心權限驗證
    if (!Yii::app()->user->checkAccess($access) || Yii::app()->user->isGuest) {
        $this->onUnauthorizedAccess();
    }
    return true;
}

4-7. CDbAuthManager 核心查詢與遞迴驗證流程

框架依序執行：

1. getAuthAssignments() 讀取用戶角色分配
2. getAuthItem() 獲取授權項目詳情
3. checkAccessRecursive() 遞迴檢查父子層級權限
4. executeBizRule() 執行業務規則判斷

Srbac 實戰部署步驟

步驟 1：安裝與測試數據生成

將模組放入 protected/modules/，配置 main.php 後訪問安裝頁面，可選擇生成測試數據。

步驟 2：建立權限體系（對應介面第一個圖標）

• 操作：命名格式 ControllerNameActionName（如 PostControllerDelete），首字母大寫
• 任務：功能性分組命名（如 NewsManagement）
• 角色：直接輸入角色名稱（如 admin、editor）

步驟 3：權限映射分配（第二個圖標）

1. 將操作分配給對應任務
2. 將任務分配給角色
3. 將角色指派給具體用戶

步驟 4：驗證與啟用（第三個圖標）

檢查用戶權限矩陣是否正確，確認無誤後務必關閉 debug 模式：

'modules' => array(
    'srbac' => array(
        'userclass' => 'User',
        'userid' => 'id',
        'username' => 'username',
        'debug' => false,  // 關鍵：生產環境必須設為 false
    )
)

常見問題與最佳實踐

• 操作命名規範：嚴格遵循 ControllerAction 格式，否則自動掃描失效
• 業務規則安全：避免在 bizrule 中使用 eval()，優先用參數化查詢
• 效能優化：大型專案建議快取 RBAC 權限陣列，減少資料庫查詢
• 多模組支援：利用分隔符（預設 -）區分模組權限，如 admin-PostControllerDelete

掌握 Srbac 核心機制與部署流程，即可為 Yii 應用構建企業級權限管理系統，實現資源存取的精細化控制。