Packagist 鏡像使用方法php
還沒安裝 Composer 嗎?請往下看如何安裝 Composer 。
鏡像用法laravel
有兩種方式啓用本鏡像服務:git
系統全局配置: 即將配置信息添加到 Composer 的全局配置文件 config.json 中。見「方法一」 單個項目配置: 將配置信息添加到某個項目的 composer.json 文件中。見「方法二」
方法一: 修改 composer 的全局配置文件(推薦方式)github
打開命令行窗口(windows用戶)或控制檯(Linux、Mac 用戶)並執行以下命令:
複製json
composer config -g repo.packagist composer https://packagist.phpcomposer...windows
方法二: 修改當前項目的 composer.json 配置文件:緩存
打開命令行窗口(windows用戶)或控制檯(Linux、Mac 用戶),進入你的項目的根目錄(也就是 composer.json 文件所在目錄),執行以下命令:
複製composer
composer config repo.packagist composer https://packagist.phpcomposer...網站
上述命令將會在當前項目中的 composer.json 文件的末尾自動添加鏡像的配置信息(你也能夠本身手工添加):
複製ui
"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 發生故障(主要是鏈接速度太慢和被牆),你仍然能夠下載、更新安裝包。