因为Composer全局配置仅由composer命令自身解析，PHP CLI脚本调用时需手动传参（如--repository-url）或动态写入config，无法自动继承镜像设置。
为什么 PHP CLI 环境下 composer 不自动读取国内镜像配置
因为 Composer 的全局配置（~/.composer/config.json）默认只被 composer 命令本身读取，而 PHP CLI 工具（比如你写的 php tool.php）若自己调用 proc_open() 或 shell_exec() 执行 composer install，并不会自动继承或加载 Composer 的配置逻辑——它只是起个 shell 进程，完全依赖环境变量和命令行参数。
换句话说：镜像配置不是 PHP 的一部分，也不是 Composer 的“运行时插件”，而是 composer 二进制自身解析的配置项。你的 PHP 脚本要控制镜像，就得手动干预它的执行方式。
在 PHP CLI 脚本中调用 composer 时强制指定镜像源
最直接有效的方式是绕过全局配置，用 --repository-url 参数覆盖默认 packagist.org：
composer create-project laravel/laravel myapp --repository-url=https://packagist.phpcomposer.comcomposer require monolog/monolog --repository-url=https://mirrors.aliyun.com/composer/
注意：--repository-url 仅对当前命令生效，且会禁用所有其他仓库（包括 packagist.org），所以必须确保该镜像完整同步了官方索引；阿里云、腾讯云、华为云等镜像均支持全量同步，但某些小众镜像可能不兼容最新 Composer 协议（如 v2 API）。
立即学习“PHP免费学习笔记（深入）”；
如果你需要保留 packagist.org 作为 fallback，得改用 config 命令临时写入（见下一节）。
用 composer config 动态切换全局镜像（PHP 脚本内安全写法）
想让后续所有 composer 命令都走指定镜像？可以先执行：
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
但要注意三点：
- 这个操作会修改用户级配置文件
~/.composer/config.json，多进程并发执行时可能冲突（比如多个脚本同时写同一文件） - PHP 脚本里用
exec("composer config -g ...")后，必须确保后续composer命令在同一 shell 环境中执行（子进程无法继承父进程的配置写入结果，但能读到磁盘上的新配置） - 恢复默认需手动执行
composer config -g --unset repo.packagist，否则下次运行仍走镜像
更稳妥的做法是：用 -d 指定临时配置目录，避免污染全局：
composer --no-plugins --config-dir=/tmp/composer-tmp-xyz config -g repo.packagist composer https://mirrors.aliyun.com/composer/
再配合 --config-dir 运行后续命令即可隔离作用域。
检测当前镜像是否可用再执行（避免卡死或静默失败）
国内镜像偶尔不可用或返回 404/503，直接执行 composer install 可能超时卡住。建议加一层探测：
- 用
curl -I -s -o /dev/null -w "%{http_code}" https://mirrors.aliyun.com/composer/packages.json判断 HTTP 状态码是否为200 - Composer v2+ 镜像需访问
/packages.json（不是/），否则会误判 - 超时设为
--max-time 5，防止阻塞整个脚本
PHP 中可封装成函数：
$mirror = "https://mirrors.aliyun.com/composer/";
$code = (int) trim(shell_exec("curl -s -o /dev/null -w '%{http_code}' --max-time 5 {$mirror}packages.json 2>/dev/null"));
if ($code !== 200) {
echo "镜像 {$mirror} 不可用，跳过\n";
exit(1);
}
别忘了，有些镜像（如腾讯云）要求 User-Agent，不带可能被拦截；加 -A "Mozilla/5.0" 更稳妥。
真正麻烦的不是选哪个镜像，而是不同 Composer 版本对镜像协议的支持差异——v1 和 v2 的 packages.json 结构不同，部分旧镜像已停更，返回空响应却不报错。跑之前最好确认目标镜像明确声明支持当前 composer --version 输出的版本。
