Composer config -g 命令报错主因是 PHP disable_functions 禁用了 proc_open 或 putenv，需检查 php.ini 并重启 PHP 服务；截至2026年4月，推荐使用阿里云（https://mirrors.aliyun.com/composer/）和腾讯云（https://mirrors.cloud.tencent.com/composer/）镜像，强制 HTTPS，全局配置优先但团队协作与CI/CD场景建议项目级或环境变量配置。
国内镜像现在必须配，不配基本没法用；但直接 composer config -g repo.packagist composer https://... 一行命令配完，大概率会失败——不是地址失效，就是 PHP 环境卡在禁用函数上。
为什么 composer config -g 命令总报错？
常见错误现象：command not found、proc_open(): fork failed、putenv() has been disabled。这些都不是镜像地址的问题，而是 Composer 启动时依赖的底层 PHP 函数被禁用了。
- 检查
php.ini中的disable_functions配置项，确认proc_open和putenv没有出现在里面（哪怕只多一个空格也会导致失效） - 改完后必须重启 PHP-FPM 或 Apache/Nginx（CLI 模式也要重启终端或重载环境）
- 验证是否生效：运行
php -r "echo proc_open('echo 1', [], $p) ? 'ok' : 'fail';"，输出ok才算通过
哪些镜像地址现在还能用？
截至 2026 年 4 月，packagist.phpcomposer.com 和 packagist.laravel-china.org 已不可靠；阿里云和腾讯云镜像仍稳定可用，且支持全量同步与 CDN 加速。
- 阿里云镜像（推荐）：
https://mirrors.aliyun.com/composer/ - 腾讯云镜像：
https://mirrors.cloud.tencent.com/composer/ - 切勿使用带
http://的地址，Composer 7.x+ 强制 HTTPS - 配置命令示例：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
全局配置 vs 项目配置，怎么选？
全局配置写入 ~/.composer/config.json，影响所有项目；项目配置写入当前目录的 composer.json，只作用于本项目。多数情况下该用全局，但有两个例外：
- 团队协作时，项目里显式声明镜像地址（
repositories字段），可避免成员本地配置不一致导致的 install 结果差异 - CI/CD 流水线中，不建议依赖全局配置——环境干净、可控，应统一用
COMPOSER_REPO_PACKAGIST=https://...环境变量注入 - 验证是否生效：
composer config -g repos.packagist（全局）或composer config repos.packagist（当前项目）
配完还是慢？别急着换镜像
镜像只是解决元数据和 zip 包下载路径问题，真正拖慢安装的往往是 PHP 扩展缺失或网络中间件干扰。
- 确保已启用
openssl和zlib扩展（php -m | grep -E 'openssl|zlib'） - 如果公司内网有代理或防火墙，
curl -I https://mirrors.aliyun.com/composer/packages.json要能通，否则 Composer 会 fallback 到 packagist.org - 多线程加速目前仍需第三方工具（如
composer-parallel），原生 Composer 仍为单线程，镜像本身不改变并发模型
最常被忽略的一点：镜像配置成功后，composer.lock 文件里的包来源不会自动更新——下次 composer update 或删掉 lock 文件再 install，才能真正走新镜像链路。
