ThinkPHP 5.1可通过缓存+RBAC实现权限缓存机制：按用户、角色、节点分层设计缓存键；登录/权限变更时主动写入；中间件中读取校验；权限更新后及时清理对应缓存确保一致性。
ThinkPHP 5.1 本身不内置“权限缓存”这一独立模块，但可通过组合使用框架的缓存能力、RBAC逻辑与运行时数据预加载，实现高效、可维护的权限缓存机制。核心思路是：把用户角色、节点权限关系、路由/操作白名单等动态计算结果，在首次访问后缓存起来，后续请求直接读取，避免重复查库或递归判断。
一、设计缓存键结构，确保权限数据可区分、可刷新
权限缓存必须按用户维度隔离，同时支持按角色、模块或权限节点粒度清理。推荐使用如下键名格式：
-
用户级权限缓存：
auth_user_{$uid}（如auth_user_123），存储该用户拥有的全部可访问路由/操作数组 -
角色级权限缓存：
auth_role_{$roleId}，存储该角色绑定的所有节点 ID 列表 -
节点路径映射缓存：
auth_node_map，缓存节点标识（如admin/user/edit）到权限 ID 的映射，用于快速校验
二、在登录/权限变更后主动写入缓存
不要依赖运行时实时查询，而应在关键节点触发缓存生成。例如在用户登录成功后：
- 查询用户所属角色 → 获取角色权限节点列表 → 合并去重 → 生成路由/方法白名单数组
- 用
Cache::set('auth_user_'.$uid, $permissions, 3600)写入，有效期建议 1 小时（可根据业务敏感度调整） - 若使用 Redis，还可设置带前缀的标签（如
Cache::tag('auth')->set(...)），便于批量清除所有权限缓存
三、中间件中读取并校验缓存权限
新建一个权限验证中间件（如 app/middleware/AuthCheck.php），在请求进入控制器前完成校验：
立即学习“PHP免费学习笔记（深入）”；
- 从 Request 或 Session 中获取当前用户 ID
- 用
Cache::get('auth_user_'.$uid)读取缓存权限列表 - 提取当前请求的
$request->controller() . '/' . $request->action()或自定义路由标识 - 检查该标识是否存在于缓存数组中；不存在则拒绝访问（返回 403 或跳转）
- 若缓存未命中（如首次访问或过期），可 fallback 到数据库查询，并自动回填缓存
四、提供权限变更后的缓存清理接口
当管理员修改角色权限、分配用户角色或新增菜单节点时，必须同步失效相关缓存：
- 更新角色权限后，调用
Cache::rm('auth_role_'.$roleId)和Cache::clear('auth')（若用了标签） - 给用户更换角色后，清除其用户级缓存：
Cache::rm('auth_user_'.$uid) - 可封装为公共方法，例如在权限管理控制器中：
if ($userId) Cache::rm('auth_user_'.$userId);
if ($roleId) Cache::rm('auth_role_'.$roleId);
Cache::rm('auth_node_map');
$this->success('权限缓存已刷新');
}
不复杂但容易忽略的是缓存一致性——只要权限数据变了，缓存就必须及时失效，否则会出现“改了权限却没生效”的问题。建议配合日志记录关键缓存操作，便于排查。
