簡介
Composer 是 PHP 的一個依賴管理工具瞪慧。我們可以在項目中聲明所依賴的外部工具庫干旁,Composer 會幫你安裝這些依賴的庫文件搓扯,有了它夯秃,我們就可以很輕松的使用一個命令將其他人的優(yōu)秀代碼引用到我們的項目中來介劫。
Composer 默認情況下不是全局安裝徽惋,而是基于指定的項目的某個目錄中(例如 vendor)進行安裝。
Composer 需要 PHP 5.3.2+ 以上版本座韵,且需要開啟 openssl险绘。
Composer 可運行在 Windows 、 Linux 以及 OSX 平臺上誉碴。
Composer 的安裝
Wondows 平臺
Wondows 平臺上宦棺,我們只需要下載 Composer-Setup.exe 后,一步步安裝即可黔帕。
需要注意的是你需要開啟 openssl 配置代咸,我們打開 php 目錄下的 php.ini,將 extension=php_openssl.dll 前面的分號去掉就可以了成黄。
安裝成功后呐芥,我們可以通過命令窗口(cmd) 輸入 composer --version 命令來查看是否安裝成功:
接下來我們可以更改 Packagist 為國內(nèi)鏡像:
composer config -g repo.packagist composer https://packagist.phpcomposer.com
Linux 平臺
Linux 平臺可以使用以下命令來安裝
# php -r "copy('https://install.phpcomposer.com/installer', 'composer-setup.php');"
# php composer-setup.php
All settings correct for using Composer
Downloading...
Composer (version 1.6.5) successfully installed to: /root/composer.phar
Use it: php composer.phar
移動 composer.phar,這樣 composer 就可以進行全局調(diào)用:
# mv composer.phar /usr/local/bin/composer
切換為國內(nèi)鏡像:
composer config -g repo.packagist composer https://packagist.phpcomposer.com
更新 composer:
composer selfupdate
Mac OS 系統(tǒng)
Mac OS 系統(tǒng)可以使用以下命令來安裝:
$ curl -sS https://getcomposer.org/installer | php
$ sudo mv composer.phar /usr/local/bin/composer
$ composer --version
Composer version 1.7.2 2018-08-16 16:57:12
切換為國內(nèi)鏡像:
$ composer config -g repo.packagist composer https://packagist.phpcomposer.com
更新 composer:
$ composer selfupdate
Composer 的使用
要使用 Composer奋岁,我們需要先在項目的目錄下創(chuàng)建一個 composer.json 文件思瘟,文件描述了項目的依賴關(guān)系。
文件格式如下:
{
"require": {
"monolog/monolog": "1.2.*"
}
}
以上文件說明我們需要下載從 1.2 開始的任何版本的 monolog厦取。
接下來只要運行以下命令即可安裝依賴包
composer install
require 命令
除了使用 install 命令外潮太,我們也可以使用 require 命令快速的安裝一個依賴而不需要手動在 composer.json 里添加依賴信息:
$ composer require monolog/monolog
Composer 會先找到合適的版本,然后更新composer.json文件,在 require 那添加 monolog/monolog 包的相關(guān)信息铡买,再把相關(guān)的依賴下載下來進行安裝更鲁,最后更新 composer.lock 文件并生成 php 的自動加載文件。
update 命令
update 命令用于更新項目里所有的包奇钞,或者指定的某些包:
# 更新所有依賴
$ composer update
# 更新指定的包
$ composer update monolog/monolog
# 更新指定的多個包
$ composer update monolog/monolog symfony/dependency-injection
# 還可以通過通配符匹配包
$ composer update monolog/monolog symfony/*
需要注意的時澡为,包能升級的版本會受到版本約束的約束,包不會升級到超出約束的版本的范圍景埃。例如如果 composer.json 里包的版本約束為 ^1.10媒至,而最新版本為 2.0。那么 update 命令是不能把包升級到 2.0 版本的谷徙,只能最高升級到 1.x 版本拒啰。關(guān)于版本約束請看后面的介紹。
remove 命令
remove 命令用于移除一個包及其依賴(在依賴沒有被其他包使用的情況下)完慧,如果依賴被其他包使用谋旦,則無法移除:
$ composer remove monolog/monolog
Loading composer repositories with package information
Updating dependencies (including require-dev)
Package operations: 0 installs, 0 updates, 2 removals
- Removing psr/log (1.0.2)
- Removing monolog/monolog (1.23.0)
Generating autoload files
search 命令
search 命令可以搜索包:
$ composer search monolog
該命令會輸出包及其描述信息,如果只想輸出包名可以使用 --only-name 參數(shù):
$ composer search --only-name monolog
show 命令
show 命令可以列出當(dāng)前項目使用到包的信息:
# 列出所有已經(jīng)安裝的包
$ composer show
# 可以通過通配符進行篩選
$ composer show monolog/*
# 顯示具體某個包的信息
$ composer show monolog/monolog
基本約束
精確版本
我們可以告訴 Composer 安裝的具體版本屈尼,例如:1.0.2册着,指定 1.0.2 版本。
范圍
通過使用比較操作符來指定包的范圍脾歧。這些操作符包括:>甲捏,>=,<鞭执,<=司顿,!=。
你可以定義多個范圍蚕冬,使用空格或者逗號 , 表示邏輯上的與免猾,使用雙豎線 || 表示邏輯上的或是辕。其中與的優(yōu)先級會大于或囤热。 實例:
- (>=1.0)
- (>=1.0 <2.0)
- (>=1.0 <1.1 || >=1.2)
我們也可以通過使用連字符 - 來指定版本范圍。
連字符的左邊表明了 >= 的版本获三,如果右邊的版本不是完整的版本號旁蔼,則會被使用通配符進行補全。例如1.0 - 2.0等同于>=1.0.0 <2.1(2.0相當(dāng)于2.0.*)疙教,而1.0.0 - 2.1.0則等同于>=1.0.0 <=2.1.0棺聊。
通配符
可以使用通配符來設(shè)置版本。1.0.相當(dāng)于>=1.0 <1.1贞谓。
例子:1.0.
波浪號 ~
我們先通過后面這個例子去解釋~操作符的用法:~1.2
相當(dāng)于>=1.2 <2.0.0
限佩,而~1.2.3
相當(dāng)于>=1.2.3 <1.3.0
。對于使用Semantic Versioning
作為版本號標準的項目來說,這種版本約束方式很實用祟同。例如~1.2
定義了最小的小版本號作喘,然后你可以升級2.0以下的任何版本而不會出問題,因為按照Semantic Versioning
的版本定義晕城,小版本的升級不應(yīng)該有兼容性的問題泞坦。簡單來說,~
定義了最小的版本砖顷,并且允許版本的最后一位版本號進行升級(沒懂得話贰锁,請再看一邊前面的例子)。
例子:~1.2
需要注意的是滤蝠,如果作用在主版本號上豌熄,例如1,按照上面的說法物咳,Composer可以安裝版本1以后的主版本房轿,但是事實上是1會被當(dāng)作1.0對待,只能增加小版本所森,不能增加主版本囱持。
折音號 ^
^操作符的行為跟Semantic Versioning有比較大的關(guān)聯(lián),它允許升級版本到安全的版本焕济。例如纷妆,^1.2.3相當(dāng)于>=1.2.3 <2.0.0,因為在2.0版本前的版本應(yīng)該都沒有兼容性的問題晴弃。而對于1.0之前的版本掩幢,這種約束方式也考慮到了安全問題,例如^0.3會被當(dāng)作>=0.3.0 <0.4.0對待上鞠。
例子:^1.2.3
版本穩(wěn)定性
如果你沒有顯式的指定版本的穩(wěn)定性际邻,Composer會根據(jù)使用的操作符,默認在內(nèi)部指定為-dev或者-stable芍阎。例如:
約束 | 內(nèi)部約束 |
---|---|
1.2.3 | =1.2.3.0-stable |
>1.2 | >1.2.0.0-stable |
>=1.2 | >=1.2.0.0-dev |
>=1.2-stable | >=1.2.0.0-stable |
<1.3 | <1.3.0.0-dev |
<=1.3 | <=1.3.0.0-stable |
1 - 2 | >=1.0.0.0-dev <3.0.0.0-dev |
~1.3 | >=1.3.0.0-dev <2.0.0.0-dev |
1.4.* | >=1.4.0.0-dev <1.5.0.0-dev |
例子:1.0 - 2.0
如果你想指定版本只要穩(wěn)定版本世曾,你可以在版本后面添加后綴-stable
。
minimum-stability
配置項定義了包在選擇版本時對穩(wěn)定性的選擇的默認行為谴咸。默認是stable
轮听。它的值如下(按照穩(wěn)定性排序):dev
,alpha
岭佳,beta
血巍,RC
和stable
。除了修改這個配置去修改這個默認行為珊随,我們還可以通過穩(wěn)定性標識(例如@stable
和@dev
)來安裝一個相比于默認配置不同穩(wěn)定性的版本述寡。例如:
{
"require": {
"monolog/monolog": "1.0.*@beta",
"acme/foo": "@dev"
}
}