Composer之常用命令和版本約束

下面由composer使用教程欄目為大家講解常用的包管理命令以及包的版本如何進(jìn)行約束,希望對(duì)需要的朋友有所幫助!

Composer之常用命令和版本約束

常用命令

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。例如:

Composer之常用命令和版本約束

如果你想指定版本只要穩(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" ????} }

以上是版本約束的介紹。

? 版權(quán)聲明
THE END
喜歡就支持一下吧
點(diǎn)贊8 分享