Composer 是(shì) PHP 的(de)一(yī)≈ 個(gè)依賴管理(lǐ)工(gōng)具。我們可 •"(kě)以在項目中聲明(míng)所依賴的(de)♦&外(wài)部工(gōng)具庫，Com&₹₩πposer 會(huì)幫你(nǐ)安裝這β$(zhè)些(xiē)依賴的(de)庫文(wén)件(jiàn)，有(yǒu)αβ←α了(le)它，我們就(jiù)可(kě)以很(hěn)輕松的(↓'$de)使用(yòng)一(yī)個(gè)命令将其他(tā)人(<×rén)的(de)優秀代碼引用(yòng)&Ω到(dào)我們的(de)項目中來(lái)。

Composer 默認情況下(xià)不(bù)是(s✔≈hì)全局安裝，而是(shì)基于指定的(‌ φ₹de)項目的(de)某個(gè)目錄中（例如(rú)π✘ vendor）進行(xíng)安裝。

Composer 需要(yào) PHP 5.3✔↑≠.2+ 以上(shàng)版本，且需要(yào)開(kāi₩☆α₩)啓 openssl。

Composer 可(kě)運行(xíng)在 Windows 、 Linux$δ"  以及 OSX 平台上(shàng)。

 

---

Composer 的(de)安裝

Wondows 平台

Wondows 平台上(shàng)，我們隻需要♠₩¥(yào)下(xià)載 Composer-Setup.exe 後，一(yī)步步安裝即可(kě)。

需要(yào)注意的(de)是(shì)你‍≈ ≈(nǐ)需要(yào)開(kāi)啓 open£₩↔ssl 配置，我們打開(kāi) php 目錄下(xià)的(deλ↔&€) php.ini，将 extension=php_openssl.dll 前面的(de)分(fēn)号去(qù)掉就(jiù)<♣可(kě)以了(le)。

安裝成功後，我們可(kě)以通(tōng)過命令窗(chuāng)₹ 口(cmd) 輸入 composer --version 命令來(lái)查看(kàn)是™ →←(shì)否安裝成功：

接下(xià)來(lái)我們可(kě)以更改阿裡(lǐ)σ∏↕φ雲 Composer 全量鏡像：

composer config -g repo.packagist composer https://mirrors.aliyun.com/ ↑composer/

取消配置：

composer config -g --unset repos.packagist

項目配置

僅修改當前工(gōng)程配置，僅當前工(gōng∑δ•")程可(kě)使用(yòng)該鏡像地(dì)址：

composer config repo.packagist composer https://mirrors.aliyun.com/composer/

取消配置：

composer config --unset repos.packagist

調試

composer 命令增加 -vvv 可(kě)輸出詳細的(de)信息©↕，命令如(rú)下(xià)：

composer -vvv require alibabacloud/sdk

遇到(dào)問(wèn)題？

1. 建議(yì)先将Composer版 ≥←本升級到(dào)最新：

composer self-update

2. 執行(xíng)診斷命令：

composer diagnose

3. 清除緩存：

composer clear

4. 若項目之前已通(tōng)過其他(tā)源安裝，則需要(yào)更新α€' composer.lock 文(wén)件✘‍¶(jiàn)，執行(xíng)命令：

composer update --lock

5. 重試一(yī)次

Linux 平台

Linux 平台可(kě)以使用(yòng)以♦₹∏↑下(xià)命令來(lái)安裝：

# php -r "copy('https:←γ£≈//install.phpcomposer.com/installer¶✘★↕', 'composer-setup.php');"


All settings correct for using Composer
Downloading...

Composer (version 1.6.5) successfully installe∞ ​d to: /root/composer.phar
Use it: php composer.phar

移動 composer.phar，這(zhè✔‍Ω₩)樣 composer 就(jiù)可(kě)以進行(×£ xíng)全局調用(yòng)：

# mv composer.phar /usr/loc™δal/bin/composer

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

# composer config -g rep↕↑×o.packagist composer https:✔© γ//mirrors.aliyun.com/composer/

更新 composer：

# composer selfupdate

Mac OS 系統

Mac OS 系統可(kě)以使用(yòng)以下(αγxià)命令來(lái)安裝：

$ 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

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

$ composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/λφ♠ 

更新 composer：

$ composer selfupdate

---

Composer 的(de)使用(yòng)

要(yào)使用(yòng) Composer，我σ  ✔們需要(yào)先在項目的(de)目錄下(xià♣ ®‌)創建一(yī)個(gè) composer"¥φ≈.json 文(wén)件(jiàn)，文("Ωwén)件(jiàn)描述了(le)項目的(de)依賴關系。

文(wén)件(jiàn)格式如(rú)下(xià)：

{
    "require": {
        "monolog/monolog": "1.2.*"
    }
}

以上(shàng)文(wén)件(jiàn)說(shu ®•πō)明(míng)我們需要(yào)下(xià)載從(cóng±≠) 1.2 開(kāi)始的(de)任何版本的(de) monol​±φγog。

接下(xià)來(lái)隻要(yào)運®↕ ±行(xíng)以下(xià)命令即可(kě)安€ 裝依賴包：

composer install

require 命令

除了(le)使用(yòng) install 命令外(wài)，我們↓↕β¶也(yě)可(kě)以使用(yòng) require 命令快(kuài)↓α速的(de)安裝一(yī)個(gè)依賴而不(bù)需要(yà↑£o)手動在 composer.json 裡(lǐ)添加依賴信息：

$ composer require monolog/monolog

Composer 會(huì)先找到(dào)合适的(de)版本，然後更新coγ£mposer.json文(wén)件(jiàn)，在 require 那(n¥<à)添加 monolog/monolog 包的(de)相(xiàng)關信息∑× §，再把相(xiàng)關的(de)依賴下(xià)載下(xià)來(l"∏α↔ái)進行(xíng)安裝，最後更新 composer.lock 文(wé±&n)件(jiàn)并生(shēng)成 php 的(de)自(←"• zì)動加載文(wén)件(jiàn)。

update 命令

update 命令用(yòng)于更新項目裡($∑&lǐ)所有(yǒu)的(de)包，或者指定的(de∏σφ‌)某些(xiē)包：

# 更新所有(yǒu)依賴
$ composer update

# 更新指定的(de)包
$ composer update monolog/monolog

# 更新指定的(de)多(duō)個(gè)包
$ composer update mon ∑ααolog/monolog symfony/dependency-injection

# 還(hái)可(kě)以通(tōng)過通​↔φ (tōng)配符匹配包
$ composer update monolog/monolog symfony/*

需要(yào)注意的(de)時(shí)↓Ω×☆，包能(néng)升級的(de)版本會(hu©£↑ì)受到(dào)版本約束的(de)約束，包不(bù)會(huì)升級到(&←Ω‍dào)超出約束的(de)版本的(de)範圍。例如(rú)>≥♦如(rú)果 composer.json 裡(lǐ)包的(de)‍φ©版本約束為(wèi) ^1.10，而最新版本為(wèi) 2.0 © 。那(nà)麽 update 命令是(shì)不(bù)能(néng≥δ")把包升級到(dào) 2.0 版本的(de)，隻能(néng)最高(gā€₽λo)升級到(dào) 1.x 版本。關于版本約束請(qǐng)看(kà∞♥€n)後面的(de)介紹。

remove 命令

remove 命令用(yòng)于移除一(yī)個(g$$©è)包及其依賴（在依賴沒有(yǒu)被其他(tā)包¥<使用(yòng)的(de)情況下(xià)），如(rú)果依賴φ≠®被其他(tā)包使用(yòng)，則無法移除：

$ 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 命令可(kě)以搜索包：

$ composer search monolog

該命令會(huì)輸出包及其描述信息，如(rú)果隻想輸出÷&÷包名可(kě)以使用(yòng) --only-name 參數(shù)：

$ composer search --only-name monolog

show 命令

show 命令可(kě)以列出當前項目使用(yòng)到(d "÷£ào)包的(de)信息：

# 列出所有(yǒu)已經安裝的(de)包
$ composer show

# 可(kě)以通(tōng)過通(tōng)配符進行(x‌'>íng)篩選
$ composer show monol∏∑∑↓og/*

# 顯示具體(tǐ)某個(gè)包的(d✘λe)信息
$ composer show ×ε≈×monolog/monolog

---

基本約束

精确版本

我們可(kě)以告訴 Composer 安裝的(de)具♦↑體(tǐ)版本，例如(rú)：1.0.2，指定 1.0.2 版本。

範圍

通(tōng)過使用(yòng)比較操作(zuò)符來(lái)指定♥¥•包的(de)範圍。這(zhè)些(xiē)操作(zuò)符包括：>，>=，<，<=→σ≠π，!=。

你(nǐ)可(kě)以定義多(duō)個(gè)範"•↔圍，使用(yòng)空(kōng)格或者逗号 ,€₹♦  表示邏輯上(shàng)的(de)與，使用(yòng)‍ 雙豎線 || 表示邏輯上(shàng)的(de)或。其中與的(de)優先級會♠↑↑♠(huì)大(dà)于或。 實例：

• >=1.0
• >=1.0 <2.0
• >=1.0 <1.1 || >=1.2

我們也(yě)可(kě)以通(tōng)過使>φ用(yòng)連字符 - 來(lái)指定版本範圍。

連字符的(de)左邊表明(míng)了(le)&n≈<®σbsp;>= 的(de)版本，如(rú)果右邊的<♦§(de)版本不(bù)是(shì)完整的(de)版本号，則會(huì)λ∏α♠被使用(yòng)通(tōng)配符進行(xíng)補全。例♦$如(rú)1.0 - 2.0等同于>=1.0.0 <2.1（2.0相(xiàng)當于2.0.*），而1.0.0 - 2.1.0則等同于>=1.0.0 <=2.1.0。

通(tōng)配符

可(kě)以使用(yòng)通(tōng)配符"♥♠×來(lái)設置版本。1.0.*相(xiàng)當于>=1.0 <1.1。
例子(zǐ)：1.0.*

波浪号 ~

我們先通(tōng)過後面這(zhè)個(g≈÷è)例子(zǐ)去(qù)解釋~操作(zuò)符的©♥✘(de)用(yòng)法：~1.2相(xiàng)當于>=1.2 <2.0.0，而~1.2.3相(xiàng)當于>=1.2.3 <1.3.0。對(duì)于使用(yòng)Semantic Versioning作(zuò)為(wèi)版本号标準的(d☆✘∞e)項目來(lái)說(shuō)，這(zhè)ε←↕種版本約束方式很(hěn)實用(yòng)。例如(rú)~1.2定義了(le)最小(xiǎo)的(de)小( £₽÷xiǎo)版本号，然後你(nǐ)可(kě)β↔•★以升級2.0以下(xià)的(de)任何版本而不(bù)會(huì₽♣↓)出問(wèn)題，因為(wèi)按照(zhào©£)Semantic Versioning的(de)版本定義，小(xiǎo)版本的(®♠de)升級不(bù)應該有(yǒu)兼容性的(dβ≈‍€e)問(wèn)題。簡單來(lái)說(shuō)，~定義了(le)最小(xiǎo)的(de)版本，并且允許版本的(d≥ e)最後一(yī)位版本号進行(xíng)升級（沒懂(dǒng↕δ¥)得(de)話(huà)，請(qǐng)再看(k ♦àn)一(yī)邊前面的(de)例子(zǐ)）。
例子(zǐ)：~1.2

需要(yào)注意的(de)是(shì)，如(rú)果÷™•~作(zuò)用(yòng)在主版本号上(shàng)，例如(r¶‌ú)~1，按照(zhào)上(shàng)面的(de)說•★∑π(shuō)法，Composer可(kě)以安裝版本↕™<ε1以後的(de)主版本，但(dàn)是(shì)事(shì)實 ☆σ 上(shàng)是(shì)~1會(huì)被當作(zuò)~1.0對(duì)待，隻能(néng)增加小(xiǎo)版本，不(bù☆Ω)能(néng)增加主版本。

折音(yīn)号 ^

^操作(zuò)符的(de)行(xíng)為✘<↓(wèi)跟Semantic Versioning有(yǒu)比較大(dà)的(de)關聯，它允×₩許升級版本到(dào)安全的(de)版本。例如(rú)，^1.2.3相(xiàng)當于>=1.2.3 <2.0.0，因為(wèi)在2.0版本前的(de)版本應該都(d✔×♥ōu)沒有(yǒu)兼容性的(de)問(wèn)題。而對(duì)于♥₩∏1.0之前的(de)版本，這(zhè)種約束方式也(yě₹')考慮到(dào)了(le)安全問(wèn)題，例如(rú)^0.3會(huì)被當作(zuò)>=0.3.0 <0.4.0對(duì)待。
例子(zǐ)：^1.2.3

---

版本穩定性

如(rú)果你(nǐ)沒有(yǒu)顯式的(de)指定版本的(de)穩 ÷δ≠定性，Composer會(huì)根據使用(yòng)的(de)操作​£ (zuò)符，默認在內(nèi)部指定為(wèi)-dev或者-stable。例如(rú)：

約束	內(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-d✔ ✘$ev
1.4.*	>=1.4.0.0-dev <1.5.0.0-dev

例子(zǐ)：1.0 - 2.0

 

如(rú)果你(nǐ)想指定版本隻要(yào)穩定版本，你(nǐ)可(≤Ωkě)以在版本後面添加後綴-stable。

 

minimum-stability 配置項定義了(le)包在選擇版™<¶本時(shí)對(duì)穩定性的(de)選擇的(de)默認行(xíng✔£)為(wèi)。默認是(shì)stable。它的(de)值如(rú)下(xià)（←€按照(zhào)穩定性排序）：dev，alpha，beta，RC和(hé)stable。除了(le)修改這(zhè)個(gè)配置去(qù)修改這(γ÷★zhè)個(gè)默認行(xíng)為(wèi)，我們還(hái ÷±)可(kě)以通(tōng)過穩定性标識（例如(rú)@stable和(hé)@dev）來(lái)安裝一(yī)個(gè)相Ω™↕(xiàng)比于默認配置不(bù)同穩定性的(de)版本。例如(r ♥¶ú)：

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