composer如何加速国内下载?(镜像源配置教程)

1次阅读

composer install 慢因默认直连国外 packagist.org,应全局配置阿里或腾讯镜像源:composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/,验证用 composer config -g repo.packagist。

composer如何加速国内下载?(镜像源配置教程)

composer install 为什么慢到想重装系统?

因为默认走 packagist.org,国内直连经常超时或限速,composer install 卡在 Downloading https://packagist.org/packages.json 是最典型症状。不是你网络差,是源本身没走国内 CDN。

怎么切到阿里/腾讯镜像源

别手动改 composer.json 里的 repositories——那是项目级临时方案,治标不治本。全局生效的正确姿势是改 Composer 自己的配置:

  • 运行 composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/(阿里源)
  • 或换腾讯源:composer config -g repo.packagist composer https://mirrors.cloud.tencent.com/composer/
  • 验证是否生效:composer config -g repo.packagist 应该输出对应 URL

注意:-g 表示全局,影响所有项目;如果某项目必须用官方源,进项目目录执行 composer config repo.packagist composer https://packagist.org 覆盖即可。

镜像源失效了怎么办?

阿里云和腾讯云镜像基本稳定,但偶尔会同步延迟(比如新发布的包几小时内搜不到),错误现象是 Could not find package xxx at any version,但官方源能查到。

  • 先确认包名拼写和版本约束是否正确,排除误判
  • 临时切回官方源测试:composer config -g repo.packagist composer https://packagist.org
  • 同步延迟一般不超过 2 小时,不用急着换源;长期失效才考虑切华为云或中科大源

镜像本质是定时同步,不是实时代理,这点容易被忽略。

laravel/installer 或 create-project 依然很慢?

因为这类命令会先拉 composer create-project 的骨架,再跑 install,而骨架元数据仍可能从官方源读取。解决方法是提前预置镜像配置:

  • 运行 composer global require laravel/installer 前,确保已配置好全局镜像
  • create-project 时加 --repository-url 参数:composer create-project laravel/laravel demo --repository-url=https://mirrors.aliyun.com/composer/
  • 部分老版本 Composer(–repository-url 支持不全,建议升级到 composer self-update

镜像只加速包下载,不加速 autoload 生成或脚本执行——如果 install 后半段还卡,问题不在源。

text=ZqhQzanResources