php开发者与composer的不得不说故事
Composer是一個(gè)非常流行的PHP包依賴管理工具,已經(jīng)取代PEAR包管理器,對(duì)于PHP開(kāi)發(fā)者來(lái)說(shuō)掌握Composer是必須的.
對(duì)于使用者來(lái)說(shuō)Composer非常的簡(jiǎn)單,通過(guò)簡(jiǎn)單的一條命令將需要的代碼包下載到vendor目錄下,然后開(kāi)發(fā)者就可以引入包并使用了.
其中的關(guān)鍵在于你項(xiàng)目定義的composer.json,可以定義項(xiàng)目需要依賴的包(可能有多個(gè)),而依賴的包可能又依賴其他的包(這就是組件的好處),這些都不用你煩心,Composer會(huì)自動(dòng)下載你需要的一切,一切在于composer.json的定義.
Composer對(duì)于使用者來(lái)說(shuō)是很透明,但是其背后的理念還是需要了解一下的,其的誕生也不是偶然的,得益于Github的快速發(fā)展,PHP語(yǔ)言也越來(lái)越現(xiàn)代化,顯得更高大上了.
為了理解Composer,先大概了解下其結(jié)構(gòu):
Composer的結(jié)構(gòu)
- Composer命令行工具:
這個(gè)理解就比較簡(jiǎn)單了,通過(guò)使用者定義的Composer.json去下載你需要的代碼,假如只是簡(jiǎn)單的使用Composer,那么掌握一些具體命令就完全可以了 - Autoloading代碼加載器:
通過(guò)Composer,開(kāi)發(fā)者可以通過(guò)多種方式去使用,而其中的關(guān)鍵在于PHP的命名空間概念,以及PSR-4標(biāo)準(zhǔn)的發(fā)展,Composer只是根據(jù)這二者開(kāi)發(fā)了一個(gè)代碼自動(dòng)加載器 - Github:
有了Github,PHP開(kāi)發(fā)人員可以將開(kāi)源的代碼托管在這上面,而Composer的發(fā)展源于Github,Composer本質(zhì)上就是將Github上的代碼下載到本地. - Packagist:
對(duì)于使用者來(lái)說(shuō)使用的是Composer的命令行工具,那么命令行工具怎么知道有多少包可以被用戶使用呢,這主要就是依賴于Packagist,Packagist是Composer主要的一個(gè)包信息存儲(chǔ)庫(kù),包開(kāi)發(fā)者將具體代碼托管到Github上,將包信息提交到Packagist上,這樣使用者就可以通過(guò)Composer去使用.
Composer根據(jù)本地定義的composer.json信息去查詢Packagist,Packagist根據(jù)Composer.json/Package.json信息解析,最終對(duì)應(yīng)到github倉(cāng)庫(kù),Composer最終下載代碼的時(shí)候還要依賴于Github倉(cāng)庫(kù)上的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)目的依賴包,也可以通過(guò)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以便獲取到最新版本的包呢?通過(guò)這個(gè)命令即可更新最新版本的包
composer config
這個(gè)命令還是建議了解下,全局的配置保存在COMPOSER_HOME/config.json,非全局的配置信息則存儲(chǔ)在本項(xiàng)目目錄下.
| 1 2 3 | composer config --list -g composer config -g notify-on-install false composer global config bin-dir --absolute |
composer create-project
這個(gè)命令不常用,但是個(gè)人覺(jué)得還是很重要的,使用普通的install命令是將項(xiàng)目所有的依賴包下載到本項(xiàng)目vendor目錄下.而通過(guò)這個(gè)命令則是將所有的代碼及其依賴的包放到一個(gè)目錄下,相當(dāng)于執(zhí)行了一個(gè)git clone命令,一般是包的開(kāi)發(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í)候可以使用該命令來(lái)更新加載器,比如你要引用本地自定義的包(不是來(lái)自于packagist),后面會(huì)通過(guò)實(shí)踐來(lái)說(shuō)明該命令.
composer require
假如手動(dòng)或者交互式創(chuàng)建composer.json文件,可以直接使用該命令來(lái)安裝包
| 1 2 | composerrequire??cerdic/css-tidy:1.5.2 composerrequire"ywdblog/phpcomposer:dev-master" |
–prefer-source和–prefer-dist參數(shù)
–prefer-dist:對(duì)于穩(wěn)定的包來(lái)說(shuō),一般Composer安裝默認(rèn)使用該參數(shù),這也能加快安裝,比如有可能直接從packagist安裝了相應(yīng)的包,而不用實(shí)際去Github上下載包.
–prefer-source:假如使用該參數(shù),則會(huì)直接從Github上安裝,安裝包后vendor目錄下還含有.git信息
| 1 2 | composer require "ywdblog/phpcomposer:dev-master" --prefer-source #在vendor/ywdblog/phpcomposer目錄下含有.git信息 |
如何給Composer添加代理
在國(guó)內(nèi)使用Composer下載特別慢,可以通過(guò)二個(gè)方法進(jìn)行加速
- composer config repo.packagist composer “https://packagist.phpcomposer.com“
- 編輯composer.json
1 2 3 4 5 6 "repositories":{ ??"packagist":{ ??????"type":"composer", ??????"url":"https://packagist.phpcomposer.com" ??} } Autoloading代碼加載器
composer本身集成一個(gè)autoloader,支持PSR-4,PSR-0,classmap,files autoloading.
這里通過(guò)一個(gè)例子來(lái)說(shuō)明通過(guò)Composer如何引用classmap,files,本地符合PSR-4標(biāo)準(zhǔn)的代碼
- 編輯composer.json
1 2 3 4 5 "autoload": { ??"classmap": ["othsrc/","classsrc.php"], ??"files": ["othsrc/filesrc.php"], ??"psr-4": {"Foo\Bar\": "src"} } - composer dump-autoload
通過(guò)上述的操作,對(duì)于PSR-4來(lái)說(shuō)等同注冊(cè)了一個(gè)PSR-4 autoloader(從FooBar命名空間)
假如不想使用Composer的autoloader,可以直接包含vendor/composer/autoload_*.php文件,配置自己的加載器.
具體的例子托管在github上,可參考.Repositories
關(guān)于Repositories,了解其不是必須的,但是假如掌握則更能理解Composer,對(duì)于Repositories,其中文文檔和英文文檔解釋的很好,這里也進(jìn)行了一些摘抄.
基本概念
包:
Composer是一個(gè)依賴管理工具,它在本地安裝一些資源包和包的描述(比如包名稱和對(duì)應(yīng)的版本),比較重要的元數(shù)據(jù)描述是dist和source,dist指向一個(gè)存檔,該存檔是對(duì)一個(gè)資源包的某個(gè)版本的數(shù)據(jù)進(jìn)行的打包.source指向一個(gè)開(kāi)發(fā)中的源,這通常是一個(gè)源代碼倉(cāng)庫(kù)(比如git)資源庫(kù):
一個(gè)資源庫(kù)是一個(gè)包的來(lái)源.它是一個(gè)packages/versions的列表.
Composer將查看所有你定義的repositories以找到項(xiàng)目需要的資源包(這句話很重要).
默認(rèn)情況下已經(jīng)將Packagist.org注冊(cè)到Composer(或者理解為Packagist.org是Composer資源庫(kù)默認(rèn)的倉(cāng)庫(kù)類型)Composer資源庫(kù)類型
Composer資源庫(kù)包括四種類型,默認(rèn)的是composer類型,也就是packagist.org所使用的資源類型.
它使用一個(gè)單一的packages.json文件,包含了所有的資源包元數(shù)據(jù).當(dāng)你將包發(fā)布到pckagist.org上,則默認(rèn)系統(tǒng)會(huì)創(chuàng)建一個(gè)packages.json,不過(guò)我沒(méi)有找到我的包對(duì)應(yīng)的文件.VCS資源庫(kù)類型
假如你想構(gòu)建一個(gè)私有的Composer私有資源庫(kù)類型,可以使用該類型,這里舉一個(gè)例子,比如你在自己項(xiàng)目的composer.json定義如下,則就可以使用對(duì)應(yīng)的Github上的代碼了.1 2 3 4 5 6 7 8 9 10 11 { ????"repositories":[ ????{ ????????"type":"vcs", ????????"url":"http://www.renti51.cn" ????} ????], ????"require":{ ????????"ywdblog/phpcomposer":"dev-master" ????} } 當(dāng)運(yùn)行composer update的時(shí)候,Comoser實(shí)際上是從Github上下載包而不是從pckagist.org上下載.
另外假如需要使用Package資源庫(kù)類型或者PEAR資源庫(kù)類型,參考官方文檔即可,一般在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倉(cāng)庫(kù)中下載Tag或者分支下的包.對(duì)于Github上的Tag來(lái)說(shuō),Packagist會(huì)創(chuàng)建對(duì)應(yīng)包的版本,它符合X.Y.Z,vX.Y.Z,X.Y.Z-包類型,就是說(shuō)Github上雖然只有一個(gè)特定版本的包,但Composer支持多種形式的引用方式,比如:
1 2 3 4 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 對(duì)于Github上的分支來(lái)說(shuō),Packagist會(huì)創(chuàng)建對(duì)應(yīng)包的版本,假如分支名看起來(lái)像一個(gè)版本,將創(chuàng)建{分支名}-dev的包版本號(hào),如果分支名看起來(lái)不像一個(gè)版本號(hào),它將會(huì)創(chuàng)建dev-{分支名}形式的版本號(hào)
1 2 composerrequiremonolog/monolog??master-dev composerrequiremonolog/monolog??master.x-dev ?
總結(jié):
理解Composer,最重要的是實(shí)踐,最后也能明白PSR-4和命名空間,也可以嘗試將你的項(xiàng)目發(fā)布到pckagist.org上.
來(lái)自:http://www.girl4493.cn
- 編輯composer.json
轉(zhuǎn)載于:https://www.cnblogs.com/yangjiyue/p/7978331.html
總結(jié)
以上是生活随笔為你收集整理的php开发者与composer的不得不说故事的全部?jī)?nèi)容，希望文章能夠幫你解決所遇到的問(wèn)題。
- 上一篇： 级数求和
- 下一篇： ●BZOJ 4556 [Tjoi2016