如何配置 Composer 使用国内镜像源(如阿里云、腾讯云)来加速下载?

16次阅读

直接修改 composer 全局配置为国内镜像(如阿里云 https://mirrors.aliyun.com/composer/)可显著提升下载速度;支持全局、临时、项目级三种切换方式,命令明确且易验证。

如何配置 Composer 使用国内镜像源(如阿里云、腾讯云)来加速下载?

直接修改 Composer 的全局配置,把默认源换成国内镜像,下载速度会明显提升。阿里云腾讯云的镜像稳定、同步及时,是常用选择。

临时切换镜像(单次命令有效)

在执行 composer installcomposer update 时,加上 -vvv 参数可确认当前使用的源。如需临时用阿里云镜像,运行:

  • composer create-project laravel/laravel demo --repository=https://mirrors.aliyun.com/composer/
  • 或更新依赖时指定:composer update -vvv --repository=https://mirrors.aliyun.com/composer/

全局替换为阿里云镜像

执行以下命令,将默认 packagist 源永久替换成阿里云镜像:

  • composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/

完成后可运行 composer config -g repo.packagist 验证是否生效,输出应为 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}

切换回腾讯云镜像或还原默认源

腾讯云镜像地址是 https://mirrors.cloud.tencent.com/composer/,替换命令类似:

  • composer config -g repo.packagist composer https://mirrors.cloud.tencent.com/composer/
  • 想恢复官方源:执行 composer config -g --unset repos.packagist

项目级配置(仅对当前目录生效)

如果不想影响全局,进入项目根目录后运行(不加 -g):

  • composer config repo.packagist composer https://mirrors.aliyun.com/composer/
  • 该配置会写入项目下的 composer.json 文件中 repositories 字段,适合团队统一管理

基本上就这些。换源不复杂但容易忽略,配好之后装包快很多,尤其在国内网络环境下。

text=ZqhQzanResources