這篇文章主要介紹了Yii2搭建後台並實現rbac許可權控制完整執行個體教程的相關資料,需要的朋友可以參考下
1、安裝yii2
未安裝的請參考yii2史上最簡單式安裝教程,沒有之一
已安裝的請繼續看下一步操作
2、設定資料庫
2.1 設定資料庫
修改common/config/main-local.php 實際項目中本地的資料庫往往跟線上資料庫不一致,
我們這裡配置到main-local.php就可以了,產品上線後,我們可以使用git或者svn忽略掉main-local.php,線上直接部署。
我們這裡使用的mysql資料庫,配置如下
當然啦,上面紅圈圈的資訊需要你自己手動修改掉,要是十分巧合跟我的一樣那就不用在修改了
2.2 建立user資料表,我們後面要實現後台登陸
說明:user表和menu表的建立可以參考我們後面下載的組件yii2-admin裡面的sql,具體目錄位於
vendor\mdmsoft\yii2-admin\migrations\schema-mysql.sqlCREATE 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網站,先註冊個使用者
註冊成功後,右上方會顯示登陸的狀態,我們後面會用到這個註冊的使用者
接下來我們要開始配置背景模板了。
3、利用AdminLTE渲染後台模板
背景模板我們採用利用 AdminLTE(Backend theme for Yii2 Framework)
插播一曲:AdminLTE是一個完全響應系統管理範本。基於Bootstrap3架構,易定製模板。適合多種螢幕解析度,從小型行動裝置到大型台式機。
內建了多個頁面,包括儀錶盤、郵箱、日曆、鎖屏、登入及註冊、404錯誤、500錯誤等頁面。
3.1 安裝AdminLTE
這裡我簡述下自己的安裝步驟,cd advanced後,
因為是mac,這裡直接composer進行安裝就行了
composer require dmstr/yii2-adminlte-asset "2.*"
安裝成功後,vendor目錄下會多幾個檔案夾,如下
3.2 yii2配置整合AdminLTE,搭建帥氣上檔次的後台
下面我們配置下backend/config/main.php先預覽下效果,小心臟捉急的巴不得趕緊嘗嘗戰果
'components' => [ 'view' => ['theme' => ['pathMap' => [ '@app/views' => '@vendor/dmstr/yii2-adminlte-asset/example-views/yiisoft/yii2-app' ],],],],
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 +FollowSymLinksIndexIgnore */*RewriteEngine on# if a directory or a file exists, use it directlyRewriteCond %{REQUEST_FILENAME} !-fRewriteCond %{REQUEST_FILENAME} !-d# otherwise forward it to index.phpRewriteRule . 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
嗯,介面是有的了,下面我們加快腳步驗收下我們的許可權這塊到底成還是不成呢?
一般來說到這一步就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>
我們看下,這樣一來,我們對許可權進行操作就十分的方便了
如此,我們的許可權控制基本告一段落了,關於許可權需要說明的是:
你應該先添加路由,然後添加許可權名稱,後再對角色或個人進行許可權的獨立分配。
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了,現在你可以繼續添加菜單試試效果如何。
以上就是本文的全部內容,希望對大家的學習有所協助,更多相關內容請關注topic.alibabacloud.com!