根本原因是Composer默认吞掉子命令非零退出码,需用@前缀透传,如"analyze": "@phpstan analyse src/ --no-interaction";裸写命令会被封装导致失败不中断。

CI中composer run-script不报错却跳过检查?
根本原因是 Composer 默认会吞掉子命令的非零退出码,导致 phpstan、phpcs 等静态分析工具失败时 CI 仍显示 success。这不是 CI 配置问题,而是 composer run-script 的默认行为。
必须用 @ 前缀显式透传退出码:
- ✅ 正确:
"analyze": "@phpstan analyse src/ --no-interaction" - ❌ 错误:
"analyze": "phpstan analyse src/ --no-interaction"(被包装成 shell 函数,false也会返回 0) - 复合命令需手动控制退出码:
"test": "sh -c 'vendor/bin/phpunit && vendor/bin/psalm'",不能写成"test": "vendor/bin/phpunit && vendor/bin/psalm"(后者会被 composer 封装)
GitLab CI里composer install为什么总慢?
核心瓶颈不在网络,而在重复下载和未启用优化。关键不是“装得快”,而是“少装、装对、不重装”。
在 .gitlab-ci.yml 中配置以下几项即可显著提速:
- 缓存
~/.composer/cache,key 建议用${PHP_VERSION}-composer-cache,避免跨版本污染 - 测试阶段加
--no-dev --prefer-dist;生产构建阶段额外加--optimize-autoloader --classmap-authoritative - 镜像源仅在 CI 中临时切换:
before_script: - composer config repo.packagist composer https://mirrors.aliyun.com/composer/,但部署镜像前务必还原官方源(防非官方包混入) - 绝不用
composer update,所有流水线必须基于已提交的composer.lock执行install
脚本执行后CI没中断,怎么快速验证是否生效?
别等 GitLab 流水线跑完——本地就能复现并确认退出码是否透传成功:
使用 GitHub REST API v3 /actions/runs 和 /actions/jobs 端点诊断失败的 GitHub Actions 工作流程。解析步骤日志,识别 YAML 语法错误,并为运行器环境问题提供修复建议。
- 运行
composer run-script analyze --no-ansi,观察终端末尾是否出现Script handling the analyze event returned with error code 1 - 执行后立刻查真实退出码:
composer run-script analyze; echo "exit code: $?",非零才代表失败被正确捕获 - 写个调试脚本:
"debug": "sh -c 'echo \"running\"; false"',再composer run-script debug,看是否中断并报错 - 注意:
@前缀只对直接命令有效,不穿透sh -c或管道;复杂逻辑建议拆成独立可执行文件,并确保该文件自身exit 1行为可靠
为什么CI里一定要用install而不是update?
因为 composer update 会重算依赖树、生成新 composer.lock,等于绕过代码审查偷偷升级——昨天通过的流水线,今天可能因 monolog 的 patch 版本引入 Fatal error: Class 'PHPUnit\Framework\TestCase' not found。
composer install 是唯一能保证构建可重现的命令,但有硬性前提:
-
composer.lock必须提交到 Git,且不能被.gitignore忽略;否则 CI 直接报错Root package cannot be found - 多包项目(monorepo)中,每个子目录下都得有自己独立的
composer.lock - 必须加三个参数:
--no-dev(剔除测试类)、--optimize-autoloader(生成 classmap)、--classmap-authoritative(禁用 file_exists 探测),漏一个就可能线上崩溃或性能骤降
真正容易被忽略的是:CI 的 clean checkout 特性意味着它不会继承你本地的 vendor 或缓存,一切必须从 composer.lock 开始严格重建——所以 lock 文件的完整性、提交动作、以及 install 参数的完备性,三者缺一不可。










