Yii高级版初始化用户表

关注微信公众号，获取更多PHP技术文字推送：

1、背景说明

在我们初始化数据库后会发现，user表是空的，也就是说后台是无法登录的，本文介绍如何初始化用户表。

2、初识Migrate

migrate是Yii提供的一个数据库变动版本化管理工具，可以实现命令行式调整数据库的表及数据，以后我们会专门介绍这个工具，本文只涉及migrate对login功能的贡献。

目标：利用migrate添加第一个用户。

2.1 进入容器

migrate的使用依赖于/app/yii这个可执行文件，因此需要进入到这个目录下：

chenzhiwei:advanced$ docker exec -it advanced_backend_1 /bin/bash
        _ _  __                                             _
       (_|_)/ _|                                           | |
  _   _ _ _| |_ _ __ __ _ _ __ ___   _____      _____  _ __| | __
 | | | | | |  _| '__/ _` | '_ ` _ \ / _ \ \ /\ / / _ \| '__| |/ /
 | |_| | | | | | | | (_| | | | | | |  __/\ V  V / (_) | |  |   <
  \__, |_|_|_| |_|  \__,_|_| |_| |_|\___| \_/\_/ \___/|_|  |_|\_\
   __/ |
  |___/

PHP version: 7.4.21
root@16e25a86e3b5:/app# 

2.2 利用migrate创建文件

需要创建一个文件，用于编写user表insert数据的代码。

root@16e25a86e3b5:/app# ls console/migrations/
m130524_201442_init.php  m190124_110200_add_verification_token_column_to_user_table.php

root@16e25a86e3b5:/app# yii migrate/create use_create_admin
Yii Migration Tool (based on Yii v2.0.42.1)
Create new migration '/app/console/migrations/m210708_100136_use_create_admin.php'? (yes|no) [no]:yes
New migration created successfully.

root@16e25a86e3b5:/app# ls console/migrations/
m130524_201442_init.php  m190124_110200_add_verification_token_column_to_user_table.php  m210708_100136_use_create_admin.php

yii migrate/create use_create_admin命令的结果就是创建了m210708_100136_use_create_admin.php这个文件，我们可以在这个文件中编写sql插入第一个用户。

但是m210708_100136_use_create_admin.php这个文件应该对ide非可写的权限，因此我们需要调整权限。

root@16e25a86e3b5:/app# chmod o+w console/migrations/m210708_100136_use_create_admin.php

2.4 插入数据

m210708_100136_use_create_admin.php文件如下：

<?php

use yii\db\Migration;

/**
 * Class m210708_100136_use_create_admin
 */
class m210708_100136_use_create_admin extends Migration
{
    /**
     * {@inheritdoc}
     */
    public function safeUp()
    {
        $user = new \common\models\User();
        $user->username = "admin";
        $user->email = "chenzhiweiwk@qq.com";
        $user->status = \common\models\User::STATUS_ACTIVE;
        $user->setPassword("123456");
        $user->generateAuthKey();
        return $user->save();
    }

    /**
     * {@inheritdoc}
     */
    public function safeDown()
    {
        \common\models\User::deleteAll(["username" => "admin"]);
        return true;
    }
}

2.5 执行变更

我们需要用Migrate工具来执行此文件中的代码，如下：

root@16e25a86e3b5:/app# yii migrate/up
Yii Migration Tool (based on Yii v2.0.42.1)

Total 1 new migration to be applied:
        m210708_100136_use_create_admin                                              
        
Apply the above migration? (yes|no) [no]:yes
*** applying m210708_100136_use_create_admin
*** applied m210708_100136_use_create_admin (time: 0.390s) 

1 migration was applied.

Migrated up successfully. 

yii migrate/up命令其实执行的是safeUp()中的代码；

2.6 撤销变更

如果发现代码有错，可以执行如下命令来恢复数据：

root@16e25a86e3b5:/app# yii migrate/down 1 
Yii Migration Tool (based on Yii v2.0.42.1)

Total 1 migration to be reverted:
        m210708_100136_use_create_admin
        
Revert the above migration? (yes|no) [no]:yes
*** reverting m210708_100136_use_create_admin
*** reverted m210708_100136_use_create_admin (time: 0.010s)                                                                              
1 migration was reverted.

Migrated down successfully. 

yii migrate/down 1执行的是safeDown()中的代码。

3、注意要点

我们在插入用户的时候，一定要将status设置为10，否则如果默认设置为9，系统是禁用状态为9的用户登录的，status的取值及意义如下：

    const STATUS_DELETED = 0;
    const STATUS_INACTIVE = 9;
    const STATUS_ACTIVE = 10;