Phinx不能直接通过composer require安装后运行迁移，必须作为全局工具或开发依赖安装，并手动初始化配置和迁移目录；其命令需通过vendor/bin/phinx调用或配置PATH，且依赖PDO扩展、正确配置数据库参数及phinxlog表维护状态。
Phinx 不能直接用 composer require 装完就跑迁移——它必须作为全局工具或项目级开发依赖安装，且需手动初始化配置和迁移目录。
为什么 composer require robmorgan/phinx 装完却找不到 phinx 命令
因为 Phinx 默认不注册可执行脚本（bin），只装包不会把 phinx 命令放进 vendor/bin/；即使你加了 --dev，也得手动调用 vendor/bin/phinx 或配置 bin-dir。
- 装在项目里：运行
php vendor/bin/phinx，不是直接敲phinx - 想全局用：用
composer global require robmorgan/phinx，但要确保~/.composer/vendor/bin在$PATH里 - 常见错误现象：
command not found: phinx，其实是路径没导进去，不是没装成 - Composer 2.2+ 默认禁用
bin-compat，老项目升级后可能突然失效
初始化 phinx.php 配置前必须先确认数据库驱动是否可用
Phinx 不会自动检测扩展，pdo_mysql、pdo_pgsql 这类扩展缺一个，phinx init 就卡住或报错 Class 'PDO' not found，但错误信息根本不提缺扩展。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 先跑
php -m | grep pdo确认对应 PDO 驱动已启用 -
phinx init只生成空配置；真正要连库，得手动填host、name、user、pass，且adapter必须写成mysql/pgsql/sqlite（不能写pdo_mysql） - SQLite 路径要用绝对路径，相对路径在不同工作目录下会指向错位置
- 配置里写
"charset": "utf8mb4"没用，得在options里加"charset" => "utf8mb4"才生效
phinx create 生成的迁移文件名带时间戳，但顺序不等于执行顺序
Phinx 按文件名前缀（如 20230512102345）排序执行，但如果你手动改过文件名、或从别处拷贝迁移文件进来，时间戳重复或倒序，就会跳过或报错 Migration not found。
- 生成新迁移务必用
phinx create CreateUserTable，别手写文件名 - 执行时加
-e development或-c phinx.php显式指定环境，否则默认读development，而你可能只配了testing -
phinx migrate -v会显示每步 SQL，但不显示失败语句；出错时得加--debug才看到完整报错 - 回滚
phinx rollback -t 20230512102345是按时间戳找“最后执行的那批”，不是删掉单个迁移
最常被忽略的是：Phinx 的 migrate 和 rollback 都基于 phinxlog 表记录，这个表一旦被清空或误删，所有迁移状态就丢了——它不像 Laravel Migrations 那样靠文件哈希校验，纯靠时间戳 + 日志表双保险，少一个环节就乱序。
