1.简介
众所周知,生产环境的数据库、测试环境的数据库以及线上环境的数据库结构是一样的,但是在开发环境中,难免会遇到添加字段或者修改字段这种修改数据库表的操作,所以 Yii 提供了一个 数据库迁移 功能,该功能可以记录数据库的变化, 以便使数据库和源代码一起受版本控制。.
其实大概也就这些操作最熟悉不过了,其他具体请浏览Yii官方文档;
不得不吐槽的是 Yii2 官网的实例少之又少,又因为在共同开发中需要用到数据库迁移,所以写这篇文章。
2.数据库迁移之命名规则
在这里只是定义自己的命名规则,PSR规范并没有强调,只是方便自己观看迁移文件路由而已~
-
创建数据库表:create_tablename_{数据库表名}
-
数据库表添加字段:add_column_to_{数据库表名}
-
数据库表添加数据:add_auth_on_{数据库表名}
-
数据库表删除字段:drop_xxx_from_{数据库表名}
-
数据库表添加索引:add_index_to_{数据库表名}
-
添加连接表:create_junction_xxx_and_yyy
3.创建数据库表
在控制台输入 php yii migrate/create create_tablename_{数据库表名}
public function safeUp()
{
//设置数据表的属性
$tableOptions = null;
if ($this->db->driverName === 'mysql') {
$tableOptions = 'CHARACTER SET utf8 COLLATE utf8_general_ci ENGINE=InnoDB';
}
//创建一个表
$this->createTable('{{employee_interview}}', [
'id' => $this->primaryKey(),
'employee_id' => $this->integer(11)->notNull()->comment('员工id'),
'jobnum' => $this->string(11)->notNull()->comment('员工工号'),
'name' => $this->string(11)->notNull()->comment('员工姓名'),
'jobstation' => $this->string(11)->notNull()->comment('员工岗位'),
'resign' => $this->string(11)->notNull()->comment('员工在职情况'),
'entryDate' => $this->string(11)->notNull()->comment('员工入职时间'),
'job_rank' => $this->string(30)->notNull()->comment('员工岗位等级'),
'dept' => $this->string(30)->notNull()->comment('员工部门'),
'is_transfer' => $this->string(50)->notNull()->defaultValue('N')->comment('是否愿意调岗:N/否,(描述)/是'),
'work_record' => $this->string(500)->notNull()->defaultValue('')->comment('工作能力记录'),
'work_level' => $this->string(100)->notNull()->defaultValue('')->comment('工作能力评级'),
'worth_record' => $this->string(500)->notNull()->defaultValue('')->comment('价值观记录'),
'worth_level' => $this->string(100)->notNull()->defaultValue('')->comment('价值观评级'),
'other' => $this->string(255)->notNull()->defaultValue('')->comment('其他'),
'delete_at' => $this->integer(11)->notNull()->defaultValue(0)->comment('删除时间'),
], $tableOptions);
//增加或者修改一个表备注
$this->addCommentOnTable('{{employee_interview}}','员工访谈记录信息表');
}
在这里简单说明一下,
-
$this->string:这里是指当前定义的字段类型
-
notNull:字段类型不能为空
-
defaultValue:字段模型值
-
comment:字段备注
4.添加字段
在控制台输入php yii migrate/create add_column_to_{数据库表名}
public function safeUp()
{
//addColumn('表名','字段', '属性')
$this->addColumn('negative_review','choose', $this->tinyInteger(1)->notNull()->defaultValue(0)->comment('是否自动分类(1:自动分类 2:否)'));
$this->addColumn('comment_answer','file', $this->string(255)->notNull()->defaultValue('')->comment('数据分析图路径'));
}
5.添加索引
在控制台输入 php yii migrate/create add_index_on_{数据库表名}
public function safeUp()
{
$this->createIndex('idx_order_num', 'product_evaluation_product', ['order_num']);
}
6.添加数据
在控制台输入 php yii migrate/create add_auth_to_{数据库表名}
public function safeUp()
{
$data = [
['Index', 0, '行政管理-列表' , 'N;'],
['gift-giving', 0, '行政管理-转增' , 'N;']
];
$column = ['name', 'type', 'description', 'data'];
Yii::$app->db->createCommand()->batchInsert('{{%auth_item}}', $column, $data)->execute();
}
7.修改数据
在控制台输入 php yii migrate/create update_auth_to_{数据库表名}
public function safeUp()
{
Yii::$app->db->createCommand()->update('auth_item', ['description' => '访谈问题-回复'] ,['name' => 'ReplyAddInterview'])->execute();
Yii::$app->db->createCommand()->update('auth_item', ['description' => '访谈问题-修改'] ,['name' => 'ReplyEditInterview'])->execute();
}
8.删除数据
在控制台输入 php yii migrate/create del_auth_to_{数据库表名}
public function safeUp()
{
Yii::$app->db->createCommand()->delete('auth_item', ['name' => 'AddInterview'])->execute();
Yii::$app->db->createCommand()->delete('auth_item', ['name' => 'EditInterview'])->execute();
}
9.提交迁移
./yii migrate //提交所有迁移,但是已经迁移过的文件不会被执行
./
./yii migrate XXX_xxx_XXX_table //**指定类名**,提交一个迁移文件
10.还原迁移
./yii migrate/down //还原最近一次迁移
./yii migrate 3 //提交前三个可用的迁移
./yii migrate/down 3 //还原最近三次迁移
11.重做迁移
重做迁移的意思是先还原指定的迁移,然后再次提交:
./yii migrate/redo //重做最近一次提交的迁移
./yii migrate/redo //重做最近三次提交的迁移
12.列出迁移
可以通过指令列出提交或者未提交的迁移:
./yii migrate/history //显示最近10次提交的迁移
./yii migrate/history 6 //显示最近5次提交的迁移
./yii migrate/history all //显示所有的提交迁移
./yii migrate/new //显示最近10次未提交的迁移
./yii migrate/new 6 //显示最近6次未提交的迁移
./yii migrate/new all //显示所有的未提交迁移
13.其他操作数据库的方法
yii\db\Migration::execute(): 执行一条 SQL 语句
yii\db\Migration::insert(): 插入单行数据
yii\db\Migration::batchInsert(): 插入多行数据
yii\db\Migration::update(): 更新数据
yii\db\Migration::delete(): 删除数据
yii\db\Migration::createTable(): 创建表
yii\db\Migration::renameTable(): 重命名表名
yii\db\Migration::dropTable(): 删除一张表
yii\db\Migration::truncateTable(): 清空表中的所有数据
yii\db\Migration::addColumn(): 加一个字段
yii\db\Migration::renameColumn(): 重命名字段名称
yii\db\Migration::dropColumn(): 删除一个字段
yii\db\Migration::alterColumn(): 修改字段
yii\db\Migration::addPrimaryKey(): 添加一个主键
yii\db\Migration::dropPrimaryKey(): 删除一个主键
yii\db\Migration::addForeignKey(): 添加一个外键
yii\db\Migration::dropForeignKey(): 删除一个外键
yii\db\Migration::createIndex(): 创建一个索引
yii\db\Migration::dropIndex(): 删除一个索引