ThinkPHP中间件如何实现用户权限RBAC校验【安全】

冬枫大大_2561

冬枫大大_2561

2026-06-30

471人浏览

原创

thinkphp 6 rbac权限中间件必须注册在app/middleware.php的'http'数组靠后位置,确保路由匹配完成后执行;需通过$request->rule()->getname()获取显式命名的路由名,走用户→角色→权限三级查询,对游客跳登录、超管短路放行,并区分页面与ajax响应格式。

thinkphp中间件如何实现用户权限rbac校验【安全】

中间件注册位置必须在路由匹配之后

权限校验中间件如果注册太早,$request->rule()->getName() 会返回空或反射路径(如 '\app\controller\Admin\UserController@list'),根本拿不到真实路由名,导致权限比对永远失败。它必须在路由解析完成、控制器尚未执行的阶段介入。

正确做法是把中间件加到 app/middleware.php 的 'http' 数组靠后位置,例如放在 SessionInit 和 AllowCrossDomain 之后,但不能在 CheckAuth 这类已有鉴权中间件之后重复叠加:

  • 确保中间件类中调用 $request->rule()->getName() 能稳定输出类似 'admin.user.list' 的字符串
  • 若返回为空,检查路由是否显式命名:比如 Route::get('admin/user/list', 'admin.UserController@list')->name('admin.user.list')
  • 别依赖 $request->url() 或拼接 $request->controller() . '.' . $request->action(),大小写和命名风格易出错

权限校验必须走「用户→角色→权限」三级链路

直接查 user_permission 关联表或把权限塞进用户 JSON 字段,会导致角色变更不生效、无法审计、索引失效。RBAC 的语义核心是“角色继承”,校验依据只能是当前用户激活角色所关联的全部 auth_rule.rule_name。

中间件里应按顺序查:

  • 先根据 $uid 查 auth_group_access 表得 role_id 列表
  • 再用这些 role_id 查 auth_role_rule 得 rule_id 集合
  • 最后联查 auth_rule 表,提取 rule_name 字符串数组(如 ['admin.user.list', 'admin.user.delete'])
  • 缓存这组数据,key 建议为 'auth_rules_by_user_' . $uid,过期时间设为 30 分钟

注意:不要缓存全量权限再做 in_array,而应缓存每个用户专属的白名单——否则 A 用户删了权限,B 用户的缓存未刷新,就会误放行。

btpanel phpsite 宝塔面板PHP网站
btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理:站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

游客、超管必须短路处理,且顺序不能错

中间件最开头就要判断两类特殊身份,否则后续所有查询和缓存读取都是浪费:

  • 游客(未登录):检查 Auth::id() 或 session('user_id') 是否存在,不存在则跳转登录页或返回 JSON 错误
  • 超级管理员:查用户表 is_super = 1 字段,命中即 return $next($request) 放行,**绝不能放在这段逻辑之后**
  • 超管跳过权限检查,但不能跳过登录态验证——先确认是合法登录用户,再判是否为超管

常见错误是把超管判断写在缓存读取之后,结果每次请求都触发 DB 查询或 Redis 读取,性能白白损耗。

接口与页面请求要区分响应格式

同一个中间件拦截 GET /admin/user/123 页面请求和 DELETE /api/v1/user/123 AJAX 请求,但前端需要完全不同的反馈方式:

  • 页面请求(非 AJAX):重定向到 403 模板页或后台首页
  • AJAX 请求:返回标准 JSON:['code'=>403, 'msg'=>'无操作权限'],状态码设为 403
  • 判断依据用 $request->isAjax() + $request->header('accept') === 'application/json' 双保险,避免某些前端框架漏传 X-Requested-With

别让前端卡在控制台看不到错误,也别让页面跳转时把 403 当成普通 HTML 渲染——这两类响应必须在中间件里明确分支处理。

权限校验不是“写了中间件就完事”,关键在于每一步数据来源是否可信、缓存 key 是否带用户上下文、短路逻辑是否前置。最容易被忽略的是:路由名没对齐、超管判断放错位置、AJAX 响应没适配,这三处一错,整个 RBAC 就形同虚设。

php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!

相关文章

PHP速学教程(入门到精通)
PHP速学教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

thinkphp php

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
php文件怎么打开
php文件怎么打开

打开php文件步骤:1、选择文本编辑器;2、在选择的文本编辑器中,创建一个新的文件,并将其保存为.php文件;3、在创建的PHP文件中,编写PHP代码;4、要在本地计算机上运行PHP文件,需要设置一个服务器环境;5、安装服务器环境后,需要将PHP文件放入服务器目录中;6、一旦将PHP文件放入服务器目录中,就可以通过浏览器来运行它。

2023.09.01

10624

6

php怎么取出数组的前几个元素
php怎么取出数组的前几个元素

取出php数组的前几个元素的方法有使用array_slice()函数、使用array_splice()函数、使用循环遍历、使用array_slice()函数和array_values()函数等。本专题为大家提供php数组相关的文章、下载、课程内容,供大家免费下载体验。

2023.10.11

6221

5

php反序列化失败怎么办
php反序列化失败怎么办

php反序列化失败的解决办法检查序列化数据。检查类定义、检查错误日志、更新PHP版本和应用安全措施等。本专题为大家提供php反序列化相关的文章、下载、课程内容,供大家免费下载体验。

2023.10.11

2135

5

php怎么连接mssql数据库
php怎么连接mssql数据库

连接方法:1、通过mssql_系列函数;2、通过sqlsrv_系列函数;3、通过odbc方式连接;4、通过PDO方式;5、通过COM方式连接。想了解php怎么连接mssql数据库的详细内容,可以访问下面的文章。

2023.10.23

3928

4

php连接mssql数据库的方法
php连接mssql数据库的方法

php连接mssql数据库的方法有使用PHP的MSSQL扩展、使用PDO等。想了解更多php连接mssql数据库相关内容,可以阅读本专题下面的文章。

2023.10.23

4634

6

html怎么上传
html怎么上传

html通过使用HTML表单、JavaScript和PHP上传。更多关于html的问题详细请看本专题下面的文章。php中文网欢迎大家前来学习。

2023.11.03

3631

9

PHP出现乱码怎么解决
PHP出现乱码怎么解决

PHP出现乱码可以通过修改PHP文件头部的字符编码设置、检查PHP文件的编码格式、检查数据库连接设置和检查HTML页面的字符编码设置来解决。更多关于php乱码的问题详情请看本专题下面的文章。php中文网欢迎大家前来学习。

2023.11.09

5197

8

php文件怎么在手机上打开
php文件怎么在手机上打开

php文件在手机上打开需要在手机上搭建一个能够运行php的服务器环境,并将php文件上传到服务器上。再在手机上的浏览器中输入服务器的IP地址或域名,加上php文件的路径,即可打开php文件并查看其内容。更多关于php相关问题,详情请看本专题下面的文章。php中文网欢迎大家前来学习。

2023.11.13

4062

8

sprintf函数用法详解
sprintf函数用法详解

sprintf函数的用法:1、格式化字符串;2、指定输出宽度和精度;3、返回值。更多关于sprintf函数用法详解的内容,大家可以阅读下面的文章。

2023.11.27

12002

4

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程