您好,歡迎來到創立網絡工作室官方網站!ZJJCL.CN
新聞動态
您現在的(de)位置:首頁 > 技術文摘
Composer 安裝與使用
來源:創立工作室 作者:馮軍 發布時間:2022-01-16 21:23:28 閱讀 1460 次

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

Composer 默認情況下不是全局安裝,而是基于指定的(de)項目的(de)某個目錄中(例如(rú) vendor)進行安裝。

Composer 需要 PHP 5.3.2+ 以上版本,且需要開啓 openssl。

Composer 可(kě)運行在 Windows 、 Linux 以及 OSX 平台上。

 


Composer 的(de)安裝

Wondows 平台

Wondows 平台上,我們隻需要下載 Composer-Setup.exe 後,一(yī)步步安裝即可(kě)。

需要注意的(de)是你需要開啓 openssl 配置,我們打開 php 目錄下的(de) php.ini,将 extension=php_openssl.dll 前面的(de)分号去(qù)掉就可(kě)以了。

安裝成功後,我們可(kě)以通過命令窗口(cmd) 輸入 composer --version 命令來查看是否安裝成功:

接下來我們可(kě)以更改阿裏雲 Composer 全量鏡像:

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

取消配置:

composer config -g --unset repos.packagist

項目配置

僅修改當前工程配置,僅當前工程可(kě)使用該鏡像地(dì)址:

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

取消配置:

composer config --unset repos.packagist

調試

composer 命令增加 -vvv 可(kě)輸出詳細的(de)信息,命令如(rú)下:

composer -vvv require alibabacloud/sdk

遇到問題?

1. 建議先将Composer版本升級到最新:

composer self-update

2. 執行診斷命令:

composer diagnose

3. 清除緩存:

composer clear

4. 若項目之前已通過其他源安裝,則需要更新 composer.lock 文件,執行命令:

composer update --lock

5. 重試一(yī)次

Linux 平台

Linux 平台可(kě)以使用以下命令來安裝:

# php -r "copy('https://install.phpcomposer.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,這樣 composer 就可(kě)以進行全局調用:

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

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

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

更新 composer:

# composer selfupdate

Mac OS 系統

Mac OS 系統可(kě)以使用以下命令來安裝:

$ 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)國內(nèi)鏡像:

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

更新 composer:

$ composer selfupdate

Composer 的(de)使用

要使用 Composer,我們需要先在項目的(de)目錄下創建一(yī)個 composer.json 文件,文件描述了項目的(de)依賴關系。

文件格式如(rú)下:

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

以上文件說明我們需要下載從 1.2 開始的(de)任何版本的(de) monolog。

接下來隻要運行以下命令即可(kě)安裝依賴包:

composer install

require 命令

除了使用 install 命令外,我們也可(kě)以使用 require 命令快速的(de)安裝一(yī)個依賴而不需要手動在 composer.json 裏添加依賴信息:

$ composer require monolog/monolog

Composer 會先找到合适的(de)版本,然後更新composer.json文件,在 require 那添加 monolog/monolog 包的(de)相關信息,再把相關的(de)依賴下載下來進行安裝,最後更新 composer.lock 文件并生成 php 的(de)自(zì)動加載文件。

update 命令

update 命令用于更新項目裏所有的(de)包,或者指定的(de)某些包:

# 更新所有依賴
$ composer update

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

# 更新指定的(de)多個包
$ composer update monolog/monolog symfony/dependency-injection

# 還可(kě)以通過通配符匹配包
$ composer update monolog/monolog symfony/*

需要注意的(de)時,包能升級的(de)版本會受到版本約束的(de)約束,包不會升級到超出約束的(de)版本的(de)範圍。例如(rú)如(rú)果 composer.json 裏包的(de)版本約束為(wèi) ^1.10,而最新版本為(wèi) 2.0。那麽 update 命令是不能把包升級到 2.0 版本的(de),隻能最高(gāo)升級到 1.x 版本。關于版本約束請看後面的(de)介紹。

remove 命令

remove 命令用于移除一(yī)個包及其依賴(在依賴沒有被其他包使用的(de)情況下),如(rú)果依賴被其他包使用,則無法移除:

$ 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

該命令會輸出包及其描述信息,如(rú)果隻想輸出包名可(kě)以使用 --only-name 參數:

$ composer search --only-name monolog

show 命令

show 命令可(kě)以列出當前項目使用到包的(de)信息:

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

# 可(kě)以通過通配符進行篩選
$ composer show monolog/*

# 顯示具體某個包的(de)信息
$ composer show monolog/monolog

基本約束

精确版本

我們可(kě)以告訴 Composer 安裝的(de)具體版本,例如(rú):1.0.2,指定 1.0.2 版本。

範圍

通過使用比較操作符來指定包的(de)範圍。這些操作符包括:>,>=,<,<=,!=

你可(kě)以定義多個範圍,使用空格或者逗号 , 表示邏輯上的(de)與,使用雙豎線 || 表示邏輯上的(de)或。其中與的(de)優先級會大于或。 實例:

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

我們也可(kě)以通過使用連字符 - 來指定版本範圍。

連字符的(de)左邊表明了 >= 的(de)版本,如(rú)果右邊的(de)版本不是完整的(de)版本号,則會被使用通配符進行補全。例如(rú)1.0 - 2.0等同于>=1.0.0 <2.12.0相當于2.0.*),而1.0.0 - 2.1.0則等同于>=1.0.0 <=2.1.0

通配符

可(kě)以使用通配符來設置版本。1.0.*相當于>=1.0 <1.1
例子(zǐ):1.0.*

波浪号 ~

我們先通過後面這個例子(zǐ)去(qù)解釋~操作符的(de)用法:~1.2相當于>=1.2 <2.0.0,而~1.2.3相當于>=1.2.3 <1.3.0。對于使用Semantic Versioning作為(wèi)版本号标準的(de)項目來說,這種版本約束方式很實用。例如(rú)~1.2定義了最小的(de)小版本号,然後你可(kě)以升級2.0以下的(de)任何版本而不會出問題,因為(wèi)按照Semantic Versioning的(de)版本定義,小版本的(de)升級不應該有兼容性的(de)問題。簡單來說,~定義了最小的(de)版本,并且允許版本的(de)最後一(yī)位版本号進行升級(沒懂得話,請再看一(yī)邊前面的(de)例子(zǐ))。
例子(zǐ):~1.2

需要注意的(de)是,如(rú)果~作用在主版本号上,例如(rú)~1,按照上面的(de)說法,Composer可(kě)以安裝版本1以後的(de)主版本,但是事實上是~1會被當作~1.0對待,隻能增加小版本,不能增加主版本。

折音号 ^

^操作符的(de)行為(wèi)跟Semantic Versioning有比較大的(de)關聯,它允許升級版本到安全的(de)版本。例如(rú),^1.2.3相當于>=1.2.3 <2.0.0,因為(wèi)在2.0版本前的(de)版本應該都沒有兼容性的(de)問題。而對于1.0之前的(de)版本,這種約束方式也考慮到了安全問題,例如(rú)^0.3會被當作>=0.3.0 <0.4.0對待。
例子(zǐ):^1.2.3


版本穩定性

如(rú)果你沒有顯式的(de)指定版本的(de)穩定性,Composer會根據使用的(de)操作符,默認在內(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ú)果你想指定版本隻要穩定版本,你可(kě)以在版本後面添加後綴-stable

 

minimum-stability 配置項定義了包在選擇版本時對穩定性的(de)選擇的(de)默認行為(wèi)。默認是stable。它的(de)值如(rú)下(按照穩定性排序):devalphabetaRC和(hé)stable。除了修改這個配置去(qù)修改這個默認行為(wèi),我們還可(kě)以通過穩定性标識(例如(rú)@stable和(hé)@dev)來安裝一(yī)個相比于默認配置不同穩定性的(de)版本。例如(rú):

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