php webman migrate 命令可用的前提是正确集成x2nx/webman-migrate插件、phinx.yml配置生效且environment名严格小写；否则会静默失败或连错库。
命令能用，但前提是插件已正确集成、
配置生效、且环境名严格小写——否则命令会静默失败或连错库。
为什么
不执行或报错
Webman 本身不内置迁移能力，依赖
插件桥接 Phinx。常见失败不是命令不存在，而是底层配置未被识别：
中
缺失或拼错，插件会 fallback 到空实现
项目根目录没有
（注意：不是
），Phinx 默认完全忽略 PHP 格式配置
下写了
或
，Phinx 只认小写
/
Docker 环境中
导致连接拒绝——容器内
指自身，应填数据库服务容器名（如
）
生成的文件不被识别
Webman 插件默认只扫描
目录，且要求文件名含完整时间戳前缀（如
）。手动创建或重命名会破坏识别逻辑：
必须用
生成，不能手建空类
类名必须与文件名后缀一致（
），且继承
若改过
中的
路径（如设为
），需同步在插件配置中声明：
文件里用
方法没问题，但 Webman 插件对
/
兼容性更稳，尤其涉及字段重命名等操作时
执行后表没创建，但
有记录
这说明 Phinx 认为迁移“成功”了，但 SQL 实际未生效——通常是权限或语法问题：
PHP 8.5.5
PHP 8.5.5 是 PHP 8.5 分支的维护更新版本。该版本延续了“小步快跑”的迭代逻辑，通过深度错误修复、底层性能微调以及安全加固，旨在为开发者提供一个更健壮、更高效的运行环境。该版本严格遵守语义化版本规范，不包含破坏性变更。
下载
MySQL 用户缺少
权限（不只是
），检查
语句是否包含
迁移中用了
或
类型，而目标 MySQL 版本不支持（如 MySQL 5.6 不支持 JSON）
和
在
里没显式声明，某些环境会退化为
，导致建表语句被截断
执行时加
参数验证：
，看输出的 SQL 是否符合预期
生产环境回滚前必须确认的三件事
Phinx 的
在生产库上是高危操作，
并不等价于开发环境的“撤销”：
立即学习
“
PHP免费学习笔记（深入）
”；
确保
方法真正可逆——比如
的逆操作不是删字段，而是清空+删列，但若该列已有业务数据，回滚会丢失
检查
表是否在生产库中存在且可写；如果之前是手动建表或跨库迁移，该表可能缺失
Webman 插件默认不支持
这类精细回滚，只能整批撤回，务必先在预发环境用相同数据集跑通全流程
Webman + Phinx 的关键不在“会不会用命令”，而在于配置文件是否被真正加载、环境名是否大小写敏感、以及每个迁移是否经得起 down() 推演——这些点一旦出错，往往没有明显报错，只有表结构和线上行为对不上。
php webman migratephinx.ymlphp webman migratex2nx/webman-migrateconfig/plugin/x2nx/webman-migrate/app.php'driver' => 'phinx'phinx.ymlphinx.phpenvironmentsDevelopmentPRODUCTIONdevelopmentproductionhost: localhostlocalhostmysqlphp vendor/bin/phinx createdatabase/migrations20260526120000_create_users_table.phpphp vendor/bin/phinx create CreateUsersTableCreateUsersTablePhinx\Migration\AbstractMigrationphinx.ymlmigrationsdb/migrations'migrations_path' => 'db/migrations'change()up()down()php webman migratephinxlogCREATE TABLESELECTGRANTALL PRIVILEGES ON `dbname`.*ENUMJSONcharsetcollationphinx.ymllatin1--dry-runphp vendor/bin/phinx migrate -e development --dry-runrollbackphp webman migrate:rollbackdown()addColumn('status', 'string')phinxlog--step=2