yii2-admin是yii2 rbac的一套管理工具,實(shí)現(xiàn)了漂亮的界面和完整的權(quán)限管理功能,不用自己再去寫權(quán)限代碼了,使用之前請(qǐng)將yii2的源碼更新到最新版本.
git源碼地址:https://github.com/mdmsoft/yii2-admin
安裝yii2-admin:
1、首先切換到項(xiàng)目目錄下
2、執(zhí)行該語(yǔ)句:composer.phar require mdmsoft/yii2-admin
注:如果提示could not open input file composer.phar
請(qǐng)先執(zhí)行下面兩條語(yǔ)句
composer self-update
composer install --prefer-dist
3、composer完成后在項(xiàng)目下的配置文件中加入下列配置項(xiàng)
'aliases' => [ '@mdm/admin' => '$PATH/yii2-admin-1.0.3', ], 'modules' => [ 'admin' => [ 'html' target='_blank'>class' => 'mdm/admin/Module', 'layout' => 'left-menu', // it can be '@path/to/your/layout'. /**/ 'controllerMap' => [ 'assignment' => [ 'class' => 'mdm/admin/controllers/AssignmentController', 'userClassName' => 'app/models/User', 'idField' => 'id' ] ], 'menus' => [ 'assignment' => [ 'label' => 'Grand Access' // change label ], //'route' => null, // disable menu route ] ], 'debug' => [ 'class' => 'yii/debug/Module', ], ],
components數(shù)組中加入authManager組件,有PhpManager和DbManager兩種方式,PhpManager將權(quán)限關(guān)系保存在文件里,這里使用的是DbManager方式,將權(quán)限關(guān)系保存在數(shù)據(jù)庫(kù). 'authManager' => [ 'class' => 'yii/rbac/DbManager', // or use 'yii/rbac/DbManager' ], 'i18n' => [ 'translations' => [ '*' => [ 'class' => 'yii/i18n/PhpMessageSource', 'basePath' => '@app/messages', // if advanced application, set @frontend/messages 'sourceLanguage' => 'en', 'fileMap' => [ //'main' => 'main.php', ], ], ], ],
4.命令行切換到y(tǒng)ii2目錄,執(zhí)行下面命令,創(chuàng)建rbac需要的表(需自行創(chuàng)建數(shù)據(jù)庫(kù),庫(kù)名默認(rèn)yii2basic)
yii migrate --migrationPath=@yii/rbac/migrations
yii migrate --migrationPath=@mdm/admin/migrations (創(chuàng)建menu導(dǎo)航菜單表),如果發(fā)生錯(cuò)誤可以將migrations中的sql文件移動(dòng)到@yii/rbac/migrations目錄下生成表
上面的命令使用的yii2框架的cli模式,所以需要將上面的配置,在console.php中也寫一份,這個(gè)大家看錯(cuò)誤提示就知道了.
反正這步我是沒(méi)有執(zhí)行成功的,這步的目的是在數(shù)據(jù)庫(kù)里生成下面5個(gè)表:
menu
auth_rule //規(guī)則,規(guī)則類名
auth_item_child //角色對(duì)應(yīng)的權(quán)限,parent角色,child權(quán)限名
auth_item //角色|權(quán)限表,type=1角色,type=2權(quán)限
auth_assignment //角色與用戶對(duì)應(yīng)關(guān)系表
我通過(guò)下面SQL語(yǔ)句直接生成這5個(gè)表
SET FOREIGN_KEY_CHECKS=0; -- ---------------------------- -- Table structure for dh_sm_menu -- ---------------------------- DROP TABLE IF EXISTS `yc_menu`; CREATE TABLE `yc_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`), KEY `name` (`name`), KEY `route` (`route`(255)), KEY `order` (`order`), CONSTRAINT `dh_menu_ibfk_1` FOREIGN KEY (`parent`) REFERENCES `dh_menu` (`id`) ON DELETE SET NULL ON UPDATE CASCADE ) ENGINE=InnoDB AUTO_INCREMENT=1 DEFAULT CHARSET=utf8 COMMENT='系統(tǒng)管理員菜單權(quán)限表/r/n'; DROP TABLE IF EXISTS `yc_auth_rule`; CREATE TABLE `yc_auth_rule` ( `name` varchar(64) NOT NULL, `data` text, `created_at` int(11) DEFAULT NULL, `updated_at` int(11) DEFAULT NULL, PRIMARY KEY (`name`), KEY `name` (`name`), KEY `created_at` (`created_at`), KEY `updated_at` (`updated_at`) ) ENGINE=InnoDB DEFAULT CHARSET=utf8 COMMENT='管理員權(quán)限規(guī)則表'; DROP TABLE IF EXISTS `yc_auth_item_child`; CREATE TABLE `yc_auth_item_child` ( `parent` varchar(64) NOT NULL, `child` varchar(64) NOT NULL, PRIMARY KEY (`parent`,`child`), KEY `child` (`child`), KEY `parent` (`parent`) ) ENGINE=InnoDB DEFAULT CHARSET=utf8 COMMENT='管理員權(quán)限關(guān)系表'; DROP TABLE IF EXISTS `yc_auth_item`; CREATE TABLE `yc_auth_item` ( `name` varchar(64) NOT NULL, `type` int(11) NOT NULL, `description` text, `rule_name` varchar(64) DEFAULT NULL, `data` text, `created_at` int(11) DEFAULT NULL, `updated_at` int(11) DEFAULT NULL, PRIMARY KEY (`name`), KEY `rule_name` (`rule_name`), KEY `type` (`type`), KEY `name` (`name`), KEY `created_at` (`created_at`), CONSTRAINT `yc_auth_item_ibfk_2` FOREIGN KEY (`rule_name`) REFERENCES `yc_auth_rule` (`name`) ON DELETE SET NULL ON UPDATE CASCADE ) ENGINE=InnoDB DEFAULT CHARSET=utf8 COMMENT='管理權(quán)權(quán)限條目'; DROP TABLE IF EXISTS `yc_auth_assignment`; CREATE TABLE `yc_auth_assignment` ( `item_name` varchar(64) NOT NULL, `user_id` varchar(64) NOT NULL, `created_at` int(11) DEFAULT NULL, PRIMARY KEY (`item_name`,`user_id`), KEY `user_id` (`user_id`), KEY `created_at` (`created_at`), KEY `item_name` (`item_name`), CONSTRAINT `yc_auth_assignment_ibfk_2` FOREIGN KEY (`item_name`) REFERENCES `yc_auth_item` (`name`) ON DELETE CASCADE ON UPDATE CASCADE ) ENGINE=InnoDB DEFAULT CHARSET=utf8 COMMENT='管理員授權(quán)表';
5.訪問(wèn)管理界面,http://localhost/admin,這時(shí)由于沒(méi)有數(shù)據(jù),會(huì)報(bào)錯(cuò),我們需要添加用戶表user
我的字段是這樣的,只需存在user_id即可,其他字段根據(jù)需要自行增減
CREATE TABLE `user` ( `user_id` int(10) unsigned NOT NULL AUTO_INCREMENT, `username` varchar(16) DEFAULT NULL, `password` varchar(32) DEFAULT NULL, `realname` varchar(32) DEFAULT NULL, `email` varchar(32) DEFAULT NULL, PRIMARY KEY (`user_id`) ) ENGINE=InnoDB DEFAULT CHARSET=utf8;
這是訪問(wèn)可能還會(huì)報(bào)錯(cuò),因?yàn)槲覀儧](méi)有實(shí)現(xiàn)驗(yàn)證類,在配置文件web.php中的components加入user項(xiàng)
'user' => [ 'identityClass' => 'app/models/User', 'enableAutoLogin' => true, ],
這里的app/models/User是我們實(shí)現(xiàn)的驗(yàn)證類,你可以隨便取名
class User extends /yii/db/ActiveRecord implements /yii/web/IdentityInterface 這個(gè)類需實(shí)現(xiàn)IdentityInterface接口中的5個(gè)函數(shù),必須實(shí)現(xiàn)的有2個(gè)方法 findIdentity($id) //根據(jù)id查詢用戶信息 getId() //獲取用戶id
到這里,基本就完成了,訪問(wèn)http://localhost/admin,即可看到管理界面
6.使用
1)修改導(dǎo)航菜單模板主視圖文件 views/layouts/main.php
use mdm/admin/components/MenuHelper; use yii/bootstrap/Nav; echo Nav::widget([ 'options' => ['class' => 'navbar-nav navbar-right nav-pills '], #修改使用yii2-admin的菜單控制項(xiàng) 'items' => MenuHelper::getAssignedMenu(Yii::$app->user->id), ]);
2)進(jìn)入yii2-admin的目錄,vi components/MenuHelper.php
public static function getAssignedMenu($userId, $root = null, $callback = null, $refresh = true) 將$refresh改為true
3)添加導(dǎo)航菜,創(chuàng)建RULE, 創(chuàng)建角色
https://github.com/mdmsoft/yii2-admin/blob/master/docs/guide/basic-usage.md
創(chuàng)建RULE時(shí),必須寫一個(gè)類并繼承yii/rbac/Rule,并且實(shí)現(xiàn)其抽象方法。
PHP編程鄭重聲明:本文版權(quán)歸原作者所有,轉(zhuǎn)載文章僅為傳播更多信息之目的,如作者信息標(biāo)記有誤,請(qǐng)第一時(shí)間聯(lián)系我們修改或刪除,多謝。
新聞熱點(diǎn)
疑難解答
圖片精選