post-install-cmd 是 Composer 安装依赖后触发的脚本钩子，可调用 php artisan migrate 等命令，但仅适用于开发/CI；生产环境禁用，因缺乏回滚、并发控制与状态校验，须改用独立部署流程执行迁移。
post-install-cmd 是什么，它真能跑 migrate 吗
post-install-cmd 是 Composer 的一个脚本事件钩子，在 <code>composer install 执行完依赖安装后自动触发。它本身不执行迁移，但可以调用你定义的命令——比如 Laravel 的 php artisan migrate 或 Symfony 的 php bin/console doctrine:migrations:migrate。关键在于：它只在本地或 CI 环境中「有权限且环境就绪」时才可靠；生产环境直接用它跑迁移风险极高，因为缺少人工确认、无回滚上下文、无法感知数据库锁或结构冲突。
常见错误现象：post-install-cmd 报错 Command "migrate" is not defined，本质是当前目录下 Artisan/Console 未加载、autoload 未生效，或脚本在 vendor 安装完成前就尝试执行（Composer 早期版本存在此竞态）。
实操建议：
- 确保
post-install-cmd在composer.json的"scripts"下，且命令字符串以php开头（如"php artisan migrate --force"），避免 shell 解析歧义 - 仅在开发/CI 流水线中启用，生产部署必须剥离该钩子，改用明确的部署脚本控制
- 加
--no-interaction和--force（Laravel）或--no-interaction（Symfony），否则交互式提示会卡住 CI
如何安全地在 composer.json 中配置迁移命令
直接写 "php artisan migrate" 很危险：没有数据库连接验证、不检查迁移是否已执行、失败时不中断后续流程。应封装一层轻量校验逻辑，或使用现成的健壮包装命令。
实操建议：
- 不要把
migrate放在post-install-cmd主链路里，改用自定义脚本，例如："scripts": { "post-install-cmd": ["@php artisan migrate:status --quiet || exit 1", "php artisan migrate --force"] } - 若用 Doctrine，优先用
doctrine:migrations:up-to-date做前置判断，再执行migrate，避免重复运行 - 所有迁移命令必须带
--env=xxx显式指定环境，防止误在 .env.local 未就位时读错配置 - 路径敏感：确保
php可执行文件在 PATH 中，或写绝对路径（如/usr/bin/php），尤其在 Docker 多阶段构建中
为什么 post-install-cmd 不适合生产环境自动迁移
根本原因不是技术限制，而是部署语义错位：composer install 的职责是“准备代码依赖”，不是“变更生产状态”。一旦迁移失败，你无法原子回退到上一版代码+数据库一致态。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
典型翻车场景：
- 新迁移脚本依赖旧代码中的某个类，但
composer install已覆盖 vendor，而 migration 还没跑完 —— 类找不到，迁移中断，DB 半途而废 - 两个并行部署同时触发
post-install-cmd，竞争锁表，一个失败后另一个继续，数据不一致 - 迁移耗时长（如加索引），阻塞整个 install 流程，监控误报“部署超时”
实操建议：
- 生产环境迁移必须拆离为独立步骤，在代码上线后、服务重启前手动或通过部署工具（如 Capistrano、Deployer、自研 Ansible Playbook）执行
- 所有迁移命令加
--dry-run（Doctrine）或先跑migrate:status（Laravel）做预检，输出变更摘要供人工确认 - 记录迁移执行日志到独立文件（如
storage/logs/migrate-$(date +%s).log），而非混在 composer 输出里
替代方案：用 Composer plugin 更可控地介入流程
硬塞命令到 post-install-cmd 缺乏条件分支和错误处理能力。更稳妥的做法是写一个轻量 Composer Plugin，在 InstallerEvent 触发时判断当前环境、迁移状态、甚至 Git 分支，再决定是否执行、跳过或报错。
实操建议：
- 新建
src/Composer/DatabaseMigratorPlugin.php，实现Composer\Plugin\PluginInterface，监听POST_INSTALL_CMD事件 - 插件内可调用
Process::fromShellCommandline()执行迁移，并捕获Process::isSuccessful()结果，失败时抛出RuntimeException中断 install - 插件可通过
composer.json的"require-dev"引入，确保只在开发/CI 中加载，生产镜像构建时自然排除 - 比纯脚本多出的能力：读取
composer.lock判断是否首次安装、对比 migrations/ 目录哈希决定是否需重跑
真正难的从来不是让命令跑起来，而是让每一次数据库变更都可预期、可审计、可中断。哪怕只是加个 --pretend 参数，也比默认静默执行强得多。
