配置国内镜像源可提升composer下载速度,推荐使用阿里云、laravel China或腾讯云镜像,通过composer config -g设置全局源,单个项目可在composer.json中添加repositories配置,验证可用composer config -l检查生效情况。

使用 Composer 安装 php 包时,由于默认源在国外,下载速度可能很慢。通过配置国内镜像源,可以显著提升下载速度。以下是如何配置和使用国内镜像源的详细方法。
配置全局镜像源(推荐)
将 Composer 的默认仓库替换为国内镜像,例如阿里云、 Laravel China 或 腾讯云提供的镜像服务。执行以下命令设置全局镜像:
- 阿里云镜像:
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - Laravel China 镜像:
composer config -g repo.packagist composer https://packagist.laravel-china.org - 腾讯云镜像:
composer config -g repo.packagist composer https://mirrors.cloud.tencent.com/composer/
设置完成后,所有项目在使用 Composer 时都会自动走该镜像源,无需重复配置。
恢复官方源
如果需要切换回官方源,可运行以下命令:
composer config -g --unset repos.packagist
这会移除自定义镜像配置,Composer 将重新使用默认的 packagist.org 源。
为单个项目配置镜像
若只想对某个项目使用镜像源,可在项目根目录下的 composer.json 中手动添加仓库配置:
{ "repositories": { "packagist": { "type": "composer", "url": "https://mirrors.aliyun.com/composer/" } } }
这种方式不会影响其他项目,适合临时或特定项目使用。
验证镜像是否生效
运行 composer config -l 查看当前配置,检查 repositories.packagist.url 是否指向你设置的国内地址。也可以执行 composer install 观察下载链接是否来自国内域名。
基本上就这些。配置一次后,后续使用 Composer 安装包会快很多,尤其在安装大型框架如 Laravel 时效果明显。


