浅谈Yii-admin的权限控制
Posted Yofy
tags:
篇首语：本文由小常识网(cha138.com)小编为大家整理，主要介绍了浅谈Yii-admin的权限控制相关的知识，希望对你有一定的参考价值。
说到CMS，最需要有的东西就是权限控制，特别是一些复杂的场景，多用户，多角色，多部门，子父级查看等等。最近在开发一个线下销售的东东，这个系统分为管理员端，省代端，客户端，门店端，销售端， 部门端，部门老大下面分子部门等等，恶心的需求。我们这个项目使用yii框架开发，yii在php届还是比较流行的，虽然说laravel现在横行，但是一些部门一些团队还是采用了yii框架，比如我们。
我是刚接触yii这个框架，开始的时候对这种面向组件的框架甚是别扭。当时打算自己写权限的，自己创建权限表，关联表等，但是学习使用yii开发文档后，发现有个权限控制RBAC，借助于yii-admin可以实现完美的权限，菜单的控制。这篇博客分两部门，第一部分我会讲述怎么搭建权限管理包括：安装yii-admin，创建权限表，使用权限控制菜单和访问权限等基本的操作，这部分大致说一下，想要看更详细的步骤可以参考这个比较详细的讲解：http://www.manks.top/tag/rbac.html，毕竟搭建和使用都不是难事，只要按照步骤来。第二部分我会讲解我自己的理解，包括：菜单的优化，子页面导航的选择性高亮，分角色显示菜单，权限检测的改进等。
目录：
首先你应该安装一个yii框架，因为yii-admin是基于yii框架的，没有框架玩毛啊！你可以在github上直接下载源码
yii2:https://github.com/yiisoft/yii2
yii2-admin:https://github.com/mdmsoft/yii2-admin
当然你可以使用composer来安装，这样最好不过，如果你安装好了yii，你就可以切换到项目目录下，直接执行下面的命令：
1 php composer.phar require mdmsoft/yii2-admin "~2.0" 2 php composer.phar update
然后配置中加入yii-admin的配置项，值的注意的是如果yii2-admin配置在common目录下是全局生效，那么你在执行命令控制台的时候就会报错，所以应将权限控制作用于web模块，我们这个项目没有使用高级模板，所以你可以直接把配置写在config下面的web.php中，配置如下：
先定义别名：
1 \'aliases\' => [ 2 \'@mdm/admin\' => \'@vendor/mdmsoft/yii2-admin\', 3 ],
在modules中添加admin组件：
1 \'admin\' => [ 2 \'class\' => \'mdm\\admin\\Module\', 3 \'layout\' => \'@app/views/layouts/main_nifty\',//yii2-admin的导航菜单 4 ],
添加添加authManager配置项：
需要强调的是，yii中的authManager组件有PhpManager和DbManager两种方式，这两种方式是由区别的，PhpManager将权限关系保存在文件里，DbManager方式,将权限关系保存在数据库。我们采用保存在数据库中的方式。
1 \'authManager\' => [ 2 \'class\' => \'yii\\rbac\\DbManager\', // or use \'yii\\rbac\\DbManager\' 3 ],
添加as access：
1 \'as access\' => [ 2 \'class\' => \'mdm\\admin\\components\\AccessControl\', 3 \'allowActions\' => [ 4 // add or remove allowed actions to this list 5 // \'admin/*\', 6 //\'*\', 7 \'site/*\', 8 \'api/*\', 9 ] 10 ],
需要说的是未知不要放错了，如下图所示：
这一步不用自己去写，命令行切换到yii2目录，执行下面命令，创建rbac需要的表，但是数据库需要自己创建，名字默认是yii2basic，如果要执行命令，就需要把你刚下配置好的配置文件在在console.php中也写一份，如果执行不成功，可以吧生成数据表的脚本拿出来自己执行。
1 yii migrate --migrationPath=@yii/rbac/migrations 2 yii migrate --migrationPath=@mdm/admin/migrations
如果执行成功会生成5张表，还需要一张user表，你可以自己添加
1 menu //菜单表 2 auth_rule //规则表 3 auth_item_child //角色对应的权限，parent角色，child权限名 4 auth_item //角色、权限表,type=1表示角色,type=2表示权限 5 auth_assignment //角色与用户对应关系表
如果全部成功的话，访问index.php?r=admin 就可以了看到权限的控制可视化页面，如果出错，认真查看错误原因，基本上都是配置不对。配置好的话，访问其他页面就没有权限了，然后你可以修改as access中的allowActions，这在开发api或者一些共用模块的时候很有用，因为这些页面不需要进行权限的控制。默认风格的权限控制页面如下图：
要进行菜单控制，就需要用到刚才创建的那几个表中的menu表，左侧的导航按照我们的设计应该可以通过权限进行控制，写死的导航不能达到目的，可扩展性不强，所以菜单控制必须要支持。
需要注意的是，如果你的后台框架中用到了自己的layout，你需要自己去指定，我们这个项目就是，有我们自己的layout，上面再添加admin组件的时候已经添加了：
\'layout\' => \'@app/views/layouts/main_nifty\',
然后我们操作菜单列表。添加菜单项，然后再打开layout文件，其实获取菜单的逻辑已经写好了，在MenuHelper中，添加命名空间mdm\\admin\\components\\MenuHelper; 然后注销原来的导航，添加下面的代码，基本上就可以实现权限-用户-导航的控制了。
1 echo Nav::widget( 2 [ 3 "encodeLabels" => false, 4 "options" => ["class" => "sidebar-menu"], 5 "items" => MenuHelper::getAssignedMenu(Yii::$app->user->id), 6 ] 7 );
好了说完了，最后看一下这个页面：
在使用的过程中，yii-admin实现的导航权限控制远不能满足我们的需求，并且这种组件试的开发，每个操作是完全独立的，比如检查权限，取菜单，取用户信息，每个操作都需要执行SQL来进行。下面是正常的检查权限和得到菜单的sql执行过程，其实这个过程是极其费时的，当用户量比较多，菜单比较大，权限表中的数据非常多的时候是不能这样干的，使用我们自己的sql检测工具可以看到，这个过程执行了20条之多的sql语句：
在图中可以看出，权限检查涉及了14次的sql查询，菜单涉及了5次sql查询，如此多的sql 执行一旦上线是没有什么并发可言的。yii-admin这个组件提供了方便的权限控制，菜单控制，但是性能上面我们不敢苟同。查看源码你就知道，这个组件在我看来是一个解耦比较高的组件，每个成分之间可以单独的使用，这就需要每个操作必须要有自己独立的数据库来源，说白了就需要每次都执行sql去取到想要的数据，中间很少使用连表查询，其实10条sql做的功能，在连表的情况下，一条sql就搞定了。
像我这种人是不能忍受这么多不相关的sql执行的，所以我就在根源上面修改了yii-admin的权限检查部分，修改的方法是我自己想的，不一定对，也不一定适合所有的场景，下面就写出来与大家分享。
我们通过查看菜单的生成过程大致会执行了5条以上的sql，这个还算可以，我没有做sql上的优化，原因是我们的菜单是要对应不同的角色和子父级关系，在原来的基础上我添加了一个type来区分是哪种角色能看到这种菜单，以及哪种角色对应某一个菜单显示的层级关系。这样管理员，省代用户，客户都会呈现不同的菜单。即使配置相同的权限，不同层级的用户也会看到不同的菜单。
我做的优化是缓存菜单的生成数据，我们这个菜单是定制的，没有采用一开始配置的Nav::widget来呈现，而是我们自己循环层级关系，这样虽然麻烦，但是能很好的提取菜单中我们需要的每一个逻辑，比如：面包屑的自动生成就可以每次提取菜单的label，再比如子页面，不同控制器下得左导航的高亮，下面是代码，php和html混写了，以后会慢慢的提取。
1 <ul class="nav nav-list"> 2 <?php 3 $idx = 1; 4 $request_url = \'/\' . $mod_id . \'/\' . $con_id . \'/\' . $act_id . \'/\'; 5 foreach ($menus_new[\'list\'] as $label => $menu1): ?> 6 <?php 7 if (empty($menu1[\'label\']) && empty($menu[\'url\'][0])) { 8 continue; 9 } 10 ?> 11 <?php if(!isset($menu1[\'items\'])):?> 12 <li class="<?php 13 if (isset($menu1[\'openurl\']) && strstr($menu1[\'openurl\'], $request_url)) { 14 echo \'active\'; 15 $breadcrumb[] = $menu1[\'label\']; 16 } 17 ?>"> 18 <a href="<?php echo $menu1[\'url\'][0] ?>"> 19 <i class="menu-icon fa fa-<?php echo $menu1[\'icon\'] ?>"></i> 20 <span class="menu-text"> <?php echo $menu1[\'label\'] ?> </span> 21 </a> 22 <b class="arrow"></b> 23 </li> 24 <?php else:?> 25 <li class="<?php 26 if (isset($menu1[\'openurl\']) && strstr($menu1[\'openurl\'], $request_url)) { 27 echo \'open\'; 28 $breadcrumb[] = $menu1[\'label\']; 29 } 30 ?>"> 31 <a href="index.html"data-target="#multi-cols-<?php echo $idx ?>"class="dropdown-toggle"> 32 <i class="menu-icon fa fa-<?php echo $menu1[\'icon\'] ?>"></i> 33 <span class="menu-text"> 34 <?php echo $menu1[\'label\'] ?> 35 </span> 36 <b class="arrow fa fa-angle-down"></b> 37 </a> 38 <b class="arrow"></b> 39 <ul id="multi-cols-<?php echo $idx ?>" class="submenu"> 40 <?php foreach ($menu1[\'items\'] as $label => $menu2): ?> 41 <?php 42 if (empty($menu2) || !is_array($menu2)) { continue; } 43 if(!isset($menu2[\'items\'])):?> 44 <li class="<?php 45 if (isset($menu2[\'openurl\']) && strstr($menu2[\'openurl\'], $request_url)) { 46 echo \'active\'; 47 $breadcrumb[] = $menu2[\'label\']; 48 } 49 ?>"> 50 <a href="<?php echo $menu2[\'url\'][0] ?>"> 51 <i class="menu-icon fa fa-caret-right"></i> 52 <?php echo $menu2[\'label\'] ?> 53 </a> 54 <b class="arrow"></b> 55 </li> 56 <?php else:?> 57 <li class="<?php 58 if (isset($menu2[\'openurl\']) && strstr($menu2[\'openurl\'], $request_url)) { 59 echo \'open\'; 60 $breadcrumb[] = $menu2[\'label\']; 61 } 62 ?>"> 63 <a href="#" class="dropdown-toggle"> 64 <i class="menu-icon fa fa-caret-right"></i> 65 <?php echo $menu2[\'label\'] ?> 66 <b class="arrow fa fa-angle-down"></b> 67 </a> 68 <b class="arrow"></b> 69 <ul class="submenu"> 70 <?php foreach ($menu2[\'items\'] as $label => $url): ?> 71 <?php if (empty($url) || !is_array($url)) { continue; } ?> 72 <li class="<?php 73 if (isset($url[\'openurl\']) && strstr($url[\'openurl\'], $request_url)) { 74 echo \'active\'; 75 $breadcrumb[] = $url[\'label\']; 76 } 77 ?>"> 78 <a href="<?php echo $url[\'url\'][0] ?>"> 79 <i class="menu-icon fa fa-caret-right"></i> 80 <?php echo $url[\'label\'] ?> 81 </a> 82 <b class="arrow"></b> 83 </li> 84 <?php endforeach ?> 85 </ul> 86 </li> 87 <?php endif?> 88 <?php endforeach ?> 89 </ul> 90 </li> 91 <?php endif?> 92 <?php $idx++; ?> 93 <?php endforeach ?> 94 </ul>
这个导航是我自己改了好多版总结出适合我们自己的方案，其中$breadcrumb是控制面包屑的显示，有时间我会抽离php。我介绍的是菜单优化，现在才完成了第一步菜单的显示，说到优化我是采用缓存菜单数据的策略，就是缓存上面那个$menus_new[\'list\']，策略如下：
这个策略使用角色缓存数据，就是使用每个角色的权限加上uid和环境配置取MD5后生成key，考虑到用户比较多每个用户都缓存的话开销太大，并且用户相同权限的的比较多，特殊权限的可以特殊对待，这样省去了存储好多重复的数据，环境配置是区分线上数据和测试数据，便于我们进行调试。
过期机制：重要的是缓存的过期机制，缓存有了但是当菜单或者权限发生变化的时候就要更新缓存，这里我们引入了版本的概念，能做到缓存变更的最小开销。比如菜单变化，所有人导航都应该修改，这里我们在redis中加入一个导航版本的变量，每次读入缓存的时候都会先判断这个版本与缓存中自己存储版本是否一致，如果一致证明导航没有变化，如果不一致认为菜单有修改，导航已过期，需要重新得到缓存，这样相同的角色，只要有一个人更新了导航，其他人下次再进来的时候就会访问到最新的导航（统一角色）。这个全局的redis变量会在导航变更和权限变更的时候自动加1，保证版本的变化，这样如果有4类角色，几万人的用户，实际的数据修改只发生的4次（实际会比这个多，比如同一个角色不同的权限，那么他对应的redis key 就不一样，它需要自己去取缓存）。具体的代码实现如下：
1 $user_id = Yii::$app->user->id; 2 $breadcrumb = []; 3 $menus_new[\'list\'] = MenuHelper::getAssignedMenu($user_id); 4 5 $redis_key = MenuHelper::getMenuKeyByUserId($user_id); 6 $redis_menu = Yii::$app->redis->get($redis_key); 7 $redis_varsion = getVersion(); 8 9 if (!empty($redis_menu)) { 10 $menus_new = json_decode($redis_menu, true); 11 $old_version = isset($menus_new[\'version\']) ? $menus_new[\'version\'] : \'\'; 12 13 //判断菜单的版本号，便于及时更新缓存 14 if (!isset($menus_new[\'list\']) || empty($old_version) || intval($old_version) != $redis_varsion) { 15 $menus_new = getMenu($user_id, $redis_varsion, $redis_key); 16 $log = json_encode([ 17 \'user_id\' => $user_id, 18 \'varsion\' => $redis_varsion, 19 \'redis_key\' => $redis_key, 20 \'value\' => $menus_new 21 ]); 22 writeLog($log, \'update_menu\'); 23 } 24 } else { 25 $menus_new = getMenu($user_id, $redis_varsion, $redis_key); 26 } 27 28 function getMenu($user_id, $varsion, $redis_key) 29 { 30 $menus_new[\'list\'] = MenuHelper::getAssignedMenu($user_id); 31 $menus_new[\'version\'] = $varsion; 32 Yii::$app->redis->set($redis_key, json_encode($menus_new)); 33 Yii::$app->redis->expire($redis_key, 300); 34 return $menus_new; 35 } 36 37 //设置更新key便于时时更新redis 38 function getVersion() 39 { 40 $version_key = Yii::$app->params[\'redis_key\'][\'menu_prefix\'] . md5(Yii::$app->params[\'redis_key\'][\'menu_version\'] . Yii::$app->db->dsn); 41 $version_val = Yii::$app->redis->get($version_key); 42 43 return empty($version_val) ? 1 : $version_val; 44 }
生成key和更新key的逻辑如下：
1 /** 2 * get menu one user by the id 3 * @param $user_id 4 * @return key string 5 */ 6 public static function getMenuKeyByUserId($user_id) 7 { 8 if (empty($user_id)) { 9 return false; 10 } 11 12 $list = (new \\yii\\db\\Query())->select(\'**\') 13 ->from(\'**\') 14 ->where([\'user_id\' => $user_id]) 15 ->all(); 16 17 if (empty($list)) { 18 return false; 19 } 20 21 $role_str = \'\'; 22 foreach ($list as $key => $value) { 23 $role_str .= $value[\'item_name\']; 24 } 25 26 $redis_key = Yii::$app->params[\'key\'] . md5($role_str . Yii::$app->db->dsn); 27 28 return $redis_key; 29 } 30 31 /** 32 * 修改菜单更新状态，更新redis 33 */ 34 public static function UpdateMenuVersion() 35 { 36 $version_key = Yii::$app->params[\'key\'] . md5(Yii::$app->params[\'key\'] . Yii::$app->db->dsn); 37 $version_val = Yii::$app->redis->get($version_key); 38 39 if (empty($version_val)) { 40 $version_val = \'1\'; 41 } else { 42 $version_val++; 43 } 44 45 $log = json_encode([ 46 \'user_id\' => Yii::$app->user->id, 47 \'version_key\' => $version_key, 48 \'version_val\' => $version_val 49 ]); 50 writeLog($log, \'update_menu_version\'); 51 52 Yii::$app->redis->set($version_key, $version_val); 53 }
默认的导航高亮是按照模块，控制器，方法来进行直接匹配的，这样一来有一种需求无法满足，比如：A控制器下得页面下载B控制器下面高亮，这种事无法实现的，所以要修改他们高亮机制。我们没有再采用他的高亮逻辑，而是自己实现了一个新的逻辑。我首先把要高亮的页面url加入到菜单的data里面，data是一个json数据，如下所示：
{"icon": "fa fa-home", "visible": true, "openurl":"/web/site/index/"}
这样我们通过openurl就能知道哪个导航高亮，在页面中直接判断当前请求的url在不在这个openurl里面就可以，但是这样做有缺点，必须要有把高亮的页面加入到要高亮的导航里面，如果页面太多这种方式不怎么好，但是我没有想到更好的方法去解决，如果哪位大神有好的方法可以在评论中写出，非常感谢。
图标和可见性的控制可以借助于MenuHelper中getAssignedMenu的回调方法实现，你可以在调用该方法的时候传入回调方法，我直接写的匿名方法，添加在了该方法里面，如下所示：
1 $user_type = Yii::$app->user->identity->type; 2 $customer_id = Yii::$app->user->identity->customer_id; 3 4 $callback_func = function($menu) use ($user_type, $customer_id) { 5 $data = json_decode($menu[\'data\'], true); 6 $items = $menu[\'children\']; 7 8 $return = [ 9 \'label\' => $menu[\'name\'], 10 \'url\' => [$menu[\'route\']], 11 ]; 12 13 $return[\'visible\'] = isset($data[\'visible\']) ? $data[\'visible\'] : \'\'; 14 15 //菜单隐藏的逻辑 16 if (empty($return[\'visible\'])) { 17 return false; 18 } 19 20 $return[\'icon\'] = isset($data[\'icon\']) ? $data[\'icon\'] : \'\'; 21 22 //控制菜单打开的逻辑 23 $return[\'openurl\'] = isset($data[\'openurl\']) ? $data[\'openurl\'] : \'\'; 24 25 $items && $return[\'items\'] = $items; 26 return $return; 27 };
刚才已经说了，yii-admin 的权限检测执行太费时间，执行SQL太多，所以我打算重写他的权限检查的方法，通过读源码可以看到，他们检查是通过user中的can方法调用的，然后通过mdm\\admin\\components\\AccessControl中的beforeAction实现的，我们可以看一下：
1 /** 2 * @inheritdoc 3 */ 4 public function beforeAction($action) 5 { 6 $actionId = $action->getUniqueId(); 7 $user = $this->getUser(); 8 9 //预留系统检查权限的逻辑，一旦重写检查权限失败，调用系统检查权限的方法 10 if ($user->can(\'/\' . $actionId)) { 11 return true; 12 } 13 $obj = $action->controller; 14 do { 15 if ($user->can(\'/\' . ltrim($obj->getUniqueId() . \'/*\', \'/\'))) { 16 return true; 17 } 18 $obj = $obj->module; 19 } while ($obj !== null); 20以上是关于浅谈Yii-admin的权限控制的主要内容，如果未能解决你的问题，请参考以下文章浅谈Windows用户帐户控制(User Account Control,UAC)
Android 逆向Linux 文件权限 ( Linux 权限简介 | 系统权限 | 用户权限 | 匿名用户权限 | 读 | 写 | 执行 | 更改组 | 更改用户 | 粘滞 )(代码片段