配置国内镜像源可提升Composer下载速度,优先使用阿里云或腾讯云镜像;通过composer config -g repo.packagist设置全局镜像,或在项目目录中执行相同命令(不含-g)配置项目级镜像;恢复默认源使用composer config -g --unset repos.packagist命令即可。

在国内使用 Composer 安装 PHP 包时,由于默认源位于海外,下载速度通常较慢。配置阿里云、腾讯云等国内镜像源可显著提升访问速度和稳定性。
全局配置镜像源
通过 config 命令修改全局配置,将所有项目的包下载指向国内镜像:
-
阿里云镜像:
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ -
腾讯云镜像:
composer config -g repo.packagist composer https://mirrors.cloud.tencent.com/composer/
执行后,Composer 会将 packagist 源替换为指定的国内镜像地址,后续安装依赖将自动从该源拉取。
项目级配置(仅当前项目)
若只想为某个项目设置镜像,进入项目根目录并运行(以腾讯云为例):
composer config repo.packagist composer https://mirrors.cloud.tencent.com/composer/
该操作会在项目中的 composer.json 文件中生成 repositories 配置,不影响其他项目。
恢复默认源
如需恢复使用官方源,运行:
composer config -g --unset repos.packagist
此命令将移除全局镜像配置,Composer 将回退至默认设置。
基本上就这些,配置一次后无需重复操作,换设备或新项目时记得重新设置即可。










