Composer 教程


閱讀(98.2k) 收藏 (6)

手冊(cè)簡(jiǎn)介

Composer是 PHP 用來(lái)管理依賴(lài)(dependency)關(guān)系的工具。本文介紹使用Composer的五個(gè)小技巧,希望能給你的PHP開(kāi)發(fā)帶來(lái)方便。

手冊(cè)說(shuō)明

Composer 教程

Composer是 PHP 用來(lái)管理依賴(lài)(dependency)關(guān)系的工具。你可以在自己的項(xiàng)目中聲明所依賴(lài)的外部工具庫(kù)(libraries),Composer 會(huì)幫你安裝這些依賴(lài)的庫(kù)文件。

本教程內(nèi)容來(lái)源于 Composer 中文網(wǎng)

英文官網(wǎng):https://getcomposer.org/

更新日期更新內(nèi)容
2015-04-30Composer 中文版

PHP 開(kāi)發(fā)者該知道的 5 個(gè) Composer 小技巧

Composer 是新一代的PHP依賴(lài)管理工具。其介紹和基本用法可以看這篇《Composer PHP依賴(lài)管理的新時(shí)代》。本文介紹使用Composer的五個(gè)小技巧,希望能給你的PHP開(kāi)發(fā)帶來(lái)方便。

1. 僅更新單個(gè)庫(kù)

只想更新某個(gè)特定的庫(kù),不想更新它的所有依賴(lài),很簡(jiǎn)單:

composer update foo/bar  

此外,這個(gè)技巧還可以用來(lái)解決“警告信息問(wèn)題”。你一定見(jiàn)過(guò)這樣的警告信息:

Warning: The lock file is not up to date with the latest changes in composer.json, you may be getting outdated dependencies, run update to update them.  

擦,哪里出問(wèn)題了?別驚慌!如果你編輯了composer.json,你應(yīng)該會(huì)看到這樣的信息。比如,如果你增加或更新了細(xì)節(jié)信息,比如庫(kù)的描述、作者、更多參數(shù),甚至僅僅增加了一個(gè)空格,都會(huì)改變文件的md5sum。然后Composer就會(huì)警告你哈希值和composer.lock中記載的不同。

那么我們?cè)撛趺崔k呢?update命令可以更新lock文件,但是如果僅僅增加了一些描述,應(yīng)該是不打算更新任何庫(kù)。這種情況下,只需update nothing:

$ composer update nothing
Loading composer repositories with package information  
Updating dependencies  
Nothing to install or update  
Writing lock file  
Generating autoload files  

這樣一來(lái),Composer不會(huì)更新庫(kù),但是會(huì)更新composer.lock。注意nothing并不是update命令的關(guān)鍵字。只是沒(méi)有nothing 這個(gè)包導(dǎo)致的結(jié)果。如果你輸入foobar,結(jié)果也一樣。

如果你用的Composer版本足夠新,那么你可以直接使用--lock選項(xiàng):

composer update --lock  

2. 不編輯composer.json的情況下安裝庫(kù)

你可能會(huì)覺(jué)得每安裝一個(gè)庫(kù)都需要修改composer.json太麻煩,那么你可以直接使用require命令。

composer require "foo/bar:1.0.0"  

這個(gè)方法也可以用來(lái)快速地新開(kāi)一個(gè)項(xiàng)目。init命令有--require選項(xiàng),可以自動(dòng)編寫(xiě)composer.json:(注意我們使用-n,這樣就不用回答問(wèn)題)

$ composer init --require=foo/bar:1.0.0 -n
$ cat composer.json
{
    "require": {
        "foo/bar": "1.0.0"
    }
}

3. 派生很容易

初始化的時(shí)候,你試過(guò)create-project命令么?

composer create-project doctrine/orm path 2.2.0  

這會(huì)自動(dòng)克隆倉(cāng)庫(kù),并檢出指定的版本??寺?kù)的時(shí)候用這個(gè)命令很方便,不需要搜尋原始的URI了。

4. 考慮緩存,dist包優(yōu)先

最近一年以來(lái)的Composer會(huì)自動(dòng)存檔你下載的dist包。默認(rèn)設(shè)置下,dist包用于加了tag的版本,例如"symfony/symfony": "v2.1.4",或者是通配符或版本區(qū)間,"2.1.*"或">=2.2,<2.3-dev"(如果你使用stable作為你的minimum-stability)。

dist包也可以用于諸如dev-master之類(lèi)的分支,Github允許你下載某個(gè)git引用的壓縮包。為了強(qiáng)制使用壓縮包,而不是克隆源代碼,你可以使用install和update的--prefer-dist選項(xiàng)。

下面是一個(gè)例子(我使用了--profile選項(xiàng)來(lái)顯示執(zhí)行時(shí)間):

$ composer init --require="twig/twig:1.*" -n --profile
Memory usage: 3.94MB (peak: 4.08MB), time: 0s

$ composer install --profile
Loading composer repositories with package information  
Installing dependencies  
  - Installing twig/twig (v1.12.2)
    Downloading: 100%

Writing lock file  
Generating autoload files  
Memory usage: 10.13MB (peak: 12.65MB), time: 4.71s

$ rm -rf vendor

$ composer install --profile
Loading composer repositories with package information  
Installing dependencies from lock file  
  - Installing twig/twig (v1.12.2)
    Loading from cache

Generating autoload files  
Memory usage: 4.96MB (peak: 5.57MB), time: 0.45s  

這里,twig/twig:1.12.2的壓縮包被保存在~/.composer/cache/files/twig/twig/1.12.2.0-v1.12.2.zip。重新安裝包時(shí)直接使用。

5. 若要修改,源代碼優(yōu)先

當(dāng)你需要修改庫(kù)的時(shí)候,克隆源代碼就比下載包方便了。你可以使用--prefer-source來(lái)強(qiáng)制選擇克隆源代碼。

composer update symfony/yaml --prefer-source  

接下來(lái)你可以修改文件:

composer status -v  
You have changes in the following dependencies:  
/path/to/app/vendor/symfony/yaml/Symfony/Component/Yaml:
    M Dumper.php

當(dāng)你試圖更新一個(gè)修改過(guò)的庫(kù)的時(shí)候,Composer會(huì)提醒你,詢(xún)問(wèn)是否放棄修改:

$ composer update
Loading composer repositories with package information  
Updating dependencies  
  - Updating symfony/symfony v2.2.0 (v2.2.0- => v2.2.0)
    The package has modified files:
    M Dumper.php
    Discard changes [y,n,v,s,?]?

為生產(chǎn)環(huán)境作準(zhǔn)備

最后提醒一下,在部署代碼到生產(chǎn)環(huán)境的時(shí)候,別忘了優(yōu)化一下自動(dòng)加載:

composer dump-autoload --optimize  

安裝包的時(shí)候可以同樣使用--optimize-autoloader。不加這一選項(xiàng),你可能會(huì)發(fā)現(xiàn)20%到25%的性能損失

如果你需要幫助,或者想要了解某個(gè)命令的細(xì)節(jié),你可以閱讀官方文檔或者中文文檔,也可以查看JoliCode做的這個(gè)交互式備忘單。

原文地址:5 features to know about Composer PHP譯文地址:PHP 開(kāi)發(fā)者該知道的 5 個(gè) Composer 小技巧

版本信息

書(shū)中演示代碼基于以下版本:

語(yǔ)言/框架版本信息
PHP5.3.2 以上


在線(xiàn)筆記
App下載
App下載

掃描二維碼

下載編程獅App

公眾號(hào)
微信公眾號(hào)

編程獅公眾號(hào)