Phinx（CakePHP）迁移中如何将MySQL float(3,2)调整为float(4,2)

Phinx里对float这类带精度的数值列的定义规则，和MySQL原生写法是拆分的，不需要把精度参数写在类型字符串里，对应关系很明确：

• precision 参数 对应MySQL float(M,D) 定义里的总位数M，也就是你这次要从3改成的数值4
• scale 参数 对应MySQL float(M,D) 定义里的小数位D，这次配置保持原有的2即可

具体迁移操作逻辑 #

修改已有列的结构，直接用Phinx提供的changeColumn方法就行，核心注意点：改列操作是全量覆盖原有列属性的，必须把原列的所有配置（非空约束、默认值、列注释）一并写到参数里，不然Phinx会把这些属性重置成默认值。
举个实际开发的写法参考：假设目标表是product，要改的列是price，原结构是float(3,2)，需要扩展为float(4,2)，迁移类的代码如下：

<?php
declare(strict_types=1);

use Phinx\Migration\AbstractMigration;

final class ExtendPriceColumnPrecision extends AbstractMigration
{
    public function change(): void
    {
        $this->table('product')
            ->changeColumn('price', 'float', [
                'precision' => 4, // 对应float(4,2)的总长度参数
                'scale' => 2,     // 保持原有2位小数的配置
                'null' => false,  // 对齐原列的非空约束
                'default' => 0,   // 对齐原列的默认值
                'comment' => '商品单价（元）' // 对齐原列的注释配置
            ])
            ->update();
    }
}

常见踩坑提醒 #

• 别把类型值直接写成float(4,2)，Phinx不会解析字符串里的括号参数，会直接抛出未知列类型的错误
• 改列时千万别漏配原有的约束属性：比如原列是不允许为空的，你改的时候不传'null' => false，迁移跑完列就变成允许为NULL，很容易引发线上数据异常
• 正式执行迁移前可以先预览生成的SQL，确认最终输出的ALTER语句里，列定义真的是FLOAT(4,2)，避免参数配错导致结构不符合预期

内容的提问来源于stack exchange，提问作者CXJ