# 前言 ***** ### 对于后台管理系统,权限管理是最基本的一共功能, 一般会涉及3个概念 用户 角色 权限,今天将和大家分享一个最基本的权限设计, 涉及到4个表 + **用户表**<code>user</code> + **角色表** <code>role</code> + **权限表** <code>rule</code> + **角色-权限表** <code>role_rule </code>  > 因角色标识直接记录在<code>user</code> 表中的<code>role_guid</code> 字段,所有没有设计<code>user_role</code>表. ## 数据库设计 ### 用户表<code>user</code> | 字段 | 类型 | 描述 | --- | --- |---| | guid| char(36)|用户唯一标识 主键| | parent_guid| char(36)| 父级菜单唯一标识| | account| varchar(100)| 登陆账号| | name| varchar(100)| 用户姓名| | password| varchar(100)| 登陆密码| | role_guid| char(36)| 角色唯一标识| | status| tinyint(2)| 状态| | create_time| datetime(3)| 创建时间| | update_time| datetime(3)| 更新时间| | delete_time| datetime(3)| 删除时间| ``` DROP TABLE IF EXISTS `user`; CREATE TABLE `user` ( `guid` char(36) CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci NOT NULL COMMENT '主键', `account` varchar(100) CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci NOT NULL COMMENT '工号', `name` varchar(32) CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci NOT NULL COMMENT '用户姓名', `password` varchar(64) CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci NOT NULL COMMENT '用户密码', `role_guid` char(36) CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci NOT NULL COMMENT '角色唯一标识', `status` tinyint(2) NOT NULL DEFAULT 0 COMMENT '是否启用', `tel` char(11) CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci NOT NULL DEFAULT '' COMMENT '电话号码', `create_time` datetime(3) NOT NULL COMMENT '创建时间', `update_time` datetime(3) NOT NULL COMMENT '更新时间', `delete_time` datetime(3) NULL DEFAULT NULL COMMENT '删除时间', PRIMARY KEY (`guid`) USING BTREE ) ENGINE = InnoDB CHARACTER SET = utf8mb4 COLLATE = utf8mb4_general_ci ROW_FORMAT = Compact; SET FOREIGN_KEY_CHECKS = 1; ``` ### 角色表<code>role</code> | 字段 | 类型 | 描述 | --- | --- |---| | guid| char(36)|角色唯一标识 主键| | type| tinyint(2)| 登陆账号| | name| varchar(100)| 用户姓名| | status| tinyint(2)| 状态| | create_time| datetime(3)| 创建时间| | update_time| datetime(3)| 更新时间| | delete_time| datetime(3)| 删除时间| ``` DROP TABLE IF EXISTS `role`; CREATE TABLE `role` ( `guid` char(36) NOT NULL, `type` tinyint(2) NOT NULL DEFAULT '2' COMMENT '1管理员,2操作员', `name` varchar(32) NOT NULL COMMENT '角色名称', `status` tinyint(1) NOT NULL DEFAULT '1' COMMENT '是否启用', `remark` varchar(255) DEFAULT '' COMMENT '简单说明', `delete_time` datetime DEFAULT NULL COMMENT '删除时间', `create_time` datetime(3) DEFAULT NULL COMMENT '创建时间', `update_time` datetime(3) DEFAULT NULL COMMENT '更新时间', PRIMARY KEY (`guid`) USING BTREE ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 ROW_FORMAT=COMPACT COMMENT='角色表'; ``` ### 权限表<code>rule</code> | 字段 | 类型 | 描述 | --- | --- |---| | guid| char(36)|角色唯一标识 主键| | parent_guid| char(36) | 父级菜单唯一标识| | name| varchar(100)| url地址| | title| varchar(100)| 菜单名称| | icon| varchar(100)| 图标| | is_auth| tinyint(2)| 是否鉴权 | | is_link| tinyint(2)| 是否鉴权 1是0否| | status| tinyint(2)| 状态| | sort| int(4)| 排序| | create_time| datetime(3)| 创建时间| | update_time| datetime(3)| 更新时间| ``` DROP TABLE IF EXISTS `rule`; CREATE TABLE `rule` ( `guid` char(36) NOT NULL, `parent_guid` char(36) DEFAULT NULL COMMENT '父级菜单唯一标识', `name` varchar(100) NOT NULL COMMENT 'url地址', `title` varchar(100) NOT NULL COMMENT '菜单名称', `icon` varchar(100) DEFAULT NULL COMMENT '图标', `is_auth` tinyint(2) NOT NULL DEFAULT '1' COMMENT '是否鉴权 1是0否', `is_link` tinyint(2) NOT NULL DEFAULT '0' COMMENT '是否菜单 1是0否(比如api接口路径)', `sort` int(4) NOT NULL DEFAULT '255' COMMENT '排序', `status` tinyint(1) DEFAULT '1' COMMENT '状态1可用,0不可用', `update_time` datetime(3) NOT NULL COMMENT '更新时间', `create_time` datetime(3) NOT NULL COMMENT '创建时间', PRIMARY KEY (`guid`) USING BTREE, UNIQUE KEY `rulename` (`name`) USING BTREE ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 ROW_FORMAT=COMPACT COMMENT='权限&菜单表'; ``` ### 角色&权限表<code>role_rule</code> | 字段 | 类型 | 描述 | --- | --- |---| | role_guid| char(36)|角色唯一标识| | rule_guid| char(36)|权限唯一标识| ``` DROP TABLE IF EXISTS `role_rule`; CREATE TABLE `role_rule` ( `role_guid` char(36) NOT NULL COMMENT '角色唯一标识', `rule_guid` char(36) NOT NULL COMMENT '权限唯一标识', UNIQUE KEY `uk_role_guid_rule_guid` (`role_guid`,`rule_guid`) USING BTREE ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 ROW_FORMAT=COMPACT COMMENT='角色权限关联表'; ``` ## 本文重点讲述如何利用缓存来判断用户权限 >[warning] 请注意Thinkphp5.1.6+之后的版本才支持中间件。 官方中间件文档:阅读 https://www.kancloud.cn/manual/thinkphp5_1/564279 我们使用 thinkphp5的中间件特性来做统一验证, 首先我们在<code> application/test/middleware</code> 目录中创建 中间件文件 <code>Auth.php</code>文件 ```<?php namespace app\test\middleware; use app\common\model\Rule; use think\Controller; class Auth extends Controller { /** * 默认返回资源类型 * @var \think\Request $request * @var mixed $next * @var string $name * @throws \Exception * @return mixed */ public function handle($request, \Closure $next, $name) { $path = strtolower($request->controller() . '/' . $request->action()); $db_rule = new Rule(); $role_guid = ''; //todo 实际应用中 可以通过请求中携带access_token 利用JWT验证后 将得到的用户信息(user_guid/role_guid 等等 传入到model中获取 或者用session传递 if ($db_rule->checkRule($path, $role_guid) === false) { return json(['code' => -1, 'message' => '抱歉您没有权限!']); } return $next($request); } } ``` 然后在<code>application\test</code>目录下 新建<code>middleware.php</code>文件. ```<?php // 中间件扩展定义文件 return [ 'auth' => app\test\middleware\Auth::class ]; ``` ##模型<code>Rule</code>中部分代码参考 ``` <?php namespace app\common\model; use think\Db; use think\Model; class Rule extends Model { protected $pk = 'guid'; protected $exp = 3600 * 24; protected $type = [ 'is_link' => 'integer', 'is_auth' => 'integer', 'sort' => 'integer' ]; /** * 验证角色是否有权限 * @param string $path 当前路径 * @param string $role_guid 角色标识,没有传role_guid 获取登陆用户的用户组 * @throws \Exception * @return bool */ public function checkRule($path = '', $role_guid = null) { // 没有传path地址获取当前 if ($path == '') { $request = request(); $path = strtolower($request->controller() . '/' . $request->action()); } //只要当前请求路径是白名单中(rule表中is_auth=0)或者该用户已经有权限 则校验通过 return in_array($path, $this->getNoAuthRule()) || in_array($path, $this->getPermissionByRoleGuid($role_guid)); } /** * 获取白名单列表 * @throws \Exception * @return array */ public function getNoAuthRule() { $db = new Rule(); //使用cache写法如果存在缓存则不会查询数据库,非常方便 return $db->cache('rule:no_auth_list', $this->exp)->where('is_auth', 0)->column('name'); } /** * 根据角色guid获取权限列表 * @param string|null $role_guid 角色标识 * @throws \Exception * @return array */ public function getPermissionByRoleGuid($role_guid) { $cache_key = 'rule:role:' . $role_guid; $map = [ ['r.status', '=', 1], ['r.is_auth', '=', 1], ['rr.role_guid', '=', $role_guid] ]; $join = [['__RULE__ r', 'rr.rule_guid=r.guid']]; //使用cache写法如果存在缓存则不会查询数据库,非常方便 return Db::name('role_rule')->alias('rr')->join($join)->where($map)->cache($cache_key, $this->exp)->column('r.name'); } } ``` ## 开发帮助及交流 如您对本文感兴趣想与我联系交流 您可以 + 邮件至：xieyongfa@ecarde.cn + QQ：2392523899 [点我聊天](http://wpa.qq.com/msgrd?v=3&uin=2392523899&site=qq&menu=yes&from=message&isappinstalled=0) + 微信交流