# 第 05 章 权限管理与菜单规则 ## 5.1 RBAC 模型 FastAdmin 采用经典 RBAC(基于角色的访问控制): ``` 管理员(Admin) → 角色组(AuthGroup) → 菜单规则(AuthRule) ``` - **角色组**:权限的集合,如「超级管理员」「运营」「财务」 - **管理员**:必须属于一个或多个角色组,继承其权限 - **菜单规则**:每个控制器方法对应一条规则节点,控制菜单显示与访问权限 相关数据表:`fa_admin`、`fa_auth_group`、`fa_auth_group_access`、`fa_auth_rule`。 ## 5.2 角色组管理 后台「权限管理 → 角色组」: 1. 新建角色组,设置父级(权限不能超出父级范围) 2. 在「权限」选项卡勾选该组可访问的规则节点 3. 注意「一级角色组」可继续创建子角色组并向下授权 ## 5.3 管理员管理 「权限管理 → 管理员」中创建账号并指派角色组。开发中常用: - 超级管理员拥有 `*` 通配权限,不逐节点校验 - 新增管理员默认无任何菜单,必须授权后才能看到后台功能 ## 5.4 菜单规则 「权限管理 → 菜单规则」维护整棵节点树: | 字段 | 说明 | | 名称 | 规则标识,格式 `控制器/方法`,如 `article/index` | | 标题 | 后台菜单显示名 | | 图标 | Font Awesome 图标类名 | | 是否菜单 | 仅作为权限节点时可关闭,不出现在左侧菜单 | | 排序 | 菜单显示顺序 | ### 快速生成节点 菜单规则页提供「一键生成」:选择控制器后自动为其方法(index/add/edit/del/multi 等)批量创建子节点。使用一键 CRUD 生成模块后,通常在此补建菜单。 ## 5.5 控制器中的权限控制 ```php // 跳过登录验证 protected $noNeedLogin = ['index']; // 跳过权限验证(仍需登录) protected $noNeedRight = ['detail']; ``` - `$noNeedLogin`:完全公开的方法,谨慎使用 - `$noNeedRight`:登录即可访问,常用于详情弹窗等辅助方法 - 其他方法会自动按 `控制器/方法` 匹配规则节点校验 ## 5.6 数据级权限 菜单节点控制「能不能访问」,业务上常需控制「能看哪些数据」。常见做法: ```php public function _initialize() { parent::_initialize(); $this->adminId = $this->auth->id; } public function index() { if (!$this->auth->isSuperAdmin()) { $this->request->filter(['admin_id' => $this->adminId]); } return parent::index(); } ``` 即在列表查询中强制追加当前管理员条件,实现「只能看自己的数据」。更复杂的部门树权限可结合 `fa_admin` 自定义字段实现。 ## 5.7 常见问题 - **新增功能看不到菜单**:规则已生成但未勾选「是否菜单」,或未给角色组授权 - **点击提示无权限**:方法名未在规则中存在;用「一键生成」补齐 - **子管理员越权**:角色组父子关系配置错误,子组权限不能超出父组 ## 本章小结 RBAC 三表一树构成 FastAdmin 权限骨架:菜单规则管入口,角色组管集合,管理员管身份。下一章进入插件开发,把功能做成可分发的插件。