fastadmin:权限管理与菜单规则

第 05 章 权限管理与菜单规则

FastAdmin 采用经典 RBAC(基于角色的访问控制):

管理员(Admin) → 角色组(AuthGroup) → 菜单规则(AuthRule)
  • 角色组:权限的集合,如「超级管理员」「运营」「财务」
  • 管理员:必须属于一个或多个角色组,继承其权限
  • 菜单规则:每个控制器方法对应一条规则节点,控制菜单显示与访问权限

相关数据表:fa_admin、fa_auth_group、fa_auth_group_access、fa_auth_rule。

后台「权限管理 → 角色组」:

  1. 新建角色组,设置父级(权限不能超出父级范围)
  2. 在「权限」选项卡勾选该组可访问的规则节点
  3. 注意「一级角色组」可继续创建子角色组并向下授权

「权限管理 → 管理员」中创建账号并指派角色组。开发中常用:

  • 超级管理员拥有 * 通配权限,不逐节点校验
  • 新增管理员默认无任何菜单,必须授权后才能看到后台功能

「权限管理 → 菜单规则」维护整棵节点树:

字段 说明
名称 规则标识,格式 控制器/方法,如 article/index
标题 后台菜单显示名
图标 Font Awesome 图标类名
是否菜单 仅作为权限节点时可关闭,不出现在左侧菜单
排序 菜单显示顺序

菜单规则页提供「一键生成」:选择控制器后自动为其方法(index/add/edit/del/multi 等)批量创建子节点。使用一键 CRUD 生成模块后,通常在此补建菜单。

snippet.php
// 跳过登录验证
protected $noNeedLogin = ['index'];
 
// 跳过权限验证(仍需登录)
protected $noNeedRight = ['detail'];
  • $noNeedLogin:完全公开的方法,谨慎使用
  • $noNeedRight:登录即可访问,常用于详情弹窗等辅助方法
  • 其他方法会自动按 控制器/方法 匹配规则节点校验

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

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 自定义字段实现。

  • 新增功能看不到菜单:规则已生成但未勾选「是否菜单」,或未给角色组授权
  • 点击提示无权限:方法名未在规则中存在;用「一键生成」补齐
  • 子管理员越权:角色组父子关系配置错误,子组权限不能超出父组

RBAC 三表一树构成 FastAdmin 权限骨架:菜单规则管入口,角色组管集合,管理员管身份。下一章进入插件开发,把功能做成可分发的插件。

该主题尚不存在

您访问的页面并不存在。如果允许,您可以使用创建该页面按钮来创建它。

  • fastadmin/权限管理与菜单规则.txt
  • 最后更改: 2026/08/19 11:34
  • 由 张叶安