应优先使用 Schema::TYPE_* 常量定义字段类型,避免字符串字面量;错误迁移需先回滚再修改代码;多库需显式指定 db 组件或使用 --db 参数;SchemaBuilder 生成 SQL 不跨库兼容;表结构变更后必须同步更新 Model 的 rules()。

yii migrate 创建表时字段类型写错怎么办
Yii 的 migrate 本身不校验字段类型合法性,比如把 integer() 写成 int()(在 MySQL 中虽可运行,但 Yii 会报 Unknown column type: int 错误),或在 PostgreSQL 中误用 string() 而非 text()。这类错误只在执行 php yii migrate 时暴露,且回滚不一定干净。
- 建表前先查
yii\db\Schema::TYPE_*常量,如Schema::TYPE_INTEGER、Schema::TYPE_STRING,优先用常量而非字符串字面量 - MySQL 下
string(255)等价于varchar(255),但 PostgreSQL 不支持string,必须显式用text()或char(10) - 若已提交错误迁移,别直接改
up()—— 先php yii migrate/down 1,再修正代码,最后php yii migrate/up;否则新环境会跳过该文件
yii migrate 批量同步多个数据库 schema 怎么做
Yii 默认只连一个 db 组件,多库 schema 同步需手动切换连接。没有内置“跨库 migrate”机制,硬套 yii migrate 会出错:比如 Unknown database connection: db2。
- 在迁移类中用
$this->db = \Yii::$app->get('db2')显式指定连接,注意提前在配置里注册db2组件 - 避免在
up()中混用多个$this->db实例——事务不跨库,无法原子性保证 - 推荐拆成独立迁移文件,命名带库标识,如
m1234567890_create_user_table_db2.php,并通过--db=db2参数指定执行目标:php yii migrate --db=db2
yii migrate 生成的 SQL 在不同数据库下兼容吗
不兼容。Yii 的 SchemaBuilder(如 $this->createTable())底层调用的是当前 DBMS 的 DDL,生成的 SQL 会随 db 组件驱动变化。例如 boolean() 在 MySQL 输出 TINYINT(1),在 PostgreSQL 输出 BOOLEAN,直接复制 SQL 到另一库大概率失败。
- 不要从
yii migrate/create生成的 PHP 文件里“提取 SQL”手工执行——丢失了 Yii 对索引、外键、注释的抽象封装 - 跨库部署前,务必用目标环境的
db配置跑一遍php yii migrate,而不是复用开发机导出的 SQL - 若需导出 SQL,用
php yii migrate/up --interactive=0 --migrationPath=@app/migrations > dump.sql不生效;正确做法是启用yii\console\controllers\MigrateController::$generateSqlFile并配合自定义 controller
schema 变更后 model 验证规则没更新导致数据插入失败
这是最隐蔽的问题:表加了 NOT NULL 字段,但 ActiveRecord 的 rules() 没同步,结果 save() 时数据库报错(如 Column 'status' cannot be null),而 Yii 层面没触发验证,用户看到的是 500 而非表单提示。
- 字段约束变更后,必须同步检查
rules()是否包含对应required、default或safe规则 - 用
./yii gii/model重新生成 model 时勾选Generate Relations和Generate Labels,但 Gii 不自动更新rules(),仍需人工比对 - 上线前跑一次
SELECT column_name,is_nullable,data_type FROM information_schema.columns WHERE table_name='xxx',和 model 的rules()做快速核对
php
// 示例:安全地为多库添加字段(避免跨库事务)
public function up(Schema $schema): void
{
// 主库操作
$this->db = \Yii::$app->db;
$this->addColumn('{{%user}}', 'avatar_url', $this->string()->null());
// 从库操作(单独连接)
$db2 = \Yii::$app->get('db2');
$db2->createCommand()->addColumn('{{%user_profile}}', 'bio', 'TEXT')->execute();
}
实际用下来,Yii 的 schema 管理顺不顺,取决于你是否接受“PHP 逻辑即 schema 定义”这个前提——它灵活,但绝不自动同步、不跨库兜底、不校验语义。最容易被忽略的是 model 验证与数据库约束之间的断层,那里藏着最多线上 500。









