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保证团队版本一致。

前言

composer install 装依赖，半天没反应，最后超时失败？那是因为默认的源在国外，国内访问慢。换个国内镜像就快了。

一、为什么会超时

Composer默认从 packagist.org 下载包，服务器在国外，国内访问慢，经常超时。

换个国内镜像源，速度飞快。

二、常用国内镜像

1. 阿里云镜像

https://mirrors.aliyun.com/composer/

2. 腾讯云镜像

https://mirrors.tencent.com/composer/

3. 华为云镜像

https://mirrors.huaweicloud.com/repository/php/

4. 豆瓣镜像（老了，不推荐）

https://packagist.phpcomposer.com

三、全局配置镜像

方法1：命令行配置

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

方法2：改config文件

编辑 ~/.composer/config.json：

{
    "repositories": {
        "packagist": {
            "type": "composer",
            "url": "https://mirrors.aliyun.com/composer/"
        }
    }
}

查看当前镜像

composer config -g repo.packagist

四、项目单独配置

在项目根目录的 composer.json 里加：

{
    "repositories": {
        "packagist": {
            "type": "composer",
            "url": "https://mirrors.aliyun.com/composer/"
        }
    }
}

或者用命令：

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

五、临时使用镜像

不想改全局配置，临时用一次：

composer install --prefer-dist -vvv --repository-url=https://mirrors.aliyun.com/composer/

六、其他常用配置

1. 禁用github接口调用

有时候github的API调用会卡住，禁用掉：

composer config -g github-protocols https

2. 国内composer下载地址

安装composer的时候也慢，用国内下载：

php -r "copy('https://mirrors.aliyun.com/composer/composer.phar', 'composer.phar');"

3. 查看配置

composer config -g --list

七、安装依赖

安装

composer install

更新

composer update

加-v看详细过程

composer install -vvv

八、常见坑

坑1：装了还是慢

缓存没清。

解决：

composer clear-cache

坑2：报SSL错误

SSL certificate problem

解决： 关掉SSL验证（不推荐临时用）：

composer config -g secure-http false

坑3：提示文件权限不够

Failed to download ...

解决： 目录权限不对。

chmod -R 777 vendor
chmod -R 777 composer.json

坑4：内存不够

Allowed memory size of ... bytes exhausted

解决： 加大内存：

php -d memory_limit=-1 /usr/local/bin/composer install

坑5：镜像也挂了

阿里云镜像有时候也抽风。

解决： 换一个镜像，比如腾讯云的。

九、验证镜像生效

查看当前镜像源

composer config -g repo.packagist

输出应该是你设的阿里云地址。

装个小包试试速度

composer require monolog/monolog

看下载速度快不快。

十、推荐配置

一键配置阿里云镜像

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

清缓存

composer clear-cache

安装

composer install

总结

记住：

1. 慢就换国内镜像，阿里云的最稳
2. 全局配置：composer config -g repo.packagist composer 地址
3. 不行就清缓存：composer clear-cache
4. 换镜像：阿里云、腾讯云、华为云
5. 临时用：加 --repository-url=地址

最常用：

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

遇到问题加QQ23979811 协助处理