AuthRule表需扩展icon、sort、is_show等字段,type设为menu,name用英文路径标识(如admin.user.list),pid构建层级,通过一次性查询+PHP引用组装树结构并按用户ID缓存。

ThinkPHP 6 的 AuthRule 表怎么设计才支持动态菜单?
动态菜单权限的前提是菜单本身可被权限系统识别和过滤,不能硬编码在模板里。ThinkPHP 6 的 RBAC 本身不绑定菜单,得靠你把菜单数据和权限规则对齐。
关键点:菜单项必须对应一条 AuthRule 记录,且 type 字段设为 menu(非默认的 url),status 为 1,pid 正确表达层级关系。
-
name字段建议用唯一标识符,如admin.user.list,别用中文或带空格路径 -
title存菜单显示名(如“用户列表”),供前端渲染用 -
icon、sort、is_show这类字段需自己扩展到auth_rule表中,TP6 原生不提供 - 父级菜单的
name可以是admin.user,子项为admin.user.list,这样Auth::getRuleList()才能按前缀匹配做树形展开
如何让 Auth::getRuleList() 返回带父子结构的菜单?
原生 getRuleList() 只返回扁平数组,直接用于菜单渲染会丢层级。得自己组装树,但要注意避免 N+1 查询和重复加载。
推荐做法:一次性查出所有 type = 'menu' 的规则,用 PHP 组装树,缓存 5–10 分钟。别在每次请求都查库。
- 查库时加
order:先按pid升序,再按sort升序,保证父节点一定在子节点前 - 组装树用引用方式,避免递归调用;示例关键逻辑:
$list = Db::name('auth_rule')->where('type', 'menu')->select(); $tree = []; $map = []; foreach ($list as $item) { $map[$item['id']] = $item; if (!$item['pid']) { $tree[] = &$map[$item['id']]; } else { $map[$item['pid']]['children'][] = &$map[$item['id']]; } } - 不要依赖
Auth::check()判断每个菜单是否显示——那是 URL 权限校验,开销大;菜单显隐应基于当前用户已分配的rule_id集合做白名单过滤
用户登录后菜单没更新?检查 Auth::getRoleList() 和缓存键
TP6 的 Auth 类默认用 cache 驱动缓存权限规则,但缓存键只含角色 ID,不包含用户 ID。如果多个用户共用同一角色,但菜单配置不同(比如 A 用户能看到“财务模块”,B 用户看不到),原生缓存机制就会出错。
- 必须重写
Auth::getRuleList(),把缓存键从auth_rule_list_' . $roleId改成auth_rule_list_user_' . $userId - 用户修改角色或菜单权限后,记得手动清除对应用户的缓存:
Cache::delete('auth_rule_list_user_' . $uid) - 别用
Auth::getRuleList($roleId)硬传角色 ID 去查——登录态下应该始终基于当前用户 ID 查其有效规则集 - 如果用了 Redis,注意缓存过期时间别设太长;菜单变更频繁的后台,300 秒比 3600 秒更稳妥
前端路由和后端菜单权限怎么对齐不踩坑?
前后端分离项目最容易在这里翻车:前端写了 /admin/order/detail 路由,但后端 auth_rule 里只配了 admin.order,结果菜单显示了,点击却 403。
- URL 权限(
type=url)和菜单权限(type=menu)要分开建模,但命名最好有继承关系:菜单admin.order→ 对应 URL 规则admin/order/list、admin/order/detail等 - 前端菜单点击跳转前,建议加一层 JS 校验:
if (!hasPermission('admin.order.detail')) { notify('无权访问'); return; },权限数据可随菜单 JSON 一起下发,避免额外请求 - 别在中间件里用
Auth::check($request->url())做全量拦截——ThinkPHP 的url()返回的是带域名的完整地址,而AuthRule.name存的是路径片段,匹配必然失败;应统一用$request->path()提取 PATH_INFO
真正麻烦的不是配置几条规则,而是菜单、路由、按钮、API 接口这四层权限粒度混在一起时,哪一层该由谁校验、缓存怎么拆、错误提示怎么透出——这些细节不提前约定,上线后就是线上事故的温床。
php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!











