下面由composer使用教程欄目為大家講解常用的包管理命令以及包的版本如何進(jìn)行約束,希望對(duì)需要的朋友有所幫助!
常用命令
require命令
在《composer使用教程》中已經(jīng)簡(jiǎn)單介紹過(guò)使用install命令安裝依賴的方式。除了install命令,我們還可以使用require命令快速的安裝一個(gè)依賴而不需要手動(dòng)在composer.json里添加依賴信息:
$?composer?require?monolog/monolog Using?version?^1.19?for?monolog/monolog ./composer.json?has?been?updated Loading?composer?repositories?with?package?information Updating?dependencies?(including?require-dev) ??-?Installing?psr/log?(1.0.0) ????Downloading:?100%????????? ? ??-?Installing?monolog/monolog?(1.19.0) ????Downloading:?100%????????? ? monolog/monolog?suggests?installing?graylog2/gelf-php?(Allow?sending?log?messages?to?a?GrayLog2?server) ...... monolog/monolog?suggests?installing?php-console/php-console?(Allow?sending?log?messages?to?Google?Chrome) Writing?lock?file Generating?autoload?files
Composer會(huì)先找到合適的版本,然后更新composer.json文件,在require那添加monolog/monolog包的相關(guān)信息,再把相關(guān)的依賴下載下來(lái)進(jìn)行安裝,最后更新composer.lock文件并生成php的自動(dòng)加載文件。
update命令
通過(guò)update命令,可以更新項(xiàng)目里所有的包,或者指定的某些包。
#?更新所有依賴 $?composer?update ? #?更新指定的包 $?composer?update?monolog/monolog ? #?更新指定的多個(gè)包 $?composer?update?monolog/monolog?symfony/dependency-injection ? #?還可以通過(guò)通配符匹配包 $?composer?update?monolog/monolog?symfony/*
需要注意的時(shí),包能升級(jí)的版本會(huì)受到版本約束的約束,包不會(huì)升級(jí)到超出約束的版本的范圍。例如如果composer.json里包的版本約束為^1.10,而最新版本為2.0。那么update命令是不能把包升級(jí)到2.0版本的,只能最高升級(jí)到1.x版本。關(guān)于版本約束請(qǐng)看后面的介紹。
remove命令
使用remove命令可以移除一個(gè)包及其依賴(在依賴沒(méi)有被其他包使用的情況下):
$?composer?remove?monolog/monolog Loading?composer?repositories?with?package?information Updating?dependencies?(including?require-dev) ??-?Removing?monolog/monolog?(1.19.0) ??-?Removing?psr/log?(1.0.0) Writing?lock?file Generating?autoload?files
search命令
使用search命令可以進(jìn)行包的搜索:
$?composer?search?monolog monolog/monolog?Sends?your?logs?to?files,?sockets,?inboxes,?databases?and?various?web?services ? #?如果只是想匹配名稱可以使用--only-name選項(xiàng) $?composer?search?--only-name?monolog
show命令
使用show命令可以列出項(xiàng)目目前所安裝的包的信息:
#?列出所有已經(jīng)安裝的包 $?composer?show ? #?可以通過(guò)通配符進(jìn)行篩選 $?composer?show?monolog/* ? #?顯示具體某個(gè)包的信息 $?composer?show?monolog/monolog
以上是常用命令的介紹。
版本約束
前面說(shuō)到,我們可以指定要下載的包的版本。例如我們想要下載版本1.19的monolog。我們可以通過(guò)composer.json文件:
{ ????"require":?{ ????????"monolog/monolog":?"1.19" ????} }
然后運(yùn)行install命令,或者通過(guò)require命令達(dá)到目的:
$?composer?require?monolog/monolog:1.19 ? #?或者 $?composer?require?monolog/monolog=1.19 ? #?或者 $composer?require?monolog/monolog?1.19
除了像上面那樣指定具體的版本,我們還可以通過(guò)不同的約束方式去指定版本。
基本約束
精確版本
可以指定具體的版本,告訴Composer只能安裝這個(gè)版本。但是如果其他的依賴需要用到其他的版本,則包的安裝或者更新最后會(huì)失敗并終止。
例子:1.0.2
范圍
使用比較操作符你可以指定包的范圍。這些操作符包括:>,>=,
你可以定義多個(gè)范圍,使用空格 或者逗號(hào),表示邏輯上的與,使用雙豎線||表示邏輯上的或。其中與的優(yōu)先級(jí)會(huì)大于或。
需要注意的是,使用沒(méi)有邊界的范圍有可能會(huì)導(dǎo)致安裝不可預(yù)知的版本,并破壞向下的兼容性。建議使用折音號(hào)操作符。
例子:
>=1.0 >=1.0?=1.0?=1.2
范圍(使用連字符)
帶連字符的范圍表明了包含的版本范圍,意味著肯定是有邊界的。其中連字符的左邊表明了>=的版本,而連字符的右邊情況則稍微有點(diǎn)復(fù)雜。如果右邊的版本不是完整的版本號(hào),則會(huì)被使用通配符進(jìn)行補(bǔ)全。例如1.0 – 2.0等同于>=1.0.0 =1.0.0
例子:1.0 – 2.0
通配符
可以使用通配符去定義版本。1.0.*相當(dāng)于>=1.0
例子:1.0.*
下一個(gè)重要版本操作符
波浪號(hào)~
我們先通過(guò)后面這個(gè)例子去解釋~操作符的用法:~1.2相當(dāng)于>=1.2 =1.2.3
例子:~1.2
需要注意的是,如果~作用在主版本號(hào)上,例如~1,按照上面的說(shuō)法,Composer可以安裝版本1以后的主版本,但是事實(shí)上是~1會(huì)被當(dāng)作~1.0對(duì)待,只能增加小版本,不能增加主版本。
折音號(hào)^
^操作符的行為跟Semantic Versioning有比較大的關(guān)聯(lián),它允許升級(jí)版本到安全的版本。例如,^1.2.3相當(dāng)于>=1.2.3 =0.3.0
例子:^1.2.3
版本穩(wěn)定性
如果你沒(méi)有顯式的指定版本的穩(wěn)定性,Composer會(huì)根據(jù)使用的操作符,默認(rèn)在內(nèi)部指定為-dev或者-stable。例如:
如果你想指定版本只要穩(wěn)定版本,你可以在版本后面添加后綴-stable。
minimum-stability 配置項(xiàng)定義了包在選擇版本時(shí)對(duì)穩(wěn)定性的選擇的默認(rèn)行為。默認(rèn)是stable。它的值如下(按照穩(wěn)定性排序):dev,alpha,beta,RC和stable。除了修改這個(gè)配置去修改這個(gè)默認(rèn)行為,我們還可以通過(guò)穩(wěn)定性標(biāo)識(shí)(例如@stable和@dev)來(lái)安裝一個(gè)相比于默認(rèn)配置不同穩(wěn)定性的版本。例如:
{ ????"require":?{ ????????"monolog/monolog":?"1.0.*@beta", ????????"acme/foo":?"@dev" ????} }
以上是版本約束的介紹。