Composer 簡介

簡介 中文文檔

Composer 是 PHP 的一個依賴管理工具。它允許你申明項目所依賴的代碼庫，它會在你的項目中為你安裝他們。

依賴管理

Composer 不是一個包管理器。是的，它涉及 "packages" 和 "libraries"，但它在每個項目的基礎上進行管理，在你項目的某個目錄中（例如 vendor）進行安裝。默認情況下它不會在全局安裝任何東西。因此，這僅僅是一個依賴管理。

這種想法并不新鮮，Composer 受到了 node's [npm][1] 和 ruby's [bundler][2] 的強烈啟發(fā)。而當時 PHP 下并沒有類似的工具。

Composer 將這樣為你解決問題：

a) 你有一個項目依賴于若干個庫。

b) 其中一些庫依賴于其他庫。

c) 你聲明你所依賴的東西。

d) Composer 會找出哪個版本的包需要安裝，并安裝它們（將它們下載到你的項目中）。

聲明依賴關系

比方說，你正在創(chuàng)建一個項目，你需要一個庫來做日志記錄。你決定使用 [monolog][3]。為了將它添加到你的項目中，你所需要做的就是創(chuàng)建一個 composer.json 文件，其中描述了項目的依賴關系。

{
    "require": {
        "monolog/monolog": "1.2.*"
    }
}

我們只要指出我們的項目需要一些 monolog/monolog 的包，從 1.2 開始的任何版本。

系統(tǒng)要求

運行 Composer 需要 PHP 5.3.2+ 以上版本。一些敏感的 PHP 設置和編譯標志也是必須的，但對于任何不兼容項安裝程序都會拋出警告。

我們將從包的來源直接安裝，而不是簡單的下載 zip 文件，你需要 git 、 svn 或者 hg ，這取決于你載入的包所使用的版本管理系統(tǒng)。

Composer 是多平臺的，我們努力使它在 Windows 、 Linux 以及 OSX 平臺上運行的同樣出色。

安裝 - *nix

下載 Composer 的可執(zhí)行文件

局部安裝

要真正獲取 Composer，我們需要做兩件事。首先安裝 Composer （同樣的，這意味著它將下載到你的項目中）：

curl -sS https://getcomposer.org/installer | php

注意： 如果上述方法由于某些原因失敗了，你還可以通過 php >下載安裝器：

php -r "readfile('https://getcomposer.org/installer');" | php

這將檢查一些 PHP 的設置，然后下載 composer.phar 到你的工作目錄中。這是 Composer 的二進制文件。這是一個 PHAR 包（PHP 的歸檔），這是 PHP 的歸檔格式可以幫助用戶在命令行中執(zhí)行一些操作。

你可以通過 \--install-dir 選項指定 Composer 的安裝目錄（它可以是一個絕對或相對路徑）：

curl -sS https://getcomposer.org/installer | php -- --install-dir=bin

全局安裝

你可以將此文件放在任何地方。如果你把它放在系統(tǒng)的 PATH 目錄中，你就能在全局訪問它。 在類Unix系統(tǒng)中，你甚至可以在使用時不加 php 前綴。

你可以執(zhí)行這些命令讓 composer 在你的系統(tǒng)中進行全局調(diào)用：

curl -sS https://getcomposer.org/installer | php
mv composer.phar /usr/local/bin/composer

注意： 如果上訴命令因為權(quán)限執(zhí)行失敗， 請使用 sudo 再次嘗試運行 mv 那行命令。

現(xiàn)在只需要運行 composer 命令就可以使用 Composer 而不需要輸入 php composer.phar。

全局安裝 (on OSX via homebrew)

Composer 是 homebrew-php 項目的一部分。

brew update
brew tap josegonzalez/homebrew-php
brew tap homebrew/versions
brew install php55-intl
brew install josegonzalez/php/composer

安裝 - Windows

使用安裝程序

這是將 Composer 安裝在你機器上的最簡單的方法。

下載并且運行 [Composer-Setup.exe][4]，它將安裝最新版本的 Composer ，并設置好系統(tǒng)的環(huán)境變量，因此你可以在任何目錄下直接使用 composer 命令。

手動安裝

設置系統(tǒng)的環(huán)境變量 PATH 并運行安裝命令下載 composer.phar 文件：

C:Usersusername>cd C:bin
C:bin>php -r "readfile('https://getcomposer.org/installer');" | php

注意： 如果收到 readfile 錯誤提示，請使用 http 鏈接或者在 php.ini 中開啟 php_openssl.dll 。

在 composer.phar 同級目錄下新建文件 composer.bat ：

C:bin>echo @php "%~dp0composer.phar" %*>composer.bat

關閉當前的命令行窗口，打開新的命令行窗口進行測試：

C:Usersusername>composer -V
Composer version 27d8904

使用 Composer

現(xiàn)在我們將使用 Composer 來安裝項目的依賴。如果在當前目錄下沒有一個 composer.json 文件，請查看[基本用法][5]章節(jié)。

要解決和下載依賴，請執(zhí)行 install 命令：

php composer.phar install

如果你進行了全局安裝，并且沒有 phar 文件在當前目錄，請使用下面的命令代替：

composer install

繼續(xù) 上面的例子，這里將下載 monolog 到 vendor/monolog/monolog 目錄。

自動加載

除了庫的下載，Composer 還準備了一個自動加載文件，它可以加載 Composer 下載的庫中所有的類文件。使用它，你只需要將下面這行代碼添加到你項目的引導文件中：

require 'vendor/autoload.php';

現(xiàn)在我們就可以使用 monolog 了！想要學習更多關于 Composer 的知識，請查看"基本用法"章節(jié)。