composer如何配置和使用国内镜像源解决下载慢问题-composer-PHP中文网

composer如何配置和使用国内镜像源解决下载慢问题

穿越時空

发布： 2025-10-24 09:05:02

原创

529人浏览过

配置国内镜像源可提升Composer下载速度，推荐使用阿里云、Laravel China或腾讯云镜像，通过composer config -g设置全局源，单个项目可在composer.json中添加repositories配置，验证可用composer config -l检查生效情况。

composer如何配置和使用国内镜像源解决下载慢问题

使用 Composer 安装 PHP 包时，由于默认源在国外，下载速度可能很慢。通过配置国内镜像源，可以显著提升下载速度。以下是如何配置和使用国内镜像源的详细方法。

配置全局镜像源（推荐）

将 Composer 的默认仓库替换为国内镜像，例如阿里云、 Laravel China 或腾讯云提供的镜像服务。执行以下命令设置全局镜像：

阿里云镜像： composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
Laravel China 镜像： composer config -g repo.packagist composer https://packagist.laravel-china.org
腾讯云镜像： composer config -g repo.packagist composer https://mirrors.cloud.tencent.com/composer/

设置完成后，所有项目在使用 Composer 时都会自动走该镜像源，无需重复配置。

恢复官方源

如果需要切换回官方源，可运行以下命令：

composer config -g --unset repos.packagist

这会移除自定义镜像配置，Composer 将重新使用默认的 packagist.org 源。

Trae国内版

国内首款AI原生IDE，专为中国开发者打造

815

查看详情

为单个项目配置镜像

若只想对某个项目使用镜像源，可在项目根目录下的 composer.json 中手动添加仓库配置：

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

登录后复制

这种方式不会影响其他项目，适合临时或特定项目使用。