Yii2 RBAC 權限控制操作步驟完整教學

前置條件

已完成 Yii2 後台搭建與 RBAC 基礎架構（參考前文），具備：auth_item、auth_item_child、auth_assignment、menu、route 等資料表。

實戰流程：以「用戶管理」為例

1. 建立資料表與模型

建立 user 表，使用 GII 生成 Model + CRUD。

2. 同步路由

訪問 /admin/route/index，點擊「刷新」同步最新路由，將 /user/* 系列移至右側授權區。

3. 新增權限

訪問 /admin/permission/index → 新增權限：

• 名稱：用戶管理
• 描述：用戶增刪改查權限

進入權限詳情，將 /user/* 路由移入授權區。

4. 建立角色並分配權限

訪問 /admin/role/index → 新增角色「用戶管理員」 → 詳情頁將「用戶管理」權限移入。

5. 分配角色給用戶

訪問 /admin/assignment/index，為目標用戶勾選「用戶管理員」角色。

6. 顯示於左側選單

訪問 /admin/menu/index 新增選單項，父級留空、路由指向 /user/index、排序值設定。

驗證與除錯

• 登入該用戶，確認左側選單出現「用戶管理」
• 點擊進入 /user/index 應正常顯示列表
• 若提示無權限，檢查：路由同步、權限遞歸、角色分配、選單可見性

進階技巧

使用 mdm\admin\components\Helper::checkRoute() 在視圖中控制按鈕顯示；Helper::filterActionColumn() 自動過濾 GridView 操作欄。