composer卡在“downloading…”时，应切换国内镜像源：一、全局配阿里云；二、全局配腾讯云；三、项目级配清华源；四、临时用华为云；五、手动改config.json配中科大源。
如果您在PHP项目中使用Composer安装依赖包时持续卡在“Downloading…”阶段，且长时间无响应或频繁超时，则极可能是因默认连接境外packagist.org源所致。以下是解决此问题的步骤：
一、全局配置阿里云镜像源
该方法将Composer默认仓库永久替换为阿里云全量镜像，适用于所有项目，配置后立即生效且无需重启终端。必须确保字段名、type值与URL格式三者完全正确，否则静默失效。
1、在终端中执行以下命令：composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
2、验证是否写入成功：composer config -g repo.packagist
3、确认输出为完整JSON对象：{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"} 或新版仅显示对应URL字符串
二、全局配置腾讯云镜像源
腾讯云镜像同步稳定、CDN覆盖广，可作为阿里云镜像的替代方案。其配置逻辑与阿里云一致，但域名不同，适合网络环境对特定CDN响应更优的场景。
1、执行命令启用腾讯云镜像：composer config -g repo.packagist composer https://mirrors.cloud.tencent.com/composer/
2、检查当前配置是否更新：composer config -g repo.packagist
3、观察输出是否包含mirrors.cloud.tencent.com且无空值或https://packagist.org字样
三、项目级配置清华镜像源
项目级配置写入当前项目composer.json的repositories字段，不干扰其他项目，特别适用于团队协作或CI/CD流程中需保障配置一致性的情形。
1、进入项目根目录，执行命令（不加-g）：composer config repo.packagist composer https://mirrors.tuna.tsinghua.edu.cn/composer/
2、该操作会自动向composer.json中repositories对象内追加packagist条目，不会清空已有私有源
3、若项目已存在repositories字段且含自定义源，建议手动编辑composer.json，在repositories中显式添加packagist镜像项，并确保根节点含"packagist.org": false
四、临时指定华为云镜像源
临时参数方式仅对单次命令生效，优先级高于全局与项目级配置，适用于调试、CI脚本隔离或快速验证镜像可用性等场景。
1、在安装命令末尾添加--repository参数：composer create-project laravel/laravel myapp --repository=https://repo.huaweicloud.com/repository/php/
2、执行带详细日志的更新命令以确认实际请求地址：composer update -vvv --repository=https://repo.huaweicloud.com/repository/php/ 2>&1 | grep "Downloading"
3、检查日志输出中是否出现repo.huaweicloud.com，而非packagist.org或404路径
五、手动编辑全局配置文件
当命令行配置因权限、disable_functions限制或Composer版本兼容性问题失败时，可直接修改全局config.json文件，实现最底层控制。
1、定位全局配置文件路径：~/.composer/config.json（Linux/macOS）或C:\Users\用户名\AppData\Roaming\Composer\config.json（Windows）
2、在文件中找到repositories对象，插入以下键值对："packagist": {"type": "composer", "url": "https://mirrors.ustc.edu.cn/composer/"}
3、保存文件后，运行composer config -l | grep repositories.packagist确认新配置已加载
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
