静默执行 composer install 不等于“不报错”，而是要让失败时仍能暴露真实错误——否则你根本不知道是网络超时、SSL证书过期，还是 PHP 扩展缺失。加 -q 会吞掉所有带 [LEVEL] 前缀的日志及 PHP 致命错误，导致 CI 无法识别失败；正确做法是用 grep -v "^\[.*\]"（Linux/macOS）或 findstr /v "^\["（Windows）过滤日志行，保留 stderr 中的原始错误，同时确保加 2>&1 合并标准错误流。
静默执行 composer install 不等于“不报错”，而是要让失败时仍能暴露真实错误——否则你根本不知道是网络超时、SSL证书过期，还是 PHP 扩展缺失。
为什么 composer install -q 会掩盖致命问题
加 -q（quiet）后，Composer 会吞掉所有日志，包括 [ERROR]、[WARNING] 和 PHP 致命错误。它只保留 stderr 中的原始系统级错误，但这些错误本身又没被显式过滤或捕获。结果就是：命令退出码非零，却没有任何输出，CI 流水线直接卡死在“成功”假象里。
-
composer install -q --no-ansi --no-interaction→ 成功时安静，失败时彻底沉默 - 常见静默失败场景：
Class 'ZipArchive' not found、cURL error 28、file_get_contents(): php_network_getaddresses: getaddrinfo failed - 根本原因：Composer 的内部日志都带
[LEVEL]前缀（如[INFO]），而真正要命的错误（PHP Fatal、SSL handshake failed）不走这套格式，-q一并屏蔽了
真正可用的静默方案：只过滤日志行，不丢错误
目标不是“完全没输出”，而是“只留关键错误”。靠 grep -v 或 findstr /v 排除 Composer 自己的日志前缀，让 stderr 中的原始错误浮上来。
- Linux/macOS：
composer install --no-ansi --no-interaction 2>&1 | grep -v "^\[.*\]" - Windows PowerShell：
composer install --no-ansi --no-interaction 2>&1 | findstr /v "^\[" - 必须加
2>&1，否则grep看不到 stderr 内容 - 这个命令不会影响退出码，CI 可靠判断成败；失败时你会看到
PHP Fatal error或cURL error 60这类真实线索
并发下载和镜像配置决定“静默是否真快”
即使命令不报错、不卡住，composer install 也可能慢得反常——这不是静默的问题，是底层配置没跟上。
- 默认
parallel-downloads=3，国内源下基本等于单线程：全局设为composer config -g parallel-downloads 10 - 镜像源必须生效且带末尾斜杠：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/（少/就退回到 packagist.org） - 换源后立刻清缓存：
composer clear-cache，否则旧 cache 仍尝试访问packagist.org - 项目根目录若存在
composer.json且含"repositories"字段（哪怕空对象{}），全局镜像会被无视
权限和扩展缺失导致的“静默卡住”最易被忽略
你看到 Loading composer repositories 停住，大概率不是网络问题，而是 PHP 扩展没开全或权限不对——它们不抛异常，只让流程无声中断。
- 必须启用的扩展：
zip（Class 'ZipArchive' not found）、openssl（SSL 错误静默）、json（json_decode() expects parameter 1 to be string, bool given） - 别用
sudo composer install：Composer 主动拒绝 root，且会写配置到/root/.composer/config.json，普通用户进程读不到 -
/usr/local/bin/composer必须有执行权限：sudo chmod +x /usr/local/bin/composer - 确认 PATH 包含该路径：
echo $PATH | grep -o '/usr/local/bin'，没有就补进~/.bashrc
静默执行真正的难点不在命令参数，而在你能否一眼分辨出“是真静默，还是假成功”。只要漏掉扩展检查、镜像验证或 stderr 捕获，所谓静默就只是把问题藏得更深而已。
