composer 切换为中国镜像

最新推荐文章于 2025-03-31 14:03:22 发布

onejson

最新推荐文章于 2025-03-31 14:03:22 发布

阅读量6.1k

点赞数

分类专栏： php

php 专栏收录该内容

45 篇文章

订阅专栏

本文介绍两种配置Composer使用国内镜像的方法，以实现快速稳定的包管理体验。通过修改全局配置或项目级composer.json，用户可以轻松利用Packagist中国全量镜像，避免因国外服务器连接不稳定导致的问题。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

转自：https://pkg.phpcomposer.com/

方法一：修改 composer 的全局配置文件（推荐方式）
打开命令行窗口（windows用户）或控制台（Linux、Mac 用户）并执行如下命令：

composer config -g repo.packagist composer https://packagist.phpcomposer.com

方法二：修改当前项目的 composer.json 配置文件：
打开命令行窗口（windows用户）或控制台（Linux、Mac 用户），进入你的项目的根目录（也就是 composer.json 文件所在目录），执行如下命令：

composer config repo.packagist composer https://packagist.phpcomposer.com

上述命令将会在当前项目中的 composer.json 文件的末尾自动添加镜像的配置信息（可以自己手工添加）：

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

以 laravel 项目的 composer.json 配置文件为例，执行上述命令后如下所示（注意最后几行）：

{  
    "name": "laravel/laravel",  
    "description": "The Laravel Framework.",  
    "keywords": ["framework", "laravel"],  
    "license": "MIT",  
    "type": "project",  
    "require": {  
        "php": ">=5.5.9",  
        "laravel/framework": "5.2.*"  
    },  
    "config": {  
        "preferred-install": "dist"  
    },  
    "repositories": {  
        "packagist": {  
            "type": "composer",  
            "url": "https://packagist.phpcomposer.com"  
        }  
    }  
}

OK，一切搞定！试一下 composer install 来体验飞一般的速度吧！

一般情况下，安装包的数据（主要是 zip 文件）一般是从 github.com 上下载的，安装包的元数据是从 packagist.org 上下载的。

然而，由于众所周知的原因，国外的网站连接速度很慢，并且随时可能被“墙”甚至“不存在”。

“Packagist 中国全量镜像”所做的就是缓存所有安装包和元数据到国内的机房并通过国内的 CDN 进行加速，这样就不必再去向国外的网站发起请求，从而达到加速 composer install以及 composer update 的过程，并且更加快速、稳定。因此，即使packagist.org、github.com 发生故障（主要是连接速度太慢和被墙），你仍然可以下载、更新安装包。