一、什么是YII数据迁移？

YII框架的数据迁移（Migration）本质上是数据库版本控制系统，它将数据库结构变更以代码形式保存，允许开发者像管理程序代码一样管理数据库的演进过程。不同于直接修改数据库，迁移通过创建可重复执行的迁移类文件，确保开发、测试、生产环境的数据库结构完全一致。

传统数据库变更的痛点：
- 手工执行SQL容易遗漏步骤
- 团队协作时难以同步结构变更
- 缺乏版本回退能力
- 生产环境与开发环境结构不一致

YII通过yii\console\controllers\MigrateController核心组件，将数据库变更转化为可追溯的PHP类文件，每个迁移文件对应一次结构变更，形成清晰的版本链。

二、YII迁移核心工作机制

1. 迁移文件结构解析

典型的迁移类继承yii\db\Migration，包含两个核心方法：php
class m200101102030createusertable extends Migration
{
public function up()
{
$this->createTable('user', [
'id' => $this->primaryKey(),
'username' => $this->string()->notNull()->unique()
]);
}

public function down()
{
    $this->dropTable('user');
}

}
- up()方法定义变更应用逻辑
- down()方法实现变更回滚操作

2. 迁移版本追踪原理

YII通过migration表记录已执行的迁移，包含版本号（如m200101_102030）、应用时间等关键信息。每次执行迁移命令时，系统会比较文件系统与数据库中的版本差异，智能确定需要执行的迁移文件。

三、实战：完整的迁移工作流

1. 创建新迁移

bash

生成用户表迁移文件

php yii migrate/create createusertable
生成文件位于@app/migrations/目录，命名遵循m<年月日_时分秒>_<描述>的规范格式。

2. 编写迁移逻辑

php
public function up()
{
$this->createTable('article', [
'id' => $this->primaryKey(),
'title' => $this->string(255)->notNull(),
'content' => $this->text(),
'createdat' => $this->timestamp()->defaultExpression('CURRENTTIMESTAMP')
]);

// 添加外键约束
$this->addForeignKey(
    'fk-article-author',
    'article',
    'author_id',
    'user',
    'id',
    'CASCADE'
);

}

3. 执行迁移

bash

执行所有未应用的迁移

php yii migrate/up

指定批量迁移数量

php yii migrate/up --limit=3

4. 回滚操作

bash

回滚最近一次迁移

php yii migrate/down

回滚指定数量迁移

php yii migrate/down 2

四、高级迁移技巧

1. 事务性迁移

php public function safeUp() // 替代up() { $transaction = $this->db->beginTransaction(); try { $this->addColumn('user', 'phone', $this->string(20)); $transaction->commit(); } catch (\Exception $e) { $transaction->rollBack(); throw $e; } }

2. 数据种子迁移

php public function up() { $this->batchInsert('department', ['name', 'leader_id'], [ ['研发部', 1], ['市场部', 2] ] ); }

3. 环境差异化处理

php if (YII_ENV_PROD) { $this->alterColumn('payment', 'amount', $this->decimal(12,2)); } else { $this->addColumn('payment', 'test_flag', $this->boolean()); }

五、企业级最佳实践

1. 版本控制规范

   
   
   
   • 将迁移文件纳入Git版本控制
   • 禁止直接修改已提交的迁移文件
   • 生产环境只允许通过迁移工具变更结构

2. 团队协作流程
   mermaid graph TD 开发者创建迁移 --> 提交Pull Request 技术负责人审核 --> 合并到develop分支 自动化测试 --> 生产环境部署

3. 性能优化方案

   
   
   
   • 大批量数据迁移使用batchInsert替代循环insert
   • 结构变更前先检查是否存在if ($this->tableExists('table'))
   • 生产环境执行前先在预发布环境验证

YII的迁移工具将数据库变更转化为可重复、可逆、可协作的开发资产，是现代Web开发中不可或缺的工程实践。通过规范化使用迁移，团队可以显著降低数据库管理风险，提高部署可靠性。