Composer中文镜像安装指南，助你高效构建PHP项目！-composer-PHP中文网

临时切换阿里云镜像应使用环境变量：composer_repo_packagist=https://mirrors.aliyun.com/composer/ composer install -vvv，该方式不修改配置文件、退出终端即失效，适用于单次安装或ci环境快速验证。

composer中文镜像安装指南，助你高效构建php项目！

Composer 安装慢或失败，大概率不是网络问题，而是默认源 packagist.org 在国内解析不稳定、TLS握手超时或被限速——换镜像不是“锦上添花”，是必要操作。

适合单次安装或 CI 环境快速验证。执行前确认已安装 Composer（composer --version 可查）：

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

这条命令会修改全局配置文件 ~/.composer/config.json，后续所有项目都走阿里云镜像。如果只想对当前项目生效，去掉 -g 参数，并在项目根目录下运行。

腾讯云镜像（https://mirrors.cloud.tencent.com/composer/）近年部分地区存在证书链不完整问题，尤其 PHP 7.4 以下或 OpenSSL 版本较老的环境。常见表现是：

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

下载

解决方法不是关 SSL 验证（composer config -g secure-http false 极不推荐），而是换源或升级系统 CA 包。优先选阿里云或华为云镜像，二者证书兼容性更稳。

会，且容易被忽略。Composer 的镜像机制只代理公共包（packagist.org），但一旦你配置了私有仓库（如 GitLab 或 Satis），必须显式声明其为“非镜像”：

composer config -g repositories.my-private '{"type": "composer", "url": "https://your-company.com/packagist"}'

同时确保该仓库 URL 不匹配任何镜像规则（比如不能以 https://mirrors. 开头）。否则 Composer 会尝试把私有包请求也转发到镜像站，返回 404 或空响应。

镜像不是一劳永逸的开关，它和你的 PHP 版本、OpenSSL、DNS 解析策略、甚至公司防火墙策略都有关联；每次 composer install 卡住，先 composer diagnose 检查源是否可连通，再看是不是镜像本身出了临时故障。

php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！

Composer中文镜像安装指南，助你高效构建PHP项目！