Composer 教程

Composer 教程

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

本教程內容來源于 Composer 中文網

英文官網：https://getcomposer.org/

PHP 開發者該知道的 5 個 Composer 小技巧

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

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，你應該會看到這樣的信息。比如，如果你增加或更新了細節信息，比如庫的描述、作者、更多參數，甚至僅僅增加了一個空格，都會改變文件的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包優先

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

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

下面是一個例子（我使用了--profile選項來顯示執行時間）：

$ 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. 若要修改，源代碼優先

當你需要修改庫的時候，克隆源代碼就比下載包方便了。你可以使用--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,?]?

為生產環境作準備

最后提醒一下，在部署代碼到生產環境的時候，別忘了優化一下自動加載：

composer dump-autoload --optimize  

安裝包的時候可以同樣使用--optimize-autoloader。不加這一選項，你可能會發現20%到25%的性能損失。

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

原文地址：5 features to know about Composer PHP譯文地址：PHP 開發者該知道的 5 個 Composer 小技巧

版本信息

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