本篇继续讲解 yii2-admin 扩展
上一篇 m155 我们讲解了 yii2-admin 的安装、布局和简单的配置,本节我们重点讲解 route 的实现以及整个 rbac 操作流程。
本章要讲的内容如下
上一节我们说了 yii2-admin 多出 route 层,但是 yii2 的 rbac 数据表中并没有相关的表,本节我们讨论下 route 是如何处理的以及它和 persission 的关系。
而我们使用 yii2-admin 也是从添加 route 开始的,打开 index.php?r=admin/route
首先看 ① 处,yii2-admin 会自动帮我们把 yii2 程序的所有路由全部分析并列举出来供选择,当然你也可以在 ④ 处自行添加,但是有一点要注意
在你自己添加路由的时候,务必且必须以 / 开始,否则它会带来很多麻烦问题。
对于自动检索处的路由,我们可以通过 ② 操作将其添加到 ③ 区域。对于自动添加的路由它会自己进入到 ③ 区域。
就想我下面动图展示的一样
当然,如果是自己添加的,你在自动检索区①处是看不到的。
当我们从自动检索区添加一个到 ③ 区域,或自行添加后,rbac 系统发生了什么那?
其实它填充了 item 表,如下图
是的,这货就是权限,但如果它是权限,那 yii2-admin 的权限又是干嘛的?别急,我们熟悉下 yii2-admin,顺完会为大家揭晓。此坑必填。
我们来看 Permissions 菜单。现在我们来生成一个 Permission。
号外,因本章并不是讲解 yii2 rbac 内容,北哥假设你对 yii2 rbac 已经有所了解,如果不了解可以看下 rbac 系列视频
Route 和 Permissions 的关联就在于我们新联了一个权限后,当新建一个权限后,yii2-admin 需要让我们为此权限指定对应的路由,不明白?看图,看图最直观。
上图的目的是什么?我们知道,路由就是资源,我们现在在为一个权限指派资源,当然你理解为权限可以属于另一个权限也没有问题。
当我们把路由 /goods/index 指派给 权限 goods-edit 后,将来拥有 goods-edit 权限的人就能访问 /goods/index 了。
接下来我们看看为权限指路由后,rbac 数据表的变化
是的,权限之间的所属关系已经建立。
接下来我们来填上文的一个坑,当我们为一个权限分配路由的时候,从数据表我们知道他们都是权限,那么在每个权限页面又如何分析出路由项而没有混入普通的权限那。这个情况在路由页面的 ③ 区域我想你也感觉到了。
其实很简单,这要看下 yii2-admin 的一个方法
// /vendor/mdmsoft/yii2-admin/models/searchs/AuthItem.php 52 行
public function search($params)
{
/* @var \yii\rbac\Manager $authManager */
$authManager = Yii::$app->getAuthManager();
if ($this->type == Item::TYPE_ROLE) {
$items = $authManager->getRoles();
} else {
$items = array_filter($authManager->getPermissions(), function($item) {
return $this->type == Item::TYPE_PERMISSION xor strncmp($item->name, '/', 1) === 0;
});
}
$this->load($params);
....
对,就是其中的 strncmp($item->name, '/', 1) === 0 这句,这个方法搜索出了所有的权限列表,然后筛选出这些权限名字中第一个字符是 / 的,这也是为何我们说添加路由的时候必须 / 开头的原因。
ok。
关于如何建立角色等就不做详说,关于 rule 我们会放到最有一篇说。
通过对上面的学习,我们学会了如何新建权限和路由,如何建立角色并分配相关权限,万里长征走完了第一步,下面我们来为 yii2 程序的会员分配角色和权限。
你一定发现了,yii2-admin 并没有一个 user 的菜单?不是没有,是没有配置而已。
我们需要使用 yii2-admin 提供的会员模型,数据表已经为我们准备好
// 导入数据表 命令行运行
./yii migrate --migrationPath=@mdm/admin/migrations
你也可以复制 /vendor/mdmsoft/yii2-admin/migrations 对应的数据库 sql 脚本导入。
这个行为会导入两张表,我们先用其中的 user 表,menu 会在下一节权限菜单中使用。
yii2-admin 会自动检测数据库中是否有对应表而陈列出对应的菜单,现在你打开 index.php?r=admin 后,是不是多了 user 和 menu 菜单了。
接下来我们需要设置下 web.php
//在 user 模块里
'user' => [
'identityClass' => 'mdm\admin\models\User',
'loginUrl' => ['admin/user/login'],
]
当你配置完以后会发现 admin 又多了一个叫做 Assignments 的菜单。不过此刻我们的系统中是没有会员数据的,别担心,yii2-admin 提供了一个 action 让我们生成会员。
index.php?r=admin/user/signup
赶紧去建立几个会员吧
现在有了会员,选择 Assignments 菜单中的某个会员,我们就可以轻松的为他分配角色和权限了
此刻我为会员 abei 分配了角色“客服人员”,它具有 goods-edit(可以访问 /goods/index 路由) 但是不能访问 /goods/delete
这就是 rbac 的会员、角色、权限、资源的关系。
说了好多,大家也很累了,先这样,下一篇继续聊 yii2-admin 的 user 和 menu 两块。