切换国内镜像源是解决composer卡在“loading composer repositories with package information”的前提，推荐阿里云镜像并确保proc_open和putenv未被禁用，同时验证php扩展与权限配置。
装完 Composer 不配镜像，等于没装——composer install 卡在 Loading composer repositories with package information 是常态，不是你网差，是官方源在国内根本不可达。
确认 PHP 环境就绪再动 composer
Composer 本质是 PHP 脚本，php 命令必须可用且满足基础扩展要求：
-
php -v必须输出版本（推荐 PHP 7.4+，PHP 8.2 更稳）；若报command not found: php，说明 PATH 没设对或 PHP 根本没装 - 检查
php --ini找到php.ini路径，确保以下扩展已启用（取消注释）：extension=curl、extension=mbstring、extension=openssl、extension=pdo_mysql - Windows 用户常见坑：安装 PHP 时没勾选 “Add to PATH”，或路径含中文/空格；Linux/macOS/WSL 用户要警惕用的是系统自带老 PHP，而非宝塔/PHPStudy 提供的版本
- 验证
proc_open和putenv是否被禁用：运行php -r "echo proc_open('echo 1', [], $p) ? 'ok' : 'fail';"，输出ok才算过关；否则需检查php.ini中的disable_functions并重启 PHP 服务
composer config -g repo.packagist 命令总失败？先看这三点
这条命令报错，90% 不是镜像地址问题，而是底层 PHP 函数被拦住或权限不对：
- 错误提示含
proc_open(): fork failed或putenv() has been disabled→ 直接查php.ini的disable_functions，删掉proc_open和putenv（注意前后空格），改完必须重启 PHP-FPM/Apache/Nginx 或重开终端 - Linux/macOS/WSL 下提示
Permission denied→~/.composer/目录归属权不对，执行chown -R $USER ~/.composer再试；或临时加sudo（不推荐长期用） - Windows 下提示
'composer' is not recognized→ PATH 没生效，重启 PowerShell/CMD，或以管理员身份运行；配置写入位置是%USERPROFILE%\AppData\Roaming\Composer\config.json，Composer 自己能处理路径中的空格和中文 - 别信过时教程里
https://packagist.phpcomposer.com这类地址——它早在 2023 年就下线了，现在用必卡死或 404
2026 年仍稳定可用的国内镜像地址与正确写法
截至 2026 年 7 月，仅以下三个镜像经实测全量同步、HTTPS 可靠、CDN 响应快：
- 阿里云（首选）：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - 腾讯云：
composer config -g repo.packagist composer https://mirrors.cloud.tencent.com/composer/ - 华为云：
composer config -g repo.packagist composer https://mirrors.huaweicloud.com/repository/php/ - 关键细节不能错：
repo.packagist是固定键名（不是repos.packagist或packagist.org），composer是 type 字段值（小写，不可省略），URL 末尾/强烈建议保留，部分镜像服务路径匹配严格 - 验证是否生效，别只信
composer config -g repo.packagist输出——它可能显示旧值但实际未生效。更可靠方式是跑一次真实请求：composer show -v | head -n 5，看日志里Downloading https://...的域名是不是你配的镜像地址
项目级镜像配置：团队协作与 CI/CD 场景下的必要选择
全局镜像方便，但在多团队、混合网络或 CI 流水线中容易失控。项目级配置更可控：
- 在项目根目录
composer.json的repositories数组里追加（不是替换！）：
"repositories": [
{
"type": "composer",
"url": "https://mirrors.aliyun.com/composer/"
}
]
composer update --lock，让 composer.lock 记录新源地址，否则下次 install 仍走旧路径COMPOSER_REPO_PACKAGIST=https://mirrors.tuna.tsinghua.edu.cn/composer/ composer install，避免污染全局配置镜像不是“试试看有没有效”的可选项，而是 Composer 在国内能跑起来的前提；最易被忽略的是 proc_open 和 putenv 的禁用状态——它们不出错时不显山露水，一出错就整条链路瘫痪。
