Composer 中國全量鏡像』是由 Laravel China 社區聯合 又拍雲 與 優帆遠揚 共同合作推出的公益項目,旨在為廣大 PHP 用戶提供穩定和高速的 Composer 國內鏡像服務。
如何使用?請儘可能用比較新的 Composer 版本。
使用 Composer 鏡像加速有兩種選項:
選項一:全局配置,這樣所有項目都能惠及(推薦);
選項二:單獨項目配置;
選項一、全局配置(推薦)
$ composer config -g repo.packagist composer https://packagist.laravel-china.org
選項二、單獨使用
如果僅限當前工程使用鏡像,去掉 -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 的輸出,並且要求敘述清晰,第一次提問的同學請閱讀 關於提問的智慧。
常見問題已存在 composer.lock 文件,先刪除,再運行 composer install 重新生成。
原因:composer.lock 緩存了之前的配置信息,從而導致新的鏡像配置無效。
使用 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。
wget https://dl.laravel-china.org/composer.phar -O /usr/local/bin/composer chmod a+x /usr/local/bin/composer
如遇權限不足,可添加 sudo。
Windows:直接下載 composer.phar,地址:https://dl.laravel-china.org/composer.phar
把下載的 composer.phar 放到 PHP 安裝目錄
新建 composer.bat, 添加如下內容,並保存:
@php "%~dp0composer.phar" %*
查看當前版本$ composer -V
升級版本$ composer selfupdate
注意 selfupdate 升級命令會連接官方伺服器,速度很慢。建議直接下載我們的 composer.phar 鏡像,每天都會更新到最新。
致謝Composer 中國全量鏡像的 CDN 由國內領先 CDN 服務商「又拍雲」提供,相信這次聯合合作能給 Composer 鏡像提供穩定、快速的 CDN 支持。