最近一直忙其它的(其實是懶!),將《深入理解Yii2》看了一遍,一些當初沒明白的稍微明了了點,然后又看yii2的圖片上傳等處理、富文本、restful什么的,但由于沒進行到這里,只看也不管用啊,所以還是按照步驟一步步來,先說說前后臺分離。(其實普通的內容管理站點用不著下面所說的徹底分離什么的,看看也無妨)
個人感覺前后臺的情況有這么幾種,首先是前后臺是否是用一個驗證體系,其次是前后臺是否共用一個數據表。
一般來說下面三種比較常用吧:
A、共用一個驗證體系和一個數據表。
B、兩個驗證體系和共用一個數據表。
C、兩個驗證體系和兩個數據表。
Yii2高級版里面默認是A類型,即數據表一樣,且一邊登錄/登出了,另一邊也同樣登錄/登出,感覺這種結構比較適用于論壇這種,管理員也需要有與會員一樣發帖回帖等功能,表字段也基本一致,(個人這樣認為,畢竟接觸的不多,網上也搜過不同的后臺構建的話題,但是很少有詳細討論的),這種可以通過字段、權限等來區分前后臺。而我們將要做的是C類型,像是一些電商網站,后臺的管理員和前臺的會員功能就相差太大了,且表字段差別也大,所以驗證體系不一樣,而且放兩個數據表比較好。至于B類型算是C類型的簡化版,C如果會設置的話,B也同理。
那我們先建立一個admin表,用來存放管理員數據,而會員仍然用原有的user表,這里用yii的migrate來創建,在Yii2初始化章節中有提到過,這里稍微詳細說下:
1、yii2版本2.07以前用命令,即可在console/migrations目錄下創建一個php文件,然后在此文件下編寫創建表語句等等就可以了。
yii migrate/create admin
2、yii2版本2.07后,增加了更細致的分類,例如我已經創建了admin表,但少了一個status字段,那我可以直接用下面命令便會生成只增加字段的文件
yii migrate/create add_column_to_admin --fields=status:int(10):nontNull
生成:
<?phpuse yii/db/Migration;class m160501_053640_add_column_to_admin extends Migration{public function up(){$this->addColumn('admin', 'status', $this->int(10)->nontNull());}public function down(){$this->dropColumn('admin', 'status');}}
具體為什么會這樣,我們看下原代碼,在vendor/yiisoft/yii2/console/BaseMigrateController.php文件的actionCreate方法中:
} elseif (preg_match('/^add_(.+)_to_(.+)$/', $name, $matches)) {$content = $this->renderFile(Yii::getAlias($this->generatorTemplateFiles['add_column']), ['className' => $className,'table' => mb_strtolower($matches[2], Yii::$app->charset),'fields' => $this->fields]);}
我們可以看到,這里是正則匹配add_xxx_to_xxx來確定具體是指向哪個模板,從而生成不同的樣式。
根據migrate/create后面的參數總共匹配這幾種樣式:
1、create_junction_表名_and_表名,用來創建聯結表
2、add_xxx_to_表名,用來增加字段(可以用--fields樣式指定一個字段,否則生成空的,需要自己寫,當然也可以改模板添加個注釋示例)
3、drop_xxx_from_表名,用來刪除字段(同上)
4、create_表名,用來創建表
5、drop_表名,用來刪除表
注:可以直接在控制臺用yii help migrate來查看更多的用法
模板文件可以在vendor/yiisoft/yii2/views中找到對應的,如果想更改模板,讓其更適合自己的操作,可以這樣:
在console文件中新建views文件夾,將上方的你想修改的模板復制到這里來修改,然后再console/config/main.php中修改
return [//修改migration模板'controllerMap' => ['migrate' => ['class' => 'yii/console/controllers/MigrateController','templateFile'=>'@yii/views/migration.php',//默認模板,2.07后應該很少用了'generatorTemplateFiles' => ['create_table' => '@console/views/createTableMigration.php',//修改的'drop_table' => '@yii/views/dropTableMigration.php',//未修改的'add_column' => '@console/views/addColumnMigration.php',//修改的'drop_column' => '@console/views/dropColumnMigration.php',//修改的'create_junction' => '@yii/views/createJunctionMigration.php'//未修改的],],],];
值得注意的是generatorTemplateFiles配置中,必須將這5個都寫全了,如果不修改,則寫原來的路徑,原來的路徑可在vendor/yiisoft/yii2/console/MigrateController.php中查看,否則你用到沒寫的那個命令模板的時候就會報錯。
至于如何寫具體的創建表、添加字段等語句,其實也有版本不同(2.06新寫法)的兩種寫法,這里就不要看中文版的沒有更新的yii2指南了,直接看英文更新的,點這里,里面包含上面說的內容加具體的寫法。當初費了很多時間google搜索、順著源碼看才搞明白上面說的原理,后來一看,在人家英文版里都寫了,悲劇,而且最近我在Yii英文官網api文檔搜索任何關鍵字都不出現結果了,不知道是這邊的問題還是官網問題,只能對照著中文指南和英文指南看到底是對應的哪一塊。所以說如果英語更好點就好了,直接看英文文檔。
目前自己修改了create_table時加表注釋、段注釋(這個搜索及查源碼沒找到類似->comment的寫法,可能是為了兼容其它數據庫,所以只能拼接,而寫段注釋的好處是,gii 生成model時attributeLabels方法可以直接根據注釋來顯示對應的中文名字),add_column和drop_column模板增加一個示例注釋,方便忘了用法時參照注釋的示例來寫,而且這樣就不用加--fileds參數了。呃,這里貼一下自己的模板和最終應該建立的admin表的語句吧:
模板createTableMigration.php:
<?php/*** This view is used by console/controllers/MigrateController.php* The following variables are available in this view:*//* @var $className string the new migration class name *//* @var $table string the name table *//* @var $fields array the fields */echo "<?php/n";?>use yii/db/Migration;class <?= $className ?> extends Migration{const TBL_NAME = '{{%<?=$table?>}}';public function up(){$tableOptions = null;if ($this->db->driverName === 'mysql') {$tableOptions = 'CHARACTER SET utf8 COLLATE utf8_general_ci ENGINE=InnoDB COMMENT="填寫表注釋"';}$this->createTable(self::TBL_NAME, [<?php foreach ($fields as $field): ?><?php if ($field == end($fields)): ?>'<?= $field['property'] ?>' => $this-><?= $field['decorators']."./" COMMENT '填寫段注釋'/"" . "/n"?><?php else: ?>'<?= $field['property'] ?>' => $this-><?= $field['decorators']."./" COMMENT '填寫段注釋'/"" . ",/n"?><?php endif; ?><?php endforeach; ?>],$tableOptions);}public function down(){$this->dropTable(self::TBL_NAME);}}
具體語句m160326_133655_create_admin.php:
<?phpuse yii/db/Migration;class m160427_133556_create_admin extends Migration{const TBL_NAME = '{{%admin}}';public function up(){$tableOptions = null;if ($this->db->driverName === 'mysql') {$tableOptions = 'CHARACTER SET utf8 COLLATE utf8_general_ci ENGINE=InnoDB COMMENT="后臺管理員表"';}$this->createTable(self::TBL_NAME, ['id' => $this->primaryKey(),'username'=>$this->string()->notNull()->unique()." COMMENT '用戶名'",'auth_key'=>$this->string(32)->notNull()." COMMENT '認證Key'",'password_hash'=>$this->string()->notNull()." COMMENT '密碼'",'password_reset_token'=>$this->string()->unique()." COMMENT '密碼重置Token'",'email'=>$this->string()->notNull()->unique()." COMMENT '郵箱'",'status'=>$this->smallInteger()->notNull()->defaultValue(10)." COMMENT '狀態'",'created_at' => $this->integer()->notNull()." COMMENT '創建時間'",'updated_at' => $this->integer()->notNull()." COMMENT '更新時間'",],$tableOptions);}public function down(){$this->dropTable(self::TBL_NAME);}}
繼續運行下述命令行代碼,即可生成admin表,由于只是做演示,所以admin和user表基本一樣,不要在意這些細節。
yii migrate
好了,生成兩個表后,我們就需要將前臺登錄和后臺登陸徹底分開了:
1、前臺修改:由于已經不公用了,所以先把公用的common/models中的User.php和LoginForm.php移動到frontend/models中去,順便將這兩個文件的命名空間改為以frontend開頭,將整個前臺文件看一遍,把所有涉及到這兩個common文件命名空間的需要都改為前臺自己的命名空間。
2、后臺修改:同樣需要在backend/models中有這兩個文件Admin.php和LoginForm.php,可以使用Gii生成(需要注意要繼承IdentityInterface,實現此接口內的方法以及參照User.php來實現相關登錄注冊方法),也可以直接復制同樣上面的兩個文件(需要將User.php改名為Admin.php,且注意user表和admin表字段名稱或個數是否一致,不一致則需要在Admin.php中修改)。由于我們原先創建過后臺的GRUD,所以這里改動挺多的(searchModel,controller,view都需要改成admin的),建議對照著Gii生成的文件預覽來改。哎,如果實際要前后臺分離,本章應該放在第五章節的前面,那后臺就不需要改這么多了。
現在可以登錄前后臺試試,等等,我們后臺表雖然創建好了,但是還沒有添加管理員,現在由于后臺已經登陸不進去了,所以在后臺內也無法創建了,并且注冊功能也沒有(這種分離下,后臺一般沒必要有注冊功能),所以這里繼續用console的功能來創建一個用戶,控制臺的功能挺多的,不僅僅是數據庫管理,可以點這里了解下。
在console/controllers中新建InitController,然后如下代碼:
<?php/*** Application initialization* 參照深入理解Yii2.0視頻教程*/namespace console/controllers;use backend/models/Admin;class InitController extends /yii/console/Controller{/*** Create init admin*/public function actionAdmin(){echo "Create init admin .../n"; // 提示當前操作$username = $this->prompt('Admin Name:'); // 接收用戶名$email = $this->prompt('Email:'); // 接收Email$password = $this->prompt('Password:'); // 接收密碼$model = new Admin(); // 創建一個新用戶$model->username = $username; // 完成賦值$model->email = $email;$model->password = $password;//注意這個地方,用了Admin模型中的setPassword方法(魔術方法__set)if (!$model->save()) // 保存新的用戶{foreach ($model->getErrors() as $error) // 如果保存失敗,說明有錯誤,那就輸出錯誤信息。{foreach ($error as $e){echo "$e/n";}}return 1; // 命令行返回1表示有異常}return 0; // 返回0表示一切OK}}
InitController.php
然后再命令行中運行:
yii init/admin
按照提示來填寫用戶名密碼等,便可以產生一條數據了,當我們查看這條記錄時,發現我們填寫的明文密碼變成加密的了,而創建時間和更新和更新時間我們沒填寫也自動給填寫了,前者是由于用了__set魔術方法,后者是用了“行為”,如果不是很理解請看《深入理解Yii2.0》,里面講的比較詳細。還有就是,可能在window下cmd運行中文亂碼,大體搜了下沒找到好的解決方法,不過可以試下Cygwin這個windows下可以運行linux命令的軟件,挺好用的,設置成utf-8就不會亂碼了,而且可以用gcc什么的。
3、現在我們前后臺都能按照自己數據庫里的數據來登錄了,但是由于session等公用一個,所以還是退出時,前后臺一起退出,需要進一步操作:可以參照這篇wiki。
后臺,在backend/config/main.php或者main-local.php中
'components' => ['user' => ['identityClass' => 'backend/models/Admin','enableAutoLogin' => true,'identityCookie' => ['name' => '_backendUser', // unique for backend],],'session' => ['name' => 'PHPBACKSESSID','savePath' => sys_get_temp_dir(),],'request' => ['cookieValidationKey' => 'orGkZNZvZe3-4WicYHyGMS-EyI6Tp8yi',//random string'csrfParam' => '_backendCSRF',],
同樣在前臺,在frontend/config/main.php或者main-local.php中
'components' => ['user' => ['identityClass' => 'frontend/models/User','enableAutoLogin' => true,'identityCookie' => ['name' => '_frontendUser', // unique for frontend]],'session' => ['name' => 'PHPFRONTSESSID','savePath' => sys_get_temp_dir(),],'request' => ['cookieValidationKey' => '8rqO22WJ9yiAx_KuJ8SFnbKctqGDWi9J','csrfParam' => '_frontendCSRF',],
這樣再登陸試下,就會發現前后臺完全沒關聯了??梢哉{用Yii::$app的功能,例如Yii::$app->user->id,如果是在后臺的目錄中,會顯示后臺的用戶id,如果是在前臺的目錄中則會顯示前臺的用戶id。可能有些強迫癥患者想同Yii1那樣用Yii::$app->admin->id來訪問后臺用戶id,這個不太好實現,Yii2和Yii1相比,用戶驗證這塊改動挺大的,web/User在Yii2框架中作為核心組件,如果要修改的話應該還要關聯修改web/Application中的變量方法等,個人感覺沒必要。
以上,就是所說的,其實還有很多已經集成好的yii2-user、帶權限控制等的插件可以直接從composer中搜索使用。例如點擊率最高的這個,可以配置B類型的驗證,而且集成了更多功能。