FastAdmin 采用经典 RBAC(基于角色的访问控制):
管理员(Admin) → 角色组(AuthGroup) → 菜单规则(AuthRule)
相关数据表:fa_admin、fa_auth_group、fa_auth_group_access、fa_auth_rule。
后台「权限管理 → 角色组」:
「权限管理 → 管理员」中创建账号并指派角色组。开发中常用:
* 通配权限,不逐节点校验「权限管理 → 菜单规则」维护整棵节点树:
| 字段 | 说明 |
| 名称 | 规则标识,格式 控制器/方法,如 article/index |
| 标题 | 后台菜单显示名 |
| 图标 | Font Awesome 图标类名 |
| 是否菜单 | 仅作为权限节点时可关闭,不出现在左侧菜单 |
| 排序 | 菜单显示顺序 |
菜单规则页提供「一键生成」:选择控制器后自动为其方法(index/add/edit/del/multi 等)批量创建子节点。使用一键 CRUD 生成模块后,通常在此补建菜单。
// 跳过登录验证 protected $noNeedLogin = ['index']; // 跳过权限验证(仍需登录) protected $noNeedRight = ['detail'];
$noNeedLogin:完全公开的方法,谨慎使用$noNeedRight:登录即可访问,常用于详情弹窗等辅助方法控制器/方法 匹配规则节点校验菜单节点控制「能不能访问」,业务上常需控制「能看哪些数据」。常见做法:
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 自定义字段实现。
RBAC 三表一树构成 FastAdmin 权限骨架:菜单规则管入口,角色组管集合,管理员管身份。下一章进入插件开发,把功能做成可分发的插件。