composer 使用细则

一、composer install 和 composer update 的区别

1.composer.json 文件

指定了项目依赖组件的版本规则及镜像地址

如果没有配置镜像地址，则默认使用全局安装的composer镜像地址

2.composer.lock 文件

保存着当前项目所依赖的php组件的镜像地址及具体的版本号，这样就会有效防止下次install的时候，多人协作依赖的版本不一致问题。

3.composer install

具体分2种情况

第一种：项目里没有composer.lock文件

会根据composer.json文件里配置的版本规则和镜像地址安装组件，并将其安装到vendor目录下。

并生成一个新的composer.lock文件

第二种：项目里有composer.lock文件

不会从 composer.json 文件里读取相关配置规则

直接从composer.lock文件里面的镜像地址安装指定版本的组件

并将其安装到vendor目录下。

4.composer update

从 composer.json 文件里读取第三方组件及其版本配置规则，更新或安装PHP 组件版本

并重新生成一个composer.lock文件，

即会覆盖掉之前的composer.lock文件里的内容

如果依赖的第三方组件有版本更新，update会将最新的版本安装到vendor目录下，并更新composer.lock。风险比较大。

当多人协作开发的时候，需要保证项目所依赖的php组件的版本保持一致

这个时候就要必须把composer.lock加入版本控制当中

如果是个人项目，则随意即可！

二、laravel 项目安装失败问题先试试这个方法

第一步：删除安装失败的laravel项目，window直接删除，linux 使用 rm -rf 文件名(更换为自己的项目文件夹名) 删除。

第二步：使用composer self-update命令确认自己的composer版本是不是最新版本。

第三步：使用composer clearcache 命令清除composer缓存。

第四步：重点。更换composer镜像为阿里云镜像。

composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
即使使用的是官方镜像 https://packagist.phpcomposer.com，也要换成阿里云镜像，官方镜像有毒…

第五步：然后就是正常安装：composer create-project --prefer-dist laravel/laravel 文件名

三、Composer常用的命令整理

composer是php包管理工具，使用它可以很方便进行构建项目，载入三方包，以及各种复杂依赖，自动加载等需要。

1.安装composer

curl -sS https://getcomposer.org/installer | php -- \
    --install-dir=/usr/bin \
    --filename=composer

安装后，使用composer -v来查看版本号等信息。

2.修改代码仓库源

由于composer默认的源服务器在国外，因为众所周知的原因，下载龟速，我们需要将其替换为国内的全量源，目前可用的有这两个：

来自 https://php.cnpkg.org/

composer config -g repos.packagist composer https://php.cnpkg.org

来自 Laravel China

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

3.查看全部全局配置

composer config -g --list

4.查看单个项目全部配置

composer config --list

5.查看某个配置

composer config -g repositories.packagist.org

6.取消某一项配置

composer config -g --unset repos.packagist

7.创建新项目

创建一个Yii项目

composer create-project --prefer-dist yiisoft/yii2-app-basic basic.com

其中create-project命令后面的--prefer-dist还可以使用--prefer-source，它们的区别：

--prefer-dist会从github上下载.zip压缩包，并缓存到本地。下次再安装就会从本地加载，大大加速安装速度。但她没有保留 .git文件夹,没有版本信息。适合基于这个package进行开发。

--prefer-source 会从github上clone源代码，不会在本地缓存（最新的版本也可以使用缓存了）。保留了.git文件夹，从而可以实现版本控制。适合用于修改源代码。

推荐使用--prefer-dist可以加快速度，在使用的时候有可能会有下面类似的警告：

Failed to download yiisoft/yii2-gii from dist: The zip extension and unzip command are both missing, skipping.
Your command-line PHP is using multiple ini files. Run `php --ini` to show them.

环境中缺少zip，unzip工具包，安装一下：

apt-get install zip unzip

之后跟的yiisoft/yii2-app-basic就是项目包名，最后面的basic.com指定新建项目文件夹。

8.检索仓库里的包

composer search monolog/monolog

9.安装新依赖包

composer require monolog/monolog

10.控制版本号

# 指定版本
composer require monolog/monolog 1.24.0
# 版本范围
# 有效的运算符有 >、>=、<、<=、!=，运算符中间使用逗号隔开视作逻辑AND，使用|隔开，视作逻辑OR，AND的优先级更高
# 支持通配符 * 
# 支付波浪号运算符 ~ 限定在最低版本和下一个重要版本更新之前
# 以下都是有效的版本号

# 版本大于等于1.0
>=1.0
# 版本大于等于1.0并且小于2.0
>=1.0,<2.0
# 版本大于等于1.0并且小于1.1，或者版本大于等于1.2
>=1.0,<1.1|>=1.2
# 相当于>=1.0,<1.1
1.0.* 
# 相当于>=1.2,<2.0
~1.2
# 相当于>=1.2.3,<1.3
~1.2.3
# 相当于>=1.2.3,<2.0.0  在多于2位的版本号的时候跟 ~ 有区别
^1.2.3