Composer国内镜像配置

Composer国内镜像配置

引言

PHP项目用Composer安装依赖时，默认从packagist.org国外源拉取，国内网络经常超时、下载极慢。配置国内镜像源后，安装速度能提升数倍，是PHP开发环境必备操作。

全局配置方法

终端执行下面命令，把全局镜像换成国内源：

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

执行后写入用户全局配置，所有项目生效。

单个项目配置

只给当前项目换源，在项目目录执行：

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

常见国内镜像

• 阿里云镜像：https://mirrors.aliyun.com/composer/
• 腾讯云镜像：https://mirrors.cloud.tencent.com/composer/
• 华为云镜像：https://repo.huaweicloud.com/repository/php/

验证与切换

#查看当前源
composer config -g repos

#回到官方源
composer config -g --unset repos.packagist

注意事项

• 镜像只加速包下载，不影响代码本身；
• 生产环境尽量锁定composer.lock版本；
• 个别新包国内镜像同步延迟，临时可切官方源；
• 配置后先清缓存再安装：composer clearcache。

总结

Composer换源是国内PHP开发第一步，全局配置阿里云镜像即可解决大部分超时问题。安装依赖前先清缓存，项目锁定lock保证团队版本一致。