Composer 是(shì) PHP 的(de)一→☆(yī)個(gè)依賴管理(lǐ)工(gōng)具。我們可(kě)以'​∞γ在項目中聲明(míng)所依賴的(de)外(wài)部'ε工(gōng)具庫，Composer 會(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ù)是(shì)全局安裝，而是(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)在 Wind£₹εows 、 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)啓 openssl 配置，我↑↑們打開(kāi) php 目錄下(xià)的(de) php.in >γ<i，将 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.lo$•÷λck 文(wén)件(jiàn)，執行(xíng)∏ε命令：

composer update --lock

5. 重試一(yī)次

Linux 平台

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

# php -r "copy('https://install.phpcompos‍÷er.com/installer', '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，這(zh¶§±γè)樣 composer 就(jiù)可(k↔≠↑€ě)以進行(xíng)全局調用(yòngπ₽☆♥)：

# mv composer.phar /u₽§δsr/local/bin/compose•δr

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

# composer config -g reφβ ≥po.packagist composer https://mirror↕Ω→s.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/co∏‌mposer/

更新 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) monolog。

接下(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)版本，然後更¥₹¶新composer.json文(wén)件‍>(jiàn)，在 require 那(nà)添加 monolog/mo← ≠€nolog 包的(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 monolog/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ú)果 compos∑<er.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)&nΩ↓←​bsp;--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 monolog/*

# 顯示具體(tǐ)某個(gè)包的(de)信息
$ com ™poser 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) >= 的(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ò)符的(d♥≠‌e)用(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)版本号标準的(de)項目來(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)兼容性的(de)問(wèn)題。簡單σ₩來(lái)說(shuō)，~定義了(le)最小(xiǎo)的(de)版本，并且允許♠£☆版本的(de)最後一(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-dev
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"
    }
}