当前位置:首页 > CMS教程 > 其它CMS > 列表

Yii2前后台分离及migrate使用(七)

发布:smiling 来源: PHP粉丝网  添加日期:2021-08-01 13:18:35 浏览: 评论:0 

这篇文章主要介绍了Yii2前后台分离及migrate使用的相关资料,需要的朋友可以参考下

最近一直忙其它的(其实是懒!),将《深入理解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

生成:

  1. <?php 
  2. use yii\db\Migration; 
  3. class m160501_053640_add_column_to_admin extends Migration 
  4. public function up() 
  5. $this->addColumn('admin''status'$this->int(10)->nontNull()); 
  6. public function down() 
  7. $this->dropColumn('admin''status'); 

具体为什么会这样,我们看下原代码,在vendor/yiisoft/yii2/console/BaseMigrateController.php文件的actionCreate方法中:

  1. elseif (preg_match('/^add_(.+)_to_(.+)$/'$name$matches)) { 
  2. $content = $this->renderFile(Yii::getAlias($this->generatorTemplateFiles['add_column']), [ 
  3. 'className' => $className
  4. 'table' => mb_strtolower($matches[2], Yii::$app->charset), 
  5. 'fields' => $this->fields 
  6. ]); 

我们可以看到,这里是正则匹配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中修改

  1. return [ 
  2. //修改migration模板 
  3. 'controllerMap' => [ 
  4. 'migrate' => [ 
  5. 'class' => 'yii\console\controllers\MigrateController'
  6. 'templateFile'=>'@yii/views/migration.php',//默认模板,2.07后应该很少用了 
  7. 'generatorTemplateFiles' => [ 
  8. 'create_table' => '@console/views/createTableMigration.php',//修改的 
  9. 'drop_table' => '@yii/views/dropTableMigration.php',//未修改的 
  10. 'add_column' => '@console/views/addColumnMigration.php',//修改的 
  11. 'drop_column' => '@console/views/dropColumnMigration.php',//修改的 
  12. 'create_junction' => '@yii/views/createJunctionMigration.php'//未修改的 
  13. ], 
  14. ], 
  15. ], 
  16. ]; 

值得注意的是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:

  1. <?php 
  2. /** 
  3. * This view is used by console/controllers/MigrateController.php 
  4. * The following variables are available in this view: 
  5. */ 
  6. /* @var $className string the new migration class name */ 
  7. /* @var $table string the name table */ 
  8. /* @var $fields array the fields */ 
  9. echo "<?php\n"
  10. ?> 
  11. use yii\db\Migration; 
  12. class <?= $className ?> extends Migration 
  13. const TBL_NAME = '{{%<?=$table?>}}'
  14. public function up() 
  15. $tableOptions = null; 
  16. if ($this->db->driverName === 'mysql') { 
  17. $tableOptions = 'CHARACTER SET utf8 COLLATE utf8_general_ci ENGINE=InnoDB COMMENT="填写表注释"'
  18. $this->createTable(self::TBL_NAME, [ 
  19. <?php foreach ($fields as $field): ?> 
  20. <?php if ($field == end($fields)): ?> 
  21. '<?= $field['property'] ?>' => $this-><?= $field['decorators'].".\" COMMENT '填写段注释'\"" . "\n"?> 
  22. <?php else: ?> 
  23. '<?= $field['property'] ?>' => $this-><?= $field['decorators'].".\" COMMENT '填写段注释'\"" . ",\n"?> 
  24. <?php endif; ?> 
  25. <?php endforeach; ?> 
  26. ],$tableOptions); 
  27. public function down() 
  28. $this->dropTable(self::TBL_NAME); 

具体语句m160326_133655_create_admin.php:

  1. <?php 
  2. use yii\db\Migration; 
  3. class m160427_133556_create_admin extends Migration 
  4. const TBL_NAME = '{{%admin}}'
  5. public function up() 
  6. $tableOptions = null; 
  7. if ($this->db->driverName === 'mysql') { 
  8. $tableOptions = 'CHARACTER SET utf8 COLLATE utf8_general_ci ENGINE=InnoDB COMMENT="后台管理员表"'
  9. $this->createTable(self::TBL_NAME, [ 
  10. 'id' => $this->primaryKey(), 
  11. 'username'=>$this->string()->notNull()->unique()." COMMENT '用户名'"
  12. 'auth_key'=>$this->string(32)->notNull()." COMMENT '认证Key'"
  13. 'password_hash'=>$this->string()->notNull()." COMMENT '密码'"
  14. 'password_reset_token'=>$this->string()->unique()." COMMENT '密码重置Token'"
  15. 'email'=>$this->string()->notNull()->unique()." COMMENT '邮箱'"
  16. 'status'=>$this->smallInteger()->notNull()->defaultValue(10)." COMMENT '状态'"
  17. 'created_at' => $this->integer()->notNull()." COMMENT '创建时间'"
  18. 'updated_at' => $this->integer()->notNull()." COMMENT '更新时间'"
  19. ],$tableOptions); 
  20. public function down() 
  21. $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,然后如下代码:

  1. <?php 
  2. /** 
  3. * Application initialization 
  4. * 参照深入理解Yii2.0视频教程 
  5. */ 
  6. namespace console\controllers; 
  7. use backend\models\Admin; 
  8. class InitController extends \yii\console\Controller 
  9. /** 
  10. * Create init admin 
  11. */ 
  12. public function actionAdmin() 
  13. echo "Create init admin ...\n"// 提示当前操作 
  14. $username = $this->prompt('Admin Name:'); // 接收用户名 
  15. $email = $this->prompt('Email:'); // 接收Email 
  16. $password = $this->prompt('Password:'); // 接收密码 
  17. $model = new Admin(); // 创建一个新用户 
  18. $model->username = $username// 完成赋值 
  19. $model->email = $email
  20. $model->password = $password;//注意这个地方,用了Admin模型中的setPassword方法(魔术方法__set) 
  21. if (!$model->save()) // 保存新的用户 
  22. foreach ($model->getErrors() as $error// 如果保存失败,说明有错误,那就输出错误信息。 
  23. foreach ($error as $e
  24. echo "$e\n"
  25. return 1; // 命令行返回1表示有异常 
  26. 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中

  1. 'components' => [ 
  2. 'user' => [ 
  3. 'identityClass' => 'backend\models\Admin'
  4. 'enableAutoLogin' => true, 
  5. 'identityCookie' => [ 
  6. 'name' => '_backendUser'// unique for backend 
  7. ], 
  8. ], 
  9. 'session' => [ 
  10. 'name' => 'PHPBACKSESSID'
  11. 'savePath' => sys_get_temp_dir(), 
  12. ], 
  13. 'request' => [ 
  14. 'cookieValidationKey' => 'orGkZNZvZe3-4WicYHyGMS-EyI6Tp8yi',//random string 
  15. 'csrfParam' => '_backendCSRF'
  16. ], 

同样在前台,在frontend/config/main.php或者main-local.php中

  1. 'components' => [ 
  2. 'user' => [ 
  3. 'identityClass' => 'frontend\models\User'
  4. 'enableAutoLogin' => true, 
  5. 'identityCookie' => [ 
  6. 'name' => '_frontendUser'// unique for frontend 
  7. ], 
  8. 'session' => [ 
  9. 'name' => 'PHPFRONTSESSID'
  10. 'savePath' => sys_get_temp_dir(), 
  11. ], 
  12. 'request' => [ 
  13. 'cookieValidationKey' => '8rqO22WJ9yiAx_KuJ8SFnbKctqGDWi9J'
  14. 'csrfParam' => '_frontendCSRF'
  15. ], 

这样再登陆试下,就会发现前后台完全没关联了。可以调用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类型的验证,而且集成了更多功能。

Tags: Yii2前后台分离 migrate

分享到: