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

鏡像的由來？

幾個月前，我有幸加入了 優帆遠揚 的遠程工程師團隊。 Summer 在與我溝通過後，提議我們一起合作，以 Laravel China 社區的名義來構建一個長久維護，高可用性，快速穩定的 Composer 全量鏡像。

維持多久？

我個人會盡最大努力來持續維護這個鏡像。另外，因為是以 Laravel China 社區的名義發起的項目，用 Summer 的話來說：

只要 Learnku.com 還活著，這個項目就會一直持續下去。

所以，大家可以放心使用，而且從來都不是我一個人在戰鬥，我的背後是一支卓越的團隊在給予各方面支持。

如何使用？

請盡可能用比較新的 Composer 版本。

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

• 選項一：全局配置，這樣所有項目都能惠及（推薦）；
• 選項二：單獨項目配置；

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

選項二、單獨使用

如果僅限當前工程使用鏡像，去掉 -g 即可，如下：

取消鏡像

遇到問題？

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

如果自己解決不了，或發現 BUG，可以在 @扣丁禪師 的 GitHub 上 創建 Issue。

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

常見問題

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

   原因：composer.lock 緩存了之前的配置信息，從而導致新的鏡像配置無效。

2. 使用 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。
3. 緩存多久更新一次？
   • 0時 - 早上7時，這個時間段考慮使用人數不會太頻繁，間隔為15分鐘
   • 其余時間，間隔為5分鐘

     正常更新速度可在1分內完成 ，但更新太快，會降低CDN命中率，如果總有新文件讓CDN去緩存，反而拖慢了速度，所以故意加了些延遲。我們每次采集中還會刪減掉數千個僵屍包，以加快傳輸速度。

安裝 Composer

Linux/Mac：

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

Windows：

1. 直接下載 composer.phar，地址：https://dl.laravel-china.org/composer.phar
2. 把下載的 composer.phar 放到 PHP 安裝目錄
3. 新建 composer.bat, 添加如下內容，並保存：

查看當前版本

升級版本

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

致謝

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

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

扣丁禪師 ：行住坐臥悟禪宗，禪堂禪師禪Coding

Composer 中文鏡像 Lavavel-china 公益項目