Composer 安裝與使用

Composer 是 PHP 的一個依賴管理工具。我們可以在項目中聲明所依賴的外部工具庫，Composer 會幫你安裝這些依賴的庫文件，有了它，我們就可以很輕松的使用一個命令將其他人的優(yōu)秀代碼引用到我們的項目中來。

Composer 默認(rèn)情況下不是全局安裝，而是基于指定的項目的某個目錄中（例如 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 http://www.tjdsmy.cn

Linux 平臺

Linux 平臺可以使用以下命令來安裝：

# php -r "copy('http://www.tjdsmy.cn/installer', 'composer-setup.php');"# php composer-setup.phpAll settings correct for using ComposerDownloading...Composer (version 1.6.5) successfully installed to: /root/composer.pharUse it: php composer.phar

移動 composer.phar，這樣 composer 就可以進行全局調(diào)用：

# mv composer.phar /usr/local/bin/composer

切換為國內(nèi)鏡像：

# composer config -g repo.packagist composer http://www.tjdsmy.cn

更新 composer：

# composer selfupdate

Mac OS 系統(tǒng)

Mac OS 系統(tǒng)可以使用以下命令來安裝：

$ curl -sS http://www.tjdsmy.cn/installer | php$ sudo mv composer.phar /usr/local/bin/composer
$ composer --versionComposer version 1.7.2 2018-08-16 16:57:12

切換為國內(nèi)鏡像：

$ composer config -g repo.packagist composer http://www.tjdsmy.cn

更新 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/monologLoading composer repositories with package informationUpdating 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作為版本號標(biāo)準(zhǔn)的項目來說，這種版本約束方式很實用。例如~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ù)使用的操作符，默認(rèn)在內(nèi)部指定為-dev或者-stable。例如：

例子：1.0 - 2.0

如果你想指定版本只要穩(wěn)定版本，你可以在版本后面添加后綴-stable。

minimum-stability 配置項定義了包在選擇版本時對穩(wěn)定性的選擇的默認(rèn)行為。默認(rèn)是stable。它的值如下（按照穩(wěn)定性排序）：dev，alpha，beta，RC和stable。除了修改這個配置去修改這個默認(rèn)行為，我們還可以通過穩(wěn)定性標(biāo)識（例如@stable和@dev）來安裝一個相比于默認(rèn)配置不同穩(wěn)定性的版本。例如：

{
    "require": {
        "monolog/monolog": "1.0.*@beta",
        "acme/foo": "@dev"
    }}