└── README.md


/README.md:
--------------------------------------------------------------------------------
 1 | ## 如何使用？
 2 | 
 3 | > 请尽可能用比较新的 Composer 版本。
 4 | 
 5 | 使用 Composer 镜像加速有两种选项：
 6 | 
 7 | - 选项一：全局配置，这样所有项目都能惠及（推荐）；
 8 | - 选项二：单独项目配置；
 9 | 
10 | 选项一、全局配置（推荐）
11 | 
12 | ```shell
13 | $ composer config -g repo.packagist composer https://packagist.laravel-china.org
14 | ```
15 | 
16 | 选项二、单独使用
17 | 
18 | 如果仅限当前工程使用镜像，去掉 -g 即可，如下：    
19 | 
20 | ```shell  
21 | $ composer config repo.packagist composer https://packagist.laravel-china.org
22 | ```
23 | 
24 | ## 遇到问题？
25 | 
26 | `composer` 命令后面加上 -vvv （是3个v）可以打印出调错信息，命令如下：
27 | 
28 | ```shell
29 | $ composer -vvv create-project laravel/laravel blog
30 | $ composer -vvv require psr/log
31 | ```
32 |    
33 | 如果自己解决不了，或发现 BUG，可以在 [@扣丁禅师](https://laravel-china.org/users/12063) 的 GitHub 上 [创建 Issue](https://github.com/zencodex/composer/issues/new)。
34 | 
35 | 注意提问时请带上 -vvv 的输出，并且要求叙述清晰，第一次提问的同学请阅读 [关于提问的智慧](https://laravel-china.org/topics/2396/wisdom-of-asking-questions-chinese-version)。
36 | 
37 | ## 常见问题
38 | 
39 | 1. 已存在 composer.lock 文件，先删除，再运行 `composer install` 重新生成。
40 | > 原因：composer.lock 缓存了之前的配置信息，从而导致新的镜像配置无效。
41 | 
42 | 2. 使用 `laravel new` 命令创建工程， 这个命令会从 [这里](http://cabinet.laravel.com/latest.zip) 下一个zip包，里面自带了 composer.lock，和上面原因一样，也无法使用镜像加速，解决方法：
43 | 
44 | - 方法一（推荐）：
45 | 不使用 `laravel new`，直接用 `composer create-project laravel/laravel xxx` 新建工程。
46 | 
47 | - 方法二：
48 | 运行 `laravel new xxx`，当看见屏幕出现 - Installing doctrine/inflector 时，`Ctrl + C` 终止命令，cd xxx 进入，删除 composer.lock，再运行 `composer install`。
49 | 
50 | 3. 缓存多久更新一次？
51 | 
52 | - 0时 - 早上7时，这个时间段考虑使用人数不会太频繁，间隔为15分钟
53 | - 其余时间，间隔为5分钟
54 | 
55 | > 正常更新速度可在1分内完成 ，但更新太快，会降低CDN命中率，如果总有新文件让CDN去缓存，反而拖慢了速度，所以故意加了些延迟。我们每次采集中还会删减掉数千个僵尸包，以加快传输速度。
56 | 
57 | ## 安装 Composer
58 | 
59 | ### Linux/Mac：
60 | 
61 |     wget https://dl.laravel-china.org/composer.phar -O /usr/local/bin/composer
62 | 	chmod a+x /usr/local/bin/composer
63 |  
64 |  如遇权限不足，可添加 `sudo`。
65 |  
66 | ###  Windows：
67 | 
68 | 1. 直接下载 composer.phar，地址：https://dl.laravel-china.org/composer.phar
69 | 2. 把下载的 composer.phar 放到 PHP 安装目录
70 | 3. 新建 composer.bat, 添加如下内容，并保存：  
71 | 
72 | <pre>@php "%~dp0composer.phar" %*</pre>
73 | 
74 | ### 查看当前版本
75 | 
76 | ```shell
77 | $ composer -V
78 | ```
79 | 
80 | ### 升级版本
81 | 
82 | ```shell
83 | $ composer selfupdate
84 | ```
85 | 
86 | > 注意 `selfupdate` 升级命令会连接官方服务器，速度很慢。建议直接下载我们的 `composer.phar` 镜像，每天都会更新到最新。
87 | 
88 | 


--------------------------------------------------------------------------------