Composer post-install-cmd如何用_Composer安装后脚本教程【实战】-composer-PHP中文网

post-install-cmd 仅在 composer.lock 不存在或过期时触发，非每次 install 都执行；需每次运行应改用 post-update-cmd 或自定义脚本显式调用。

composer post-install-cmd如何用_composer安装后脚本教程【实战】

Composer 的 post-install-cmd 不是“安装后自动执行任意命令”的万能钩子，它只在 composer install 且 composer.lock 不存在或过期时触发；想每次 install 都跑，得用 post-update-cmd 或统一走 scripts + 手动调用。

post-install-cmd 触发条件很具体

很多人以为只要运行 composer install 就会执行 post-install-cmd，实际不是：

如果项目已有有效的 composer.lock（即依赖版本已锁定），composer install 只是解包，不会触发 post-install-cmd
只有首次克隆项目、删了 composer.lock 后重装，或 lock 文件里记录的依赖与 composer.json 不一致（比如改了 require）导致 Composer 重生成 lock 时，才会触发
相比之下，post-update-cmd 在 composer update 和 composer install --update 时都更稳定触发

在 composer.json 里正确声明脚本

脚本必须写在 "scripts" 字段下，键名严格为 "post-install-cmd"（注意大小写和连字符）：

{
    "scripts": {
        "post-install-cmd": [
            "@php -r "echo 'Install done.\n';"",
            "php artisan optimize:clear",
            "npm install"
        ]
    }
}

几点关键说明：

Discussion Composer

围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par

下载

值可以是字符串（单条命令）或字符串数组（多条顺序执行），推荐数组，便于维护
以 @ 开头的命令（如 @php）表示调用当前 Composer 自带的脚本别名，避免路径问题
外部命令如 npm install 要求系统 PATH 中存在 npm，CI 环境需提前确认 Node.js 已安装
PHP 脚本建议用 php -f script.php 显式指定，不用 ./script.php（可能无执行权限）

常见失败原因：权限、路径、执行时机

脚本看似配置对了，却静默失败或报错，通常卡在这几个点：

sh: 1: npm: not found → 容器或 CI 镜像没装 Node.js，不能只靠本地有就认为线上也有
Permission denied: ./artisan → Laravel 的 artisan 缺少可执行位，应改用 php artisan ...
脚本中引用的相对路径（如 ../config/app.php）在不同工作目录下失效 → 始终用 __DIR__ 或 getcwd() 动态拼接，或改用 Composer 提供的 $vendorDir / $binDir 变量（需配合 composer run-script 的变量替换机制）
想在脚本里读取 composer.json 内容？别手动 file_get_contents，用 ComposerInstalledVersions::getRawData()（v2+）或解析 vendor/composer/installed.json 更可靠

替代方案：用自定义脚本 + 显式调用更可控

如果业务逻辑复杂，或需要每次 install 都执行（不管 lock 是否变化），不如绕开钩子语义，直接定义一个可复用的脚本：

{
    "scripts": {
        "setup": [
            "@php -r "echo 'Running setup...\n';"",
            "php artisan migrate --force",
            "npm ci && npm run build"
        ],
        "post-install-cmd": "@setup",
        "post-update-cmd": "@setup"
    }
}

这样既能被钩子触发，也能被人工执行：composer run-script setup。调试时也方便单独跑，不用反复删 composer.lock。

真正难的不是写几行命令，而是判断「这个操作到底该在哪个生命周期发生」——比如生成 autoload、清理缓存、编译前端资源，各自对 lock 文件是否变更、是否需要全量重装，敏感度完全不同。