PHP Composer 换国内镜像源加速

composer install / composer update 慢,是因为默认从海外的 Packagist 拉取。换成国内 Composer 镜像即可提速。

一、全局换源(推荐)

一次配置,以后所有项目都走镜像:

# 阿里云
composer config -g repos.packagist composer https://mirrors.aliyun.com/composer/

# 或腾讯云
composer config -g repos.packagist composer https://mirrors.tencent.com/composer/

查看是否生效:

composer config -g repos.packagist

二、项目级换源

只想给当前项目换源(会写进项目的 composer.json):

composer config repo.packagist composer https://mirrors.aliyun.com/composer/

或手动在项目 composer.json 里加:

{
  "repositories": {
    "packagist": {
      "type": "composer",
      "url": "https://mirrors.aliyun.com/composer/"
    }
  }
}

三、常用镜像

镜像	地址
阿里云	https://mirrors.aliyun.com/composer/
腾讯云	https://mirrors.tencent.com/composer/
华为云	https://mirrors.huaweicloud.com/repository/php/

四、还原官方源

composer config -g --unset repos.packagist

五、Composer 自身更新慢

更新 Composer 本体(composer self-update)慢时,它从 GitHub 拉 phar,可走 代理,或用包管理器(如 brew / apt)升级 Composer。

常见问题

Q:换源后报 "The contents of ... do not match its signature"? 镜像同步延迟或缓存问题,composer clear-cache 后重试。

Q:某些包在镜像上找不到? 镜像通常全量同步 Packagist;若确实缺,临时 --unset 走官方源装这一个,或走代理。

Q:私有包 / VCS 仓库(GitHub)慢? 那不走 Packagist,是直接从 GitHub 拉,需给 git 配 代理。

小结

• 一条 composer config -g repos.packagist composer <镜像> 全局搞定。
• 阿里云 / 腾讯 / 华为任选。
• Composer 本体更新和私有 VCS 依赖走代理,不归镜像管。

---

本文仅供技术学习与研究,请遵守所在国家/地区法律法规。