ThinkPHP中数据权限控制需通过DbScopeMiddleware中间件在HTTP中间件链末尾注册,确保认证后获取用户身份并动态生成部门/角色过滤条件,禁止手动拼接SQL,且须兼容软删除逻辑。

在ThinkPHP中实现数据库层面的数据权限控制,必须让每条SELECT/UPDATE/DELETE语句自动注入当前用户可访问的数据范围条件,避免开发者手动拼接where导致遗漏或SQL注入。
数据权限过滤中间件的注册与触发时机
在app/middleware.php的'http'数组末尾添加DbScopeMiddleware::class,确保它在路由匹配完成、控制器执行前运行,但晚于认证中间件——因为需要先确认用户身份才能获取其部门ID或角色信息。
不要将该中间件注册在'app'数组里,否则它会在请求解析前就执行,此时session尚未初始化,【无法读取session('user.id')】,会导致$userId为空,最终生成where['id'=>0]这种无效过滤。
中间件类必须继承think\middleware\BaseMiddleware,并在handle方法中调用$this->injectDataScope($request)完成条件注入。
立即学习“PHP免费学习笔记(深入)”;
数据范围条件的动态生成逻辑
在DbScopeMiddleware类中定义getDataScopeWhere()方法,按角色返回不同条件:
方法一:超管直接放行
if (session('user.role_name') === 'admin') { return []; }
方法二:部门负责人只查本部门数据
if (session('user.role_name') === 'dept_leader') { $deptId = Db::name('user')->where('id', session('user.id'))->value('dept_id'); return ['dept_id' => $deptId]; }
方法三:仅查看自己创建的数据
if (session('user.role_name') === 'self_only') { return ['created_by' => session('user.id')]; }
【默认返回['id'=>0],确保未匹配任何角色时查不到任何记录】,而不是空数组,否则会变成全表扫描。
查询构建器的条件合并与软删除兼容
第一步:在模型的select()、update()、delete()等操作前,调用$where = array_merge($this->getDataScopeWhere(), $extraWhere);
第二步:将合并后的$where传入where()方法:$this->where($where)->select();
第三步:若模型启用软删除(delete_time字段),必须确保数据权限条件与whereNotNull('delete_time')处于同一级where容器中——【如果写成where($where)->whereNotNull('delete_time'),后者会被前者覆盖】,正确写法是:$this->where($where)->whereNotNull('delete_time')->select()。
这一步操作起来很简单,直接把whereNotNull放在where之后就行,但顺序错了就会漏掉软删除逻辑。
避免常见安全陷阱
禁止在控制器里重复写where('dept_id', $deptId),字段名容易拼错,且一旦新增模型就可能遗漏。
禁止用字符串拼接SQL,例如"AND dept_id = {$deptId}",既无法被查询缓存识别,又存在SQL注入风险。
所有数据权限条件必须通过Db::name()->where()链式调用注入,由ThinkPHP底层自动参数绑定和转义。



















