Yii2搭建后台并实现rbac权限控制完整实例教程


Posted in PHP onApril 28, 2016

1、安装yii2

未安装的请参考yii2史上最简单式安装教程,没有之一

已安装的请继续看下一步操作

2、配置数据库

2.1 配置数据库

修改common/config/main-local.php 实际项目中本地的数据库往往跟线上数据库不一致,

我们这里配置到main-local.php就可以了,产品上线后,我们可以使用git或者svn忽略掉main-local.php,线上直接部署。

我们这里使用的mysql数据库,配置如下

Yii2搭建后台并实现rbac权限控制完整实例教程

当然啦,上面红圈圈的信息需要你自己手动修改掉,要是十分巧合跟我的一样那就不用在修改了

2.2 创建user数据表,我们后面要实现后台登陆

说明:user表和menu表的创建可以参考我们后面下载的组件yii2-admin里面的sql,具体目录位于

vendor\mdmsoft\yii2-admin\migrations\schema-mysql.sql

CREATE TABLE `user` (
`id` int(11) NOT NULL AUTO_INCREMENT COMMENT '自增ID', 
`username` varchar(255) NOT NULL COMMENT '用户名', 
`auth_key` varchar(32) NOT NULL COMMENT '自动登录key', 
`password_hash` varchar(255) NOT NULL COMMENT '加密密码', 
`password_reset_token` varchar(255) DEFAULT NULL COMMENT '重置密码token', 
`email` varchar(255) NOT NULL COMMENT '邮箱', 
`role` smallint(6) NOT NULL DEFAULT '10' COMMENT '角色等级', 
`status` smallint(6) NOT NULL DEFAULT '10' COMMENT '状态', 
`created_at` int(11) NOT NULL COMMENT '创建时间', 
`updated_at` int(11) NOT NULL COMMENT '更新时间', 
PRIMARY KEY (`id`)
) ENGINE=InnoDB AUTO_INCREMENT=0 DEFAULT CHARSET=utf8 COMMENT='用户表';

2.3 访问frontend站点,先注册个用户

Yii2搭建后台并实现rbac权限控制完整实例教程

注册成功后,右上角会显示登陆的状态,我们后面会用到这个注册的用户

Yii2搭建后台并实现rbac权限控制完整实例教程

接下来我们要开始配置后台的模板了。

3、利用AdminLTE渲染后台模板

后台的模板我们采用利用 AdminLTE(Backend theme for Yii2 Framework)

插播一曲:AdminLTE是一个完全响应管理模板。基于Bootstrap3框架,易定制模板。适合多种屏幕分辨率,从小型移动设备到大型台式机。

内置了多个页面,包括仪表盘、邮箱、日历、锁屏、登录及注册、404错误、500错误等页面。

3.1 安装AdminLTE

https://github.com/dmstr/yii2-adminlte-asset

打开上面的链接,按照操作步骤进行安装

这里我简述下自己的安装步骤,cd advanced后,

因为是mac,这里直接composer进行安装就行了

composer require dmstr/yii2-adminlte-asset "2.*"

安装成功后,vendor目录下会多几个文件夹,如下

Yii2搭建后台并实现rbac权限控制完整实例教程

3.2 yii2配置整合AdminLTE,搭建帅气上档次的后台

下面我们配置下backend/config/main.php先预览下效果,小心脏捉急的巴不得赶紧尝尝战果

'components' => [ 
'view' => [
'theme' => [
'pathMap' => [ 
'@app/views' => '@vendor/dmstr/yii2-adminlte-asset/example-views/yiisoft/yii2-app' 
],
],
],
],

Yii2搭建后台并实现rbac权限控制完整实例教程

nice,页面瞬间好看多了。

问题来了,我们是在components里面单独配置的theme,这样以后要修改布局文件什么的是很不方便滴,下面我们把不局文件拷贝下来覆盖掉yii自带的layout.

把vendor/dmstr/yii2-adminlte-asset/example-views/yiisoft/yii2-app目录下的layouts和site拷贝

覆盖掉backend/views/目录下的lauouts和site对应的文件

覆盖后记得屏蔽掉 components下面view的配置项

到此,后台模板的搭建告一段落,si不si很happy

4、下面我们用yii的rbac实现后台的权限控制

4.1 我们先配置下简短路由

backend/config/main.php文件的compontents加上下面的配置

'urlManager' => [ 
//用于表明urlManager是否启用URL美化功能,在Yii1.1中称为path格式URL, 
// Yii2.0中改称美化。 
// 默认不启用。但实际使用中,特别是产品环境,一般都会启用。 
'enablePrettyUrl' => true, 
// 是否启用严格解析,如启用严格解析,要求当前请求应至少匹配1个路由规则, 
// 否则认为是无效路由。 
// 这个选项仅在 enablePrettyUrl 启用后才有效。 
'enableStrictParsing' => false, 
// 是否在URL中显示入口脚本。是对美化功能的进一步补充。 
'showScriptName' => false, 
// 指定续接在URL后面的一个后缀,如 .html 之类的。仅在 enablePrettyUrl 启用时有效。 
'suffix' => '', 
'rules' => [ 
"<controller:\w+>/<id:\d+>"=>"<controller>/view", 
"<controller:\w+>/<action:\w+>"=>"<controller>/<action>" 
],
],

接下来在项目的根目录 backend/web下面创建.htaccess文件并添加如下内容,这个文件你都创建不下来,看来是真需要再磨练磨练哦

Options +FollowSymLinks
IndexIgnore */*
RewriteEngine on
# if a directory or a file exists, use it directly
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
# otherwise forward it to index.php
RewriteRule . index.php

当然,你的apache必须要开启rewrite模块。

下面我们访问下gii模块测试下

http://localhost/advanced/backend/web/gii

校验是可以的。

4.2 创建权限控制所需要的数据表

当然,这些yii2都给我们准备好了。

打开 vendor/yiisoft/yii2/rbac/migrations/schema-mysql.sql 文件,依次创建数据表

`auth_assignment`;
`auth_item_child`;
`auth_item`;
`auth_rule`;

另外补充菜单menu表,需要的自行创建

说明:user表和menu表的创建可以参考 vendor\mdmsoft\yii2-admin\migrations\schema-mysql.sql

CREATE TABLE `menu` ( 
`id` int(11) NOT NULL AUTO_INCREMENT, 
`name` varchar(128) NOT NULL, 
`parent` int(11) DEFAULT NULL, 
`route` varchar(256) DEFAULT NULL, 
`order` int(11) DEFAULT NULL, 
`data` text, 
PRIMARY KEY (`id`), 
KEY `parent` (`parent`), 
CONSTRAINT `menu_ibfk_1` FOREIGN KEY (`parent`) REFERENCES `menu` (`id`) ON DELETE SET NULL ON UPDATE CASCADE
) ENGINE=InnoDB DEFAULT CHARSET=utf8

4.3 下载安装 yii2-admin

参考 https://github.com/mdmsoft/yii2-admin

按照步骤一步一步安装即可,同adminlte的安装

安装好了我们会在vendor目录下面看到 mdmsoft目录

4.4 权限配置

打开backend/config/main.php修改配置

'modules' => [ 
'admin' => [ 
'class' => 'mdm\admin\Module', 
],
],
'aliases' => [ 
'@mdm/admin' => '@vendor/mdmsoft/yii2-admin',
],
//这里必须添加authManager配置项
'components' => [ 
... 
//components数组中加入authManager组件,有PhpManager和DbManager两种方式, 
//PhpManager将权限关系保存在文件里,这里使用的是DbManager方式,将权限关系保存在数据库. 
'authManager' => [ 
'class' => 'yii\rbac\DbManager', 
'defaultRoles' => ['guest'], 
], 
...
],

4.5 我们访问下权限模块检验下效果如何

http://localhost/advanced/backend/web/admin/route

Yii2搭建后台并实现rbac权限控制完整实例教程

嗯,界面是有的了,下面我们加快脚步验收下我们的权限这块到底成还是不成呢?

一般来说到这一步就ok的了。后面的可以自己摸索着添加路由分配权限了。

下面我们在左侧菜单上把权限的栏目加上,代码可直接复制,放置于 <section class="sidebar"></section>内

<ul class="sidebar-menu"> 
<li class="treeview"> 
<a href="#"> 
<i class="fa fa-gears"></i> <span>权限控制</span> 
<i class="fa fa-angle-left pull-right"></i> 
</a> 
<ul class="treeview-menu"> 
<li class="treeview"> 
<a href="/admin">管理员</a> 
<ul class="treeview-menu"> 
<li><a href="/user"><i class="fa fa-circle-o"></i> 后台用户</a></li> 
<li class="treeview"> 
<a href="/admin/role"> 
<i class="fa fa-circle-o"></i> 权限 <i class="fa fa-angle-left pull-right"></i> 
</a> 
<ul class="treeview-menu"> 
<li><a href="/admin/route"><i class="fa fa-circle-o"></i> 路由</a></li> 
<li><a href="/admin/permission"><i class="fa fa-circle-o"></i> 权限</a></li> 
<li><a href="/admin/role"><i class="fa fa-circle-o"></i> 角色</a></li> 
<li><a href="/admin/assignment"><i class="fa fa-circle-o"></i> 分配</a></li> 
<li><a href="/admin/menu"><i class="fa fa-circle-o"></i> 菜单</a></li> 
</ul> 
</li> 
</ul> 
</li> 
</ul> 
</li> 
</ul>

我们看下效果图,这样一来,我们对权限进行操作就十分的方便了

Yii2搭建后台并实现rbac权限控制完整实例教程

如此,我们的权限控制基本告一段落了,关于权限需要说明的是:

你应该先添加路由,然后添加权限名称,后再对角色或个人进行权限的独立分配。

5、如何利用menu对菜单进行控制?

4.5步骤中我们是直接写ul li的方式对左侧菜单进行操作的,这样也是能够实现通过菜单对权限进行控制滴。

但是喃,一来不方便操作,而来增加修改个什么东东都得需要我们去修改程序实现,这也TTM不方便了。还好我们家有妙招,DDV杀杀杀。

好了,又扯远了。仔细回想,是不是我们创建的123456张表还有一张menu表没有利用到喃?这货怎么利用喃?来,我们回归正题。

首选,我们访问/admin/menu/index添加几个一级菜单,姑且叫做一级1,一级2,一级3吧,哦对了,忘记添加路由了,怎么回事呢,我们先访问/admin/route/index 把左侧的路由移动到右侧,不然上面创建新菜单会失败哦。创建菜单时,[映射][数据]我们暂且不填写。

添加完毕之后呢,我们打开布局文件left.php,use两个类文件,分别是yii\bootstrap\Nav和mdm\admin\components\MenuHelper;

获取权限的操作 MenuHelper::getAssignedMenu都帮我们做好了。

ok,我们删掉4.5添加的sidebar-menu菜单,添加下面的代码试试看

echo Nav::widget(
[
'encodeLabels' => false,
'options' => ['class' => 'sidebar-menu'],
'items' => MenuHelper::getAssignedMenu(Yii::$app->user->id),
]
);

现在菜单控制权限我们基本上是ok了,现在你可以继续添加菜单试试效果如何。

到此呢,我们的后台和rbac的权限控制可以说是做得非常完美了,如果你在尝试的过程中遇到任何问题,下面留言就好,咱们共同交流探讨。

相关阅读:

PHP 相关文章推荐
如何做到多笔资料的同步
Oct 09 PHP
如何跨站抓取别的站点的页面的补充
Oct 09 PHP
php下过滤html代码的函数 提高程序安全性
Mar 02 PHP
关于初学PHP时的知识积累总结
Jun 07 PHP
php操作redis中的hash和zset类型数据的方法和代码例子
Jul 05 PHP
php中PDO方式实现数据库的增删改查
May 17 PHP
PHP单例模式详细介绍
Jul 01 PHP
使用PHP生成图片的缩略图的方法
Aug 18 PHP
php使用ftp实现文件上传与下载功能
Jul 21 PHP
PHP addAttribute()函数讲解
Feb 03 PHP
php7下的filesize函数
Sep 30 PHP
解决在laravel中auth建立时候遇到的问题
Oct 15 PHP
PHP在线调试执行的实现方法(附demo源码)
Apr 28 #PHP
thinkphp项目部署到Linux服务器上报错“模板不存在”如何解决
Apr 27 #PHP
Composer设置忽略版本匹配的方法
Apr 27 #PHP
抛弃 PHP 代价太高
Apr 26 #PHP
PHP调用存储过程返回值不一致问题的解决方法分析
Apr 26 #PHP
PHP抓取及分析网页的方法详解
Apr 26 #PHP
深入浅析yii2-gii自定义模板的方法
Apr 26 #PHP
You might like
图形数字验证代码
2006/10/09 PHP
基于php在各种web服务器的运行模式详解
2013/06/03 PHP
thinkphp3.2.3版本的数据库增删改查实现代码
2016/09/22 PHP
php中简单的对称加密算法实现
2017/01/05 PHP
PHP微信分享开发详解
2017/01/14 PHP
详解Yii2高级版引入bootstrap.js的一个办法
2017/03/21 PHP
thinkPHP3.2.3结合Laypage实现的分页功能示例
2018/05/28 PHP
php微信公众号开发之微信企业付款给个人
2018/10/04 PHP
php实现微信企业付款到个人零钱功能
2018/10/09 PHP
关于laravel 子查询 &amp; join的使用
2019/10/16 PHP
PHP常用函数之根据生日计算年龄功能示例
2019/10/21 PHP
JavaScript加密解密7种方法总结分析
2007/10/07 Javascript
javascript对象之内置对象Math使用方法
2010/04/16 Javascript
Array栈方法和队列方法的特点说明
2014/01/24 Javascript
jquery form 隐藏的input 选择
2014/04/29 Javascript
浅谈JS日期(Date)处理函数
2014/12/07 Javascript
JavaScript严格模式详解
2015/11/18 Javascript
JS中frameset框架弹出层实例代码
2016/04/01 Javascript
举例讲解如何判断JavaScript中对象的类型
2016/04/22 Javascript
jQuery 翻页组件yunm.pager.js实现div局部刷新的思路
2016/08/11 Javascript
Angular设置title信息解决SEO方面存在问题
2016/08/19 Javascript
基于JS实现快速读取TXT文件
2020/08/25 Javascript
vue组件中传值EventBus的使用及注意事项说明
2020/11/16 Javascript
微信小程序自定义底部弹出框动画
2020/11/18 Javascript
原生js 实现表单验证功能
2021/02/08 Javascript
[03:22]DAC最前线(第二期)—DOTA2亚洲邀请赛主赛场周边及线路探访
2015/01/24 DOTA
Windows下Python3.6安装第三方模块的方法
2018/11/22 Python
pandas DataFrame行或列的删除方法的实现示例
2019/08/02 Python
Python 利用高德地图api实现经纬度与地址的批量转换
2019/08/14 Python
Python 用turtle实现用正方形画圆的例子
2019/11/21 Python
matplotlib实现显示伪彩色图像及色度条
2019/12/07 Python
Python 合并拼接字符串的方法
2020/07/28 Python
在Ajax应用中信息是如何在浏览器和服务器之间传递的
2016/05/31 面试题
行政人事主管岗位职责
2015/04/11 职场文书
导游词之上海豫园
2019/10/24 职场文书
JavaScript前端面试组合函数
2022/06/21 Javascript