Composer 中文鏡像 / Packagist 中國全量鏡像正式發佈！

『Composer 中國全量鏡像』是由 Laravel China 社區聯合 又拍雲 與 優帆遠揚 共同合做推出的公益項目，旨在爲廣大 PHP 用戶提供穩定和高速的 Composer 國內鏡像服務。

關於做者

本項目由 @扣丁禪師 獨立開發。禪師現居瀋陽，遠程辦公族，熱愛編程，嚮往自由。目前爲 優帆遠揚的遠程高級開發工程師 、高級架構師。

鏡像的做用？

通常狀況下，安裝包的數據（主要是 zip 文件）通常是從 http://github.com 上下載，安裝包的元數據是從 http://packagist.org 上下載。

然而，因爲衆所周知的緣由，國外的網站鏈接速度很慢，而且隨時可能被 『牆』 甚至 『不存在」』。

全量鏡像所作的就是緩存全部安裝包和元數據到 Linode 服務器上，並經過國內的 CDN 進行加速，從而讓 composer install 以及 composer update 的操做達到最快速度。因此即便是 packagist.org, http://github.com 發生故障（主要是鏈接速度太慢和被牆），你仍然能夠下載、更新安裝包。

鏡像的由來？

幾個月前，禪師 加入了 優帆遠揚 的遠程工程師團隊。我在瞭解他的工程背景之後，發現是一牛逼的高手。遂提議一塊兒合做：以 Laravel China 社區的名義來構建一個長久維護、高可用性、快速穩定的 Composer 全量鏡像。

禪師很爽快地就答應了。通過禪師一個月的開發和設計，兩個多月的內側，今日終於面世。

維護多久?

只要 優帆遠揚 和 Laravel China 還活着，這個項目就會一直持續下去。

因此，你們能夠放心使用。

如何使用？

請儘量用比較新的 Composer 版本。

使用 Composer 鏡像加速有兩種選項：

• 選項一：全局配置，這樣全部項目都能惠及（推薦）；

• 選項二：單獨項目配置；

選項1、全局配置（推薦）

$ composer config -g repo.packagist composer https://packagist.laravel-china.org

選項2、單獨使用

若是僅限當前工程使用鏡像，去掉 -g 便可，以下：

$ composer config repo.packagist composer https://packagist.laravel-china.org

遇到問題？

composer 命令後面加上 -vvv （是3個v）能夠打印出調錯信息，命令以下：

$ composer -vvv create-project laravel/laravel blog
$ composer -vvv require psr/log

若是本身解決不了，或發現 BUG，能夠在 @扣丁禪師 的 GitHub 上 建立 Issue。

注意提問時請帶上 -vvv 的輸出，而且要求敘述清晰，第一次提問的同窗請閱讀 關於提問的智慧。

常見問題

1. 已存在 composer.lock 文件，先刪除，再運行 composer install 從新生成。

緣由：composer.lock 緩存了以前的配置信息，從而致使新的鏡像配置無效。

1. 使用 laravel new 命令建立工程， 這個命令會從 這裏 下一個zip包，裏面自帶了 composer.lock，和上面緣由同樣，也沒法使用鏡像加速，解決方法：

• 方法一（推薦）：
  不使用 laravel new，直接用 composer create-project laravel/laravel xxx 新建工程。

• 方法二：
  運行 laravel new xxx，當看見屏幕出現 - Installing doctrine/inflector 時，Ctrl + C 終止命令，cd xxx 進入，刪除 composer.lock，再運行 composer install。

安裝 Composer

Linux/Mac：

wget https://dl.laravel-china.org/composer.phar -O /usr/local/bin/composer
chmod a+x /usr/local/bin/composer

如遇權限不足，可添加 sudo。

Windows：

1. 直接下載 composer.phar，地址：https://dl.laravel-china.org/...

2. 把下載的 composer.phar 放到 PHP 安裝目錄

3. 新建 composer.bat, 添加以下內容，並保存：

<pre>@php "%~dp0composer.phar" %*</pre>

查看當前版本

$ composer -V

升級版本

$ composer selfupdate

注意 selfupdate 升級命令會鏈接官方服務器，速度很慢。建議直接下載咱們的 composer.phar 鏡像，天天都會更新到最新。

致謝

Composer 中國全量鏡像的 CDN 由國內領先 CDN 服務商「又拍雲」提供，相信此次聯合合做能給 Composer 鏡像提供穩定、快速的 CDN 支持。

另外也在此特別感謝「優帆遠揚」在項目開發中提供的技術支持。

社區討論：https://laravel-china.org/com...