对Yii2 migrate数据库迁移的一些看法和操作分享

摘要：事务性的迁移整体迁移或回滚执行复杂的迁移时，通常想确定每个完整迁移全体是成功了还是失败了，以便数据库保持一致和完整。在创建数据表的过程中可以同时声称多张表，删除多张表。相关资料数据库迁移之数据库迁移

Yii2 migrate 数据库迁移要我用一个词形容的话，“鸡助”最适合不过了，食之无味，弃之可惜。Yii2 migrate能完成的操作，手工会更快，数据表结构变化也不能保存源表的数据，但是对于一些修改和建表操作在团队协作中还是挺方便的，数据库管理者只需要执行yii migrate的命令就能操作表，追踪数据库迁移的历史，应用新的迁移版本，或恢复之前的迁移版本。但凡有优劣，可当优势大于劣势的时候，我们会更多的去考虑如何落地的问题。

1、建立新的迁移请运行以下命令：
./yii migrate/create plan_admin //plan_admin 迁移建立名为plan_admin的新表

2、运行结果，生成文件及文件名看下图：

3、打开m170108_055206_plan_admin.php即可看到

注释：当执行./yii migrate/create plan_admin命令遇到如下问题："The configuration for the "user" component must contain a "class" element." 或者"The configuration for the "session" component must contain a "class" element."。
解决办法：
首先说一下问题的根源，是你的配置文件（main.php）配置user或者session的时候缺少了class类了，加上即可。 user类："class" => yiiwebUser，session类："class" => "yiiwebSession"，注意这里的类必须是yiiweb下的，不能自定义，否则错误问题没法解决。参考网址
创建数据表
 public function up()
    {
            $tableOptions = null;
            if ($this->db->driverName === "mysql") {
              $tableOptions = "CHARACTER SET utf8 COLLATE utf8_general_ci ENGINE=InnoDB COMMENT="计划管理表"";
            }
            //一开始没有PlanAdmin models类可将PlanAdmin::tableName()用"{{plan_admin}}"替换。
            $this->createTable(PlanAdmin::tableName(), [
                "id" => $this->primaryKey(),
                "titile" => $this->string(100)->notNull()->comment("计划标题"),
                "module" => $this->integer()->defaultValue(0)->comment("模块"),
                "status" => $this->integer()->defaultValue(0)->comment("状态"),
                "plan_content" => $this->text()->comment("计划内容"),
                "supervisor" => $this->string(100)->comment("督导人"),
                "end_time" => $this->integer()->comment("完成时间"),
                "daily_maxim" => $this->text()->comment("每日格言"),
                "daily_summary" => $this->text()->comment("每日总结"),
                "company_id" => $this->integer()->comment("公司id"),
                "created_time" => $this->integer()->comment("添加时间"),
                "update_time" => $this->integer()->comment("修改时间"),
            ], $tableOptions);

    }
添加字段
 public function up()
    {   
        //添加字段
        $this->addColumn(PlanAdmin::tableName(), "user_id", "INT(11) DEFAULT 0 COMMENT "计划人" AFTER `titile`");
        // $this->addColumn(PlanAdmin::tableName(), "company_id", "INT(10) NOT NULL COMMENT "公司id" AFTER `daily_summary`");
    }

修改字段
 public function up()
    {   
        
        $this->alterColumn(PlanAdmin::tableName(), "end_time", "string(150) COMMENT "完成时间"");
    }
增加索引
public function up()
 {
    $this->createIndex("module", PlanAdmin::tableName(), ["module"],true); 
 }
删除某字段
public function down()
 {
    $this->dropColumn(PlanAdmin::tableName(), "update_time");
 }
删除某表
public function down()
  {
    $this->dropTable(PlanAdmin::tableName());
  }
添加主键
public function up()
    {   
        $this->addForeignKey("contract_id" , "{{service_plan}}" , "contract_id" , "{{contract}}" , "id" , "CASCADE" , "RESTRICT");
    }
    
    addForeignKey()方法的参数注释：
    
    参数1：设置本表的外键名（可自定义）。
    参数2：本表表名。
    参数3：本表中与外表关联的字段名称。如果有多个字段，以逗号分隔或使用一个数组。
    参数4：外表表名。
    参数5：外表中与本表关联的字段名称。如果有多个字段，以逗号分隔或使用一个数组。
    参数6：删除选项，可选，默认为空。可选的类型有 RESTRICT, CASCADE, NO ACTION, SET DEFAULT, SET NULL。
    参数7：更新选项，可选，默认为空。可选的类型有 RESTRICT, CASCADE, NO ACTION, SET DEFAULT, SET NULL。
    
    注意：参数3和参数5的字段类型必须一致，否则执行失败。
事务性的迁移（整体迁移或回滚）
执行复杂的 DB 迁移时，通常想确定每个完整迁移全体是成功了还是失败了，以便数据库保持一致和完整。为实现该目标，可以利用数据库事务来处理，使用专用的 safeUp 和 safeDown 方法来达到这些目的。参考文档
常用命令
./yii migrate 默认执行 ./yii migrate/up 
./yii migrate/down 执行某些撤销对表的操作
./yii migrate/redo (指定了重做多少迁移，默认为 1) 重做迁移 就是首先回退然后应用指定的迁移
./yii migratre/to （迁移文件名）执行某个指定的迁移文件
./yii migrate/history (迁移数量，不指定将显示所有) 显示被应用的所有迁移
./yii migrate/new （迁移数量，不指定将显示所有） 显示没有被应用的所有新迁移。
在创建数据表的过程中可以同时声称多张表，删除多张表。
执行过的迁移文件，会在数据库的migration中生成一条记录，记录此迁移文件已经执行过，下次将执行数据表中不存在的迁移文件。意思就是说文件执行过了，想要再次执行的话，得把文件名改一下。
如下是所有这些数据库访问方法的列表：
yiidbMigration::execute(): 执行一条 SQL 语句
yiidbMigration::insert(): 插入单行数据
yiidbMigration::batchInsert(): 插入多行数据
yiidbMigration::update(): 更新数据
yiidbMigration::delete(): 删除数据
yiidbMigration::createTable(): 创建表
yiidbMigration::renameTable(): 重命名表名
yiidbMigration::dropTable(): 删除一张表
yiidbMigration::truncateTable(): 清空表中的所有数据
yiidbMigration::addColumn(): 加一个字段
yiidbMigration::renameColumn(): 重命名字段名称
yiidbMigration::dropColumn(): 删除一个字段
yiidbMigration::alterColumn(): 修改字段
yiidbMigration::addPrimaryKey(): 添加一个主键
yiidbMigration::dropPrimaryKey(): 删除一个主键
yiidbMigration::addForeignKey(): 添加一个外键
yiidbMigration::dropForeignKey(): 删除一个外键
yiidbMigration::createIndex(): 创建一个索引
yiidbMigration::dropIndex(): 删除一个索引
注意事项
以上是XFtp上操作记录，如果是本地的话运行时把yii前面的“./”去掉。注意要在项目的根目录运行命令。
相关资料
Yii2 migrate 数据库迁移
Yii2之数据库迁移（Migrate）