Webman 默认不支持 Phinx，需手动配置：在项目根目录创建 phinx.php 加载 Webman 数据库配置并映射为 environments 结构，注册 PhinxCommand 命令到 support/command 体系，补全 composer autoloader 并规范迁移文件路径与命名。
Webman 默认不支持 Phinx，直接 require 安装后无法自动识别 migrations 目录或执行命令 —— 根本原因是 Webman 没有内置命令注册机制和 Phinx 的 Application 初始化逻辑。
为什么 composer require robmorgan/phinx 后运行 vendor/bin/phinx 报错 “No config file found”
Phinx 启动时默认在当前工作目录找 phinx.php 或 phinx.yml，而 Webman 项目根目录通常没有这个文件；且 Webman 的 config/database.php 结构与 Phinx 不兼容，不能直接复用。
- 必须手动创建
phinx.php（推荐 PHP 格式，便于读取 Webman 配置），放在项目根目录 -
phinx.php中需显式加载 Webman 的数据库配置，并映射为 Phinx 要求的environments结构 - 不要用
vendor/bin/phinx直接运行 —— 工作目录错、配置不可控、环境变量未加载
如何让 php webman phinx:migrate 命令可用
需手动注册自定义命令到 Webman 的 support/command 体系中，而不是依赖 Phinx 自带的 bin 脚本。
- 新建
app/Command/PhinxCommand.php，继承WebmanConsoleCommand - 在
handle()方法里实例化PhinxConsolePhinxApplication，并传入自定义input和output - 关键：调用
setWorkingDirectory()指向项目根目录，确保phinx.php可被正确加载 - 注册该命令到
config/bootstrap.php的Commands::add()列表中
phinx.php 配置怎么对接 Webman 的 config/database.php
不能硬编码数据库参数，应复用 Webman 的配置解析逻辑，尤其是多环境（如 .env）下的 host/user/dbname 切换。
立即学习“PHP免费学习笔记（深入）”；
- 在
phinx.php中 requirevendor/autoload.php，再 requireconfig/database.php - 从
database.php提取connections.mysql（或你实际用的连接名），重构成 Phinx 要求的environments.development结构 - 注意字段映射：
'host' => 'host'，'database' => 'name'，'username' => 'user'，'password' => 'pass' - 务必设置
'migrations' => 'database/migrations'，路径需与 Webman 的app/Database/Migrations保持一致（建议软链或统一路径）
迁移文件生成和运行时常见坑
Phinx 生成的类名和文件名规则与 Laravel 不同，Webman 项目里容易因命名或命名空间出错导致找不到类。
- 生成迁移用
php webman phinx:create CreateUserTable，别用phinx命令直跑 —— 否则生成路径不在 autoload 范围内 - 迁移类必须放在
app/Database/Migrations下，且命名形如20240522103000_create_user_table.php（时间戳+下划线） - 类名必须严格匹配文件名（不含扩展名），且继承
PhinxMigrationAbstractMigration - Webman 的 autoloader 默认不扫
app/Database/Migrations，需在composer.json的"autoload"→"psr-4"补上："App\Database\Migrations\": "app/Database/Migrations/"，然后运行composer dump-autoload
最易忽略的一点：Phinx 的 up()/down() 方法里不能直接用 Webman 的 Db 或模型 —— 它运行在命令行上下文，容器未完全启动，所有数据库操作必须通过 $this->execute() 或 $this->table()->create() 等 Phinx 原生 API 完成。
