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 相关文章推荐
php调用mysql存储过程
Feb 14 PHP
PHP5 面向对象程序设计
Feb 13 PHP
PHP中对用户身份认证实现两种方法
Jun 04 PHP
linux系统上支持php的 iconv()函数的方法
Oct 01 PHP
PHP使用ODBC连接数据库的方法
Jul 18 PHP
PHP微信支付开发实例
Jun 22 PHP
php微信浏览器分享设置以及回调详解
Aug 01 PHP
PHP实现超简单的SSL加密解密、验证及签名的方法示例
Aug 28 PHP
PHP实现实时生成并下载超大数据量的EXCEL文件详解
Oct 23 PHP
微信公众号实现扫码获取微信用户信息(网页授权)
Apr 09 PHP
Laravel 自动转换长整型雪花 ID 为字符串的实现
Oct 27 PHP
laravel ajax curd 搜索登录判断功能的实现
Apr 17 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
新版mysql+apache+php Linux安装指南
2006/10/09 PHP
字母顺序颠倒而单词顺序不变的php代码
2010/08/08 PHP
php实现的替换敏感字符串类实例
2014/09/22 PHP
PHP中Enum(枚举)用法实例详解
2015/12/07 PHP
JQuery 学习笔记 element属性控制
2009/07/23 Javascript
基于jquery tab切换(防止页面刷新)
2012/05/23 Javascript
使用jQuery仿苹果官网焦点图特效
2014/12/23 Javascript
jQuery实现不断闪烁文字的方法
2015/05/15 Javascript
jQuery实现表格行上移下移和置顶的方法
2015/05/22 Javascript
jQuery+json实现的简易Ajax调用实例
2015/12/14 Javascript
javascript实现的猜数小游戏完整实例代码
2016/05/10 Javascript
JavaScript将DOM事件处理程序封装为event.js 出现的低级错误问题
2016/08/03 Javascript
jQuery多级联动下拉插件chained用法示例
2016/08/20 Javascript
jquery实现百叶窗效果
2017/01/12 Javascript
angularjs中回车键触发某一事件的方法
2017/04/24 Javascript
node.js连接MongoDB数据库的2种方法教程
2017/05/17 Javascript
当vue路由变化时,改变导航栏的样式方法
2018/08/22 Javascript
vue+axios 前端实现登录拦截的两种方式(路由拦截、http拦截)
2018/10/24 Javascript
详解javascript对数组和json数组的操作
2019/04/15 Javascript
NUXT SSR初级入门笔记(小结)
2019/12/16 Javascript
python 正则式使用心得
2009/05/07 Python
Python性能分析工具Profile使用实例
2019/11/19 Python
基于python的docx模块处理word和WPS的docx格式文件方式
2020/02/13 Python
详细分析Python可变对象和不可变对象
2020/07/09 Python
西班牙创意礼品和小工具网上商店:Curiosite
2016/07/26 全球购物
Betsey Johnson官网:妖娆可爱的连衣裙及鞋子、手袋和配件
2016/12/30 全球购物
员工培训邀请函
2014/01/11 职场文书
倡议书格式
2014/04/14 职场文书
优秀护士演讲稿
2014/04/30 职场文书
助学感谢信范文
2015/01/21 职场文书
检讨书范文大全
2015/05/07 职场文书
2015年党务公开工作总结
2015/05/19 职场文书
董事长开业致辞
2015/07/29 职场文书
食堂管理制度范本
2015/08/04 职场文书
PostGIS的安装与入门使用指南
2022/01/18 PostgreSQL
vue-treeselect的基本用法以及解决点击无法出现拉下菜单
2022/04/30 Vue.js