目录

第 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 控制器中的权限控制

snippet.php
// 跳过登录验证
protected $noNeedLogin = ['index'];
 
// 跳过权限验证(仍需登录)
protected $noNeedRight = ['detail'];

5.6 数据级权限

菜单节点控制「能不能访问」,业务上常需控制「能看哪些数据」。常见做法:

snippet.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 权限骨架:菜单规则管入口,角色组管集合,管理员管身份。下一章进入插件开发,把功能做成可分发的插件。