Composer脚本失败需用Shell包装脚本捕获退出码,通过$?立即获取并判断,再执行通知逻辑;不可依赖composer.json内联&& ||或set -e,应封装为独立可执行文件(如bin/run-tests-with-notify)并在scripts中用@php调用。

Composer脚本失败时如何捕获退出码
Composer 本身不提供“脚本失败自动触发钩子”的机制,scripts 中的命令一旦非零退出,整个 composer install 或 composer run 就会中止,但不会主动调用其他逻辑。想发通知,得自己把错误捕获住——关键在 Shell 层做包裹,而不是依赖 Composer 的 JSON 配置字段。
常见误区是试图在 composer.json 里写类似 "post-install-cmd": "notify-on-fail.sh",但这个脚本根本收不到上游命令的退出状态,也没法区分成功/失败。
- 必须用
&&/||或$?显式检查上一条命令的退出码 - 推荐把原始命令和通知逻辑封装进一个独立 shell 脚本,而非直接写在
composer.json的字符串里(可读性差、引号易错、调试困难) - 不要用
set -e,它会让脚本在任意失败处退出,反而无法执行后续通知
怎么写一个带失败通知的包装脚本
假设你想在 phpunit 执行失败时发 Slack 通知,可以新建 bin/run-tests-with-notify:
#!/usr/bin/env bash
# bin/run-tests-with-notify
php ./vendor/bin/phpunit "$@"
exit_code=$?
if [ $exit_code -ne 0 ]; then
curl -X POST -H 'Content-type: application/json' \
--data '{"text":"❌ PHPUnit failed in `'"$(basename $(pwd))"'` (exit '$exit_code')"}' \
https://hooks.slack.com/services/XXX/YYY/ZZZ
fi
exit $exit_code
然后在 composer.json 中引用它:
"scripts": {
"test": ["@php bin/run-tests-with-notify"]
}
- 一定要用
$?立即获取上一条命令的退出码,放在其他命令之后就失效了 - curl 通知建议加
--fail和超时(--max-time 5),避免通知本身失败阻塞主流程 - 如果用 GitHub Actions 或 GitLab CI,优先走平台原生的
on: failure,比自己拼 curl 更可靠
为什么不能直接在 scripts 里用 && || 连写
下面这种写法看着简洁,但实际不可靠:
专业音乐创作规划。基于 mmx-cli(MiniMax AI)生成高质量音乐和歌曲,自动规划曲风、节奏、乐器编配和人声特色,将模糊需求转化为精准 Prompt。支持纯器乐和中文歌词歌曲。
"scripts": {
"build": "npm run build && echo 'OK' || (echo 'FAIL' && curl ...)"
}
问题在于:npm run build 如果内部有 echo、printf 等命令失败,但整体仍返回 0(比如被子 shell 吞掉错误),或者 echo 'OK' 自己出错(如 stdout 被关闭),都会误触发通知。
-
&&/||只判断**最后一条命令**的退出码,不是整个 pipeline - 复杂逻辑放 JSON 字符串里,shell 特性(变量扩展、条件判断、多行)支持极差,容易因空格、单双引号嵌套崩掉
- CI 环境下
stderr可能被重定向,导致echo失败却没报错
本地开发时怎么快速验证通知逻辑
别等 CI 挂了才试——手动模拟失败最直接:
bash -c 'false; echo $?' # 输出 1 bash -c 'true; echo $?' # 输出 0
然后在包装脚本里临时插入 exit 1 强制失败,确认通知是否发出。注意:
- Slack webhook 地址要设为环境变量(如
$SLACK_WEBHOOK),别硬编码到脚本里 - 本地测试时 curl 加
-v看 HTTP 状态码,404 或 403 表示 webhook 无效 - 如果通知服务需要认证或代理,确保
bin/run-tests-with-notify运行时环境与 CI 一致(比如 PHP CLI 的inifile、env变量)
真正难的不是发一次通知,而是让失败路径和成功路径的环境、权限、网络都一致——这点在 Docker 容器或 Windows WSL 下尤其容易漏掉。










