Composer是一個(gè)非常流行的PHP包依賴管理工具,已經(jīng)取代PEAR包管理器,對于PHP開發(fā)者來說掌握Composer是必須的.

對于使用者來說Composer非常的簡單,通過簡單的一條命令將需要的代碼包下載到vendor目錄下,然后開發(fā)者就可以引入包并使用了.

其中的關(guān)鍵在于你項(xiàng)目定義的composer.json,可以定義項(xiàng)目需要依賴的包(可能有多個(gè)),而依賴的包可能又依賴其他的包(這就是組件的好處),這些都不用你煩心,Composer會(huì)自動(dòng)下載你需要的一切,一切在于composer.json的定義.

Composer對于使用者來說是很透明,但是其背后的理念還是需要了解一下的,其的誕生也不是偶然的,得益于Github的快速發(fā)展,PHP語言也越來越現(xiàn)代化,顯得更高大上了.

我的官方群點(diǎn)擊此處描滔。

為了理解Composer,先大概了解下其結(jié)構(gòu):

Composer的結(jié)構(gòu)

Composer命令行工具:

這個(gè)理解就比較簡單了,通過使用者定義的Composer.json去下載你需要的代碼,假如只是簡單的使用Composer,那么掌握一些具體命令就完全可以了

Autoloading代碼加載器:

通過Composer,開發(fā)者可以通過多種方式去使用,而其中的關(guān)鍵在于PHP的命名空間概念,以及PSR-4標(biāo)準(zhǔn)的發(fā)展,Composer只是根據(jù)這二者開發(fā)了一個(gè)代碼自動(dòng)加載器

Github:

有了Github,PHP開發(fā)人員可以將開源的代碼托管在這上面,而Composer的發(fā)展源于Github,Composer本質(zhì)上就是將Github上的代碼下載到本地.

Packagist:

對于使用者來說使用的是Composer的命令行工具,那么命令行工具怎么知道有多少包可以被用戶使用呢,這主要就是依賴于Packagist,Packagist是Composer主要的一個(gè)包信息存儲(chǔ)庫,包開發(fā)者將具體代碼托管到Github上,將包信息提交到Packagist上,這樣使用者就可以通過Composer去使用.

Composer根據(jù)本地定義的composer.json信息去查詢Packagist,Packagist根據(jù)Composer.json/Package.json信息解析,最終對應(yīng)到github倉庫,Composer最終下載代碼的時(shí)候還要依賴于Github倉庫上的Composer.json,這里涉及到三種類型的composer.json,含義是不一樣的.

Composer.json:

這是Composer的核心,是Composer的規(guī)則,上面也提到了三種類型的Composer.json,在使用的時(shí)候一定要注意區(qū)分,我初學(xué)的時(shí)候就總是搞亂.

Composer命令行工具

composer init

使用者可以在自己的項(xiàng)目下創(chuàng)建composer.json以便定義你項(xiàng)目的依賴包,也可以通過composer init交互式的創(chuàng)建composer.json.

composer install

應(yīng)該是最常用的命令,composer會(huì)根據(jù)本地的composer.json安裝包,將下載的包放入項(xiàng)目下的vendor目錄下,同時(shí)將安裝時(shí)候的包版本信息放入到composer.lock,以便鎖定版本.

其實(shí)在install的時(shí)候,假如發(fā)現(xiàn)composer.lock版本和目前vendor目錄下的代碼版本是一致的,則Composer會(huì)什么也不做,composer.lock的目的就是讓你安心在目前這個(gè)版本下工作,而不獲取最新版本的包.

composer update

那么如何更新composer.lock以便獲取到最新版本的包呢?通過這個(gè)命令即可更新最新版本的包

composer config

這個(gè)命令還是建議了解下,全局的配置保存在COMPOSER_HOME/config.json,非全局的配置信息則存儲(chǔ)在本項(xiàng)目目錄下.

composer config --list -g

composer config -g notify-on-install false

composer global config bin-dir --absolute

composer create-project

這個(gè)命令不常用,但是個(gè)人覺得還是很重要的,使用普通的install命令是將項(xiàng)目所有的依賴包下載到本項(xiàng)目vendor目錄下.而通過這個(gè)命令則是將所有的代碼及其依賴的包放到一個(gè)目錄下,相當(dāng)于執(zhí)行了一個(gè)git clone命令,一般是包的開發(fā)者可能為了修復(fù)bug會(huì)使用該命令.

composer global

這是一個(gè)全局的安裝命令,它允許你在COMPOSER_HOME目錄下執(zhí)行Composer的命令,比如install,update.當(dāng)然你的COMPOSER_HOME要在$PATH環(huán)境下.

比如執(zhí)行composer global require fabpot/php-cs-fixer,現(xiàn)在php-cs-fixer命令行可以全局運(yùn)行了,如果稍后想更新它,只需要運(yùn)行composer global update

composer dump-autoload

當(dāng)你修改項(xiàng)目下的composer.json的文件,并不一定要運(yùn)行composer update命令進(jìn)行更新,有的時(shí)候可以使用該命令來更新加載器,比如你要引用本地自定義的包(不是來自于packagist),后面會(huì)通過實(shí)踐來說明該命令.

composer require

假如手動(dòng)或者交互式創(chuàng)建composer.json文件,可以直接使用該命令來安裝包

composer require? cerdic/css-tidy:1.5.2

composer require "ywdblog/phpcomposer:dev-master"

–prefer-source和–prefer-dist參數(shù)

–prefer-dist:對于穩(wěn)定的包來說,一般Composer安裝默認(rèn)使用該參數(shù),這也能加快安裝,比如有可能直接從packagist安裝了相應(yīng)的包,而不用實(shí)際去Github上下載包.

–prefer-source:假如使用該參數(shù),則會(huì)直接從Github上安裝,安裝包后vendor目錄下還含有.git信息

composer require "ywdblog/phpcomposer:dev-master" --prefer-source

#在vendor/ywdblog/phpcomposer目錄下含有.git信息

如何給Composer添加代理

在國內(nèi)使用Composer下載特別慢,可以通過二個(gè)方法進(jìn)行加速

composer config repo.packagist composer “https://packagist.phpcomposer.com“

編輯composer.json

"repositories": {

? "packagist": {

? ? ? "type": "composer",

? ? ? "url": "https://packagist.phpcomposer.com"

? }

}

Autoloading代碼加載器

composer本身集成一個(gè)autoloader,支持PSR-4,PSR-0,classmap,files autoloading.

這里通過一個(gè)例子來說明通過Composer如何引用classmap,files,本地符合PSR-4標(biāo)準(zhǔn)的代碼

編輯composer.json

"autoload": {

? "classmap": ["othsrc/","classsrc.php"],

? "files": ["othsrc/filesrc.php"],

? "psr-4": {"Foo\Bar\": "src"}? }

composer dump-autoload

通過上述的操作,對于PSR-4來說等同注冊了一個(gè)PSR-4 autoloader(從FooBar命名空間)

假如不想使用Composer的autoloader,可以直接包含vendor/composer/autoload_*.php文件,配置自己的加載器.

具體的例子托管在github上,可參考.

Repositories

關(guān)于Repositories,了解其不是必須的,但是假如掌握則更能理解Composer,對于Repositories,其中文文檔和英文文檔解釋的很好,這里也進(jìn)行了一些摘抄.

基本概念

包:

Composer是一個(gè)依賴管理工具,它在本地安裝一些資源包和包的描述(比如包名稱和對應(yīng)的版本),比較重要的元數(shù)據(jù)描述是dist和source,dist指向一個(gè)存檔,該存檔是對一個(gè)資源包的某個(gè)版本的數(shù)據(jù)進(jìn)行的打包.source指向一個(gè)開發(fā)中的源,這通常是一個(gè)源代碼倉庫(比如git)

資源庫:

一個(gè)資源庫是一個(gè)包的來源.它是一個(gè)packages/versions的列表.

Composer將查看所有你定義的repositories以找到項(xiàng)目需要的資源包(這句話很重要).

默認(rèn)情況下已經(jīng)將http://Packagist.org注冊到Composer(或者理解為http://Packagist.org是Composer資源庫默認(rèn)的倉庫類型)

Composer資源庫類型

Composer資源庫包括四種類型,默認(rèn)的是composer類型,也就是http://packagist.org所使用的資源類型.

它使用一個(gè)單一的packages.json文件,包含了所有的資源包元數(shù)據(jù).當(dāng)你將包發(fā)布到http://pckagist.org上,則默認(rèn)系統(tǒng)會(huì)創(chuàng)建一個(gè)packages.json,不過我沒有找到我的包對應(yīng)的文件.

VCS資源庫類型

假如你想構(gòu)建一個(gè)私有的Composer私有資源庫類型,可以使用該類型,這里舉一個(gè)例子,比如你在自己項(xiàng)目的composer.json定義如下,則就可以使用對應(yīng)的Github上的代碼了.

{

? ? "repositories": [

? ? {

? ? ? ? "type": "vcs",

? ? ? ? "url": "https://github.com/ywdblog/phpcomposer"

? ? }

? ? ],

? ? "require": {

? ? ? ? "ywdblog/phpcomposer": "dev-master"

? ? }

}

當(dāng)運(yùn)行composer update的時(shí)候,Comoser實(shí)際上是從Github上下載包而不是從http://pckagist.org上下載.

另外假如需要使用Package資源庫類型或者PEAR資源庫類型,參考官方文檔即可,一般在composer.json中定義name得封、version屬性即可.

Composer.json

在本文上面也多次提到了composer.json,比如你希望使用第三方包則需要在本地定義composer.json,Composer安裝第三方包后,也會(huì)在第三方包目錄下發(fā)現(xiàn)composer.json,那么這二者都叫composer.json,有什么區(qū)別呢?理解這非常的重要.

假如你在自己的項(xiàng)目下面定義一個(gè)composer.json,則這個(gè)包稱之為ROOT包,這個(gè)composer.json定義你項(xiàng)目需要的條件(比如你的項(xiàng)目可能依賴一個(gè)第三方包).

composer.json中有些屬性只能被ROOT包使用,比如config屬性只在ROOT包中生效.

一個(gè)資源包是不是ROOT包,取決于它的上下文,比如你git clone ywdblog/phpcomposer,則這時(shí)候本地phpcomposer目錄就是ROOT包,假如你在本地phpcomposer目錄下composer require ywdblog/phpcomposer,則這時(shí)候你的項(xiàng)目phpcomposer就是ROOT包.

了解composer-schema.json可參考該網(wǎng)址,Laravel作為一個(gè)成熟的框架,其定義的composer.json非常經(jīng)典

關(guān)于包的版本

當(dāng)使用者在本地配置composer.json的時(shí)候,可以指定需要包的特定版本,Composer支持從Github倉庫中下載Tag或者分支下的包.

對于Github上的Tag來說,Packagist會(huì)創(chuàng)建對應(yīng)包的版本,它符合X.Y.Z,vX.Y.Z,X.Y.Z-包類型,就是說Github上雖然只有一個(gè)特定版本的包,但Composer支持多種形式的引用方式,比如:

composer require monolog/monolog? 1.0.0-RC1

composer require monolog/monolog? v1.0.0-RC1

composer require monolog/monolog? 1.0.*

composer require monolog/monolog? ~1.10

對于Github上的分支來說,Packagist會(huì)創(chuàng)建對應(yīng)包的版本,假如分支名看起來像一個(gè)版本,將創(chuàng)建{分支名}-dev的包版本號,如果分支名看起來不像一個(gè)版本號,它將會(huì)創(chuàng)建dev-{分支名}形式的版本號

總結(jié):

理解Composer,最重要的是實(shí)踐,最后也能明白PSR-4和命名空間,也可以嘗試將你的項(xiàng)目發(fā)布到http://pckagist.org上.

以上就是【Composer】PHP開發(fā)者必須了解垃杖！的詳細(xì)內(nèi)容

以上內(nèi)容希望幫助到大家胎许，很多PHPer在進(jìn)階的時(shí)候總會(huì)遇到一些問題和瓶頸奈辰，業(yè)務(wù)代碼寫多了沒有方向感栏妖，不知道該從那里入手去提升，對此我整理了一些資料奖恰，包括但不限于：分布式架構(gòu)吊趾、高可擴(kuò)展宛裕、高性能、高并發(fā)论泛、服務(wù)器性能調(diào)優(yōu)揩尸、TP6，laravel屁奏，YII2岩榆，Redis，Swoole坟瓢、Swoft朗恳、Kafka、Mysql優(yōu)化载绿、shell腳本粥诫、Docker、微服務(wù)崭庸、Nginx等多個(gè)知識點(diǎn)高級進(jìn)階干貨需要的可以免費(fèi)分享給大家怀浆，需要的可以加入我的官方群點(diǎn)擊此處。