Packagist 鏡像使用方法--composer

鏡像用法

有兩種方式啓用本鏡像服務：

• 系統全局配置： 即將配置信息添加到 Composer 的全局配置文件 config.json 中。見「方法一」
• 單個項目配置： 將配置信息添加到某個項目的 composer.json 文件中。見「方法二」

 

方法一： 修改 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 發生故障（主要是鏈接速度太慢和被牆），你仍然能夠下載、更新安裝包。