让PHP依赖安装变得简单，Composer中文镜像来帮您！-composer-PHP中文网

最稳妥方式是执行composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/全局配置阿里云镜像，需严格满足-g参数、键名repo.packagist、type值composer及url末尾带斜杠，再运行composer clear-cache验证生效。

让php依赖安装变得简单，composer中文镜像来帮您！

Composer 默认源在国内访问慢、超时频繁，直接 composer install 常卡在 Downloading... 或报错 Connection refused —— 换中文镜像不是“锦上添花”，而是必须步骤。

怎么快速切换到国内镜像源

最稳妥的方式是全局配置阿里云或腾讯云镜像（二者稳定性好、同步及时）。执行以下命令即可生效：

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

验证是否生效：运行 composer config -g repo.packagist，输出应为对应镜像 URL。注意：-g 表示全局，无需每次进项目重复设置；若只想改当前项目，去掉 -g 即可。

不要用 composer config repo.packagist https://packagist.phpcomposer.com —— 该源已停用多年，会触发 404 或重定向失败
避免手动编辑 ~/.composer/config.json，易格式错误导致后续所有命令报 JSON decode error
如果公司内网禁用了 HTTPS，可临时改用 HTTP 镜像（如 http://mirrors.tuna.tsinghua.edu.cn/composer/），但需确认 Composer 版本 ≥ 2.2，否则拒绝非 HTTPS 源

为什么 `composer update` 还是慢？检查是否被 `repositories` 覆盖

项目根目录的 composer.json 中若定义了 repositories 字段（尤其含 packagist.org 或自建源），会优先级高于全局镜像，导致回退到原始源下载。

典型问题配置：

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

"repositories": [
  {
    "type": "composer",
    "url": "https://packagist.org"
  }
]

解决方法：

删掉整个 repositories 块（除非你真需要私有包）
或把其中的 url 改成镜像地址，例如 "url": "https://mirrors.aliyun.com/composer/"
运行 composer update --dry-run 先确认源是否已切换成功，避免误操作触发大量重下载

CI/CD 环境下镜像失效？记得清理缓存并指定源

GitHub Actions、GitLab CI 等环境默认无全局配置，且缓存机制可能复用旧镜像记录，导致构建时仍走国外源。

推荐写法（以 GitHub Actions 为例）：

run: |
  composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
  composer clear-cache
  composer install --no-interaction --optimize-autoloader

关键点：