0

0

composer国内镜像怎么设置_阿里云/腾讯云镜像切换与加速【实操】

穿越時空

穿越時空

发布时间:2026-01-01 16:01:02

|

820人浏览过

|

来源于php中文网

原创

推荐换阿里云镜像源:执行 composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ 全局生效,验证输出应为含该 URL 的 JSON;腾讯云镜像存在同步延迟和证书校验问题;create-project 需加 --repository-url 或升级 Composer 2.x;镜像失效时可 unset 后重设或手动编辑 config.json 并清缓存。

composer国内镜像怎么设置_阿里云/腾讯云镜像切换与加速【实操】

Composer 默认源在国外,国内直接用 composer installcomposer update 极易超时、卡死或报 Connection refused 错误。最有效解法不是改 hosts 或开代理,而是换国内镜像源——阿里云和腾讯云镜像都可用,但要注意:它们不完全等价,且全局设置与项目级设置行为不同。

怎么快速切换到阿里云镜像(推荐)

阿里云镜像同步及时、稳定性高,是目前最稳妥的选择。执行以下命令即可全局生效:

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

验证是否生效,运行:

composer config -g repo.packagist

输出应为 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}。注意:-g 表示全局配置,写入的是 ~/.composer/config.json,对所有项目生效;若只想改当前项目,去掉 -g 即可。

腾讯云镜像能用吗?有什么坑

腾讯云镜像地址是 https://mirrors.cloud.tencent.com/composer/,技术上可用,但存在两个现实问题:

  • 部分较新的包(尤其是 dev 分支或刚发布的版本)同步有数分钟延迟,容易触发 Could not find package xxx
  • 其根证书在某些旧版 OpenSSL 环境下校验失败,报错类似 cURL error 60: SSL certificate problem

如必须用腾讯云,建议加 --no-secure-http 临时绕过(不推荐长期使用):

超级简历WonderCV
超级简历WonderCV

免费求职简历模版下载制作,应届生职场人必备简历制作神器

下载
composer config -g repo.packagist composer https://mirrors.cloud.tencent.com/composer/
composer config -g secure-http false

为什么 composer create-project 还是慢?

这个命令默认不走你设的镜像源,它会先从 Packagist.org 拉取 composer.json 元数据,再下载 ZIP 包——而 ZIP 包地址仍指向原始 GitHub/GitLab,不受镜像控制。

解决办法有两个:

  • --repository-url 显式指定镜像源:
    composer create-project laravel/laravel myapp --repository-url=https://mirrors.aliyun.com/composer/
  • 更彻底的做法:安装 hirak/prestissimo 插件(已弃用但兼容性好),或升级到 Composer 2.x(默认并行下载 + 内置镜像感知逻辑)

镜像失效了怎么办?怎么回退

镜像源偶尔维护或变更 URL(比如阿里云曾从 http 升级为强制 https),遇到 Could not resolve host403 Forbidden 时,优先检查官方公告,再手动重置:

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

如果连 composer config 都执行失败(比如因网络导致命令卡住),可直接编辑 ~/.composer/config.json,删掉 repos 字段或修正 url 值。别忘了清缓存:

composer clear-cache

真正麻烦的不是换源本身,而是有些 CI/CD 流水线或 Dockerfile 里硬编码https://packagist.org,这类地方得一并改掉,否则本地快了,上线照样挂。

相关专题

更多
composer是什么插件
composer是什么插件

Composer是一个PHP的依赖管理工具,它可以帮助开发者在PHP项目中管理和安装依赖的库文件。Composer通过一个中央化的存储库来管理所有的依赖库文件,这个存储库包含了各种可用的依赖库的信息和版本信息。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

147

2023.12.25

json数据格式
json数据格式

JSON是一种轻量级的数据交换格式。本专题为大家带来json数据格式相关文章,帮助大家解决问题。

403

2023.08.07

json是什么
json是什么

JSON是一种轻量级的数据交换格式,具有简洁、易读、跨平台和语言的特点,JSON数据是通过键值对的方式进行组织,其中键是字符串,值可以是字符串、数值、布尔值、数组、对象或者null,在Web开发、数据交换和配置文件等方面得到广泛应用。本专题为大家提供json相关的文章、下载、课程内容,供大家免费下载体验。

528

2023.08.23

jquery怎么操作json
jquery怎么操作json

操作的方法有:1、“$.parseJSON(jsonString)”2、“$.getJSON(url, data, success)”;3、“$.each(obj, callback)”;4、“$.ajax()”。更多jquery怎么操作json的详细内容,可以访问本专题下面的文章。

307

2023.10.13

go语言处理json数据方法
go语言处理json数据方法

本专题整合了go语言中处理json数据方法,阅读专题下面的文章了解更多详细内容。

74

2025.09.10

curl_exec
curl_exec

curl_exec函数是PHP cURL函数列表中的一种,它的功能是执行一个cURL会话。给大家总结了一下php curl_exec函数的一些用法实例,这个函数应该在初始化一个cURL会话并且全部的选项都被设置后被调用。他的返回值成功时返回TRUE, 或者在失败时返回FALSE。

424

2023.06.14

linux常见下载安装工具
linux常见下载安装工具

linux常见下载安装工具有APT、YUM、DNF、Snapcraft、Flatpak、AppImage、Wget、Curl等。想了解更多linux常见下载安装工具相关内容,可以阅读本专题下面的文章。

172

2023.10.30

scripterror怎么解决
scripterror怎么解决

scripterror的解决办法有检查语法、文件路径、检查网络连接、浏览器兼容性、使用try-catch语句、使用开发者工具进行调试、更新浏览器和JavaScript库或寻求专业帮助等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

184

2023.10.18

php源码安装教程大全
php源码安装教程大全

本专题整合了php源码安装教程,阅读专题下面的文章了解更多详细内容。

65

2025.12.31

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Laravel---API接口
Laravel---API接口

共7课时 | 0.6万人学习

PHP自制框架
PHP自制框架

共8课时 | 0.6万人学习

PHP面向对象基础课程(更新中)
PHP面向对象基础课程(更新中)

共12课时 | 0.6万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号