Composer 教程


閱讀(97.2k) 收藏 (6)

手冊簡介

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

手冊說明

Composer 教程

Composer是 PHP 用來管理依賴(dependency)關系的工具。你可以在自己的項目中聲明所依賴的外部工具庫(libraries),Composer 會幫你安裝這些依賴的庫文件。

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

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

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

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

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

1. 僅更新單個庫

只想更新某個特定的庫,不想更新它的所有依賴,很簡單:

composer update foo/bar  

此外,這個技巧還可以用來解決“警告信息問題”。你一定見過這樣的警告信息:

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.  

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

那么我們該怎么辦呢?update命令可以更新lock文件,但是如果僅僅增加了一些描述,應該是不打算更新任何庫。這種情況下,只需update nothing:

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

這樣一來,Composer不會更新庫,但是會更新composer.lock。注意nothing并不是update命令的關鍵字。只是沒有nothing 這個包導致的結果。如果你輸入foobar,結果也一樣。

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

composer update --lock  

2. 不編輯composer.json的情況下安裝庫

你可能會覺得每安裝一個庫都需要修改composer.json太麻煩,那么你可以直接使用require命令。

composer require "foo/bar:1.0.0"  

這個方法也可以用來快速地新開一個項目。init命令有--require選項,可以自動編寫composer.json:(注意我們使用-n,這樣就不用回答問題)

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

3. 派生很容易

初始化的時候,你試過create-project命令么?

composer create-project doctrine/orm path 2.2.0  

這會自動克隆倉庫,并檢出指定的版本??寺斓臅r候用這個命令很方便,不需要搜尋原始的URI了。

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

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

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

下面是一個例子(我使用了--profile選項來顯示執(zhí)行時間):

$ 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。重新安裝包時直接使用。

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

當你需要修改庫的時候,克隆源代碼就比下載包方便了。你可以使用--prefer-source來強制選擇克隆源代碼。

composer update symfony/yaml --prefer-source  

接下來你可以修改文件:

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

當你試圖更新一個修改過的庫的時候,Composer會提醒你,詢問是否放棄修改:

$ 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)境作準備

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

composer dump-autoload --optimize  

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

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

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

版本信息

書中演示代碼基于以下版本:

語言/框架版本信息
PHP5.3.2 以上


更新記錄

在線筆記
App下載
App下載

掃描二維碼

下載編程獅App

公眾號
微信公眾號

編程獅公眾號