Composer 簡(jiǎn)介

簡(jiǎn)介 中文文檔

Composer 是 PHP 的一個(gè)依賴管理工具。它允許你申明項(xiàng)目所依賴的代碼庫，它會(huì)在你的項(xiàng)目中為你安裝他們。

依賴管理

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

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

Composer 將這樣為你解決問題：

a) 你有一個(gè)項(xiàng)目依賴于若干個(gè)庫。

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

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

d) Composer 會(huì)找出哪個(gè)版本的包需要安裝，并安裝它們（將它們下載到你的項(xiàng)目中）。

聲明依賴關(guān)系

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

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

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

系統(tǒng)要求

運(yùn)行 Composer 需要 PHP 5.3.2+ 以上版本。一些敏感的 PHP 設(shè)置和編譯標(biāo)志也是必須的，但對(duì)于任何不兼容項(xiàng)安裝程序都會(huì)拋出警告。

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

Composer 是多平臺(tái)的，我們努力使它在 Windows 、 Linux 以及 OSX 平臺(tái)上運(yùn)行的同樣出色。

安裝 - *nix

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

局部安裝

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

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

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

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

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

你可以通過 \--install-dir 選項(xiàng)指定 Composer 的安裝目錄（它可以是一個(gè)絕對(duì)或相對(duì)路徑）：

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

全局安裝

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

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

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

注意： 如果上訴命令因?yàn)闄?quán)限執(zhí)行失敗， 請(qǐng)使用 sudo 再次嘗試運(yùn)行 mv 那行命令。

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

全局安裝 (on OSX via homebrew)

Composer 是 homebrew-php 項(xiàng)目的一部分。

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

安裝 - Windows

使用安裝程序

這是將 Composer 安裝在你機(jī)器上的最簡(jiǎn)單的方法。

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

手動(dòng)安裝

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

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

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

在 composer.phar 同級(jí)目錄下新建文件 composer.bat ：

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

關(guān)閉當(dāng)前的命令行窗口，打開新的命令行窗口進(jìn)行測(cè)試：

C:Usersusername>composer -V
Composer version 27d8904

使用 Composer

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

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

php composer.phar install

如果你進(jìn)行了全局安裝，并且沒有 phar 文件在當(dāng)前目錄，請(qǐng)使用下面的命令代替：

composer install

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

自動(dòng)加載

除了庫的下載，Composer 還準(zhǔn)備了一個(gè)自動(dòng)加載文件，它可以加載 Composer 下載的庫中所有的類文件。使用它，你只需要將下面這行代碼添加到你項(xiàng)目的引導(dǎo)文件中：

require 'vendor/autoload.php';

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