composer
是 php
包管理工具,使用它可以很方便进行构建项目,载入三方包,以及各种复杂依赖,自动加载等需要。
安装composer
curl -sS https://getcomposer.org/installer | php -- \
--install-dir=/usr/bin \
--filename=composer
安装后,使用 composer -v
来查看版本号等信息。
修改代码仓库源
由于 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
查看全部全局配置
composer config -g --list
查看单个项目全部配置
composer config --list
查看某个配置
composer config -g repositories.packagist.org
取消某一项配置
composer config -g --unset repos.packagist
创建新项目
创建一个 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
指定新建项目文件夹。
检索仓库里的包
composer search monolog/monolog
安装新依赖包
composer require monolog/monolog
控制版本号
# 指定版本
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
移除依赖包
composer remove monolog/monolog
初始化一个composer.json
composer init
查看已存在的包
composer info
根据composer.lock安装依赖包(如果存在),否则根据composer.json
composer install
根据composer.json更新依赖到指定范围内最新版,并更新composer.lock文件
composer update
清理缓存
composer clearcache
更新composer.phar
composer self-update