簡介#

Composer 是 PHP 的依賴管理工具。 它能讓你宣告專案需要的依賴函式庫, 並為你在專案中管理(安裝/更新)它們。

依賴管理#

Composer 不是 和 Yum 或 Apt 同樣的套件管理工具。 是的,它涉及「套件」或函式庫,但它在每個專案的基礎上進行管理,在你專案中的一個目錄(如 vendor)進行安裝。 預設情況下,它不會全域地安裝任何東西。因此,它是一個依賴管理工具。 然而,為了方便使用,它透過 全域 命令來支援「全域」專案。

這個想法並不新鮮,Composer 受到 node 的 npm 和 ruby 的 bundler 強烈的啟發。

假設:

  1. 你有一個依賴一些函式庫的專案。
  2. 那些函式庫的一部份依賴於其他函式庫。

Composer:

  1. 能讓你宣告依賴的函式庫。
  2. 找出哪些套件能夠和需要安裝的版本, 並安裝它們(意指將它們下載到你的專案中)。

有關宣告依賴的更多細節,參閱 基本使用 章節。

系統需求#

運行 Composer 要求 PHP 5.3.2+。 有一些敏感的 php 設定和編譯旗標也是必須的, 但在使用安裝程序時,有任何不相容的地方都會拋出警告。

要從來源而不是簡單的 zip 封存安裝套件,你會需要 git、svn、fossil 或 hg,這取決於該套件是如何進行版本控管的。

Composer 是多平台的,而我們努力讓它在 Windows、 Linux 和 OSX 上同樣出色。

安裝 - Linux / Unix / OSX#

下載 Composer 可執行文件#

Composer 提供了一個方便的安裝程序,你可以直接從命令列執行。 隨意 下載這個檔案 或在 GitHub 上查看,如果你想了解更多關於安裝程序的內部運作。原始碼是純 PHP。

簡而言之,有兩種方法來安裝 Composer。在本地做為你專案的一部份, 或在全域做為全系統的可執行文件。

在本地#

在本地安裝 Composer 只是一件在你專案目錄中執行安裝程序的事。有關說明,參閱 下載頁面

安裝程序只會檢查一些 PHP 設定然後下載 composer.phar 到你的工作目錄。該檔案是 Composer 二進制文件。它是一個 PHAR(PHP 封存),PHP 的封存格式,可以在命令列執行。

現在只須執行 php composer.phar 即可執行 Composer。

你可以透過使用 --install-dir 選項來安裝 Composer 到指定目錄,並額外使用 --filename 選項進行(重新)命名。執行安裝程序時,依循 下載頁面說明 添加以下參數:

php composer-setup.php --install-dir=bin --filename=composer

現在只須執行 php bin/composer 即可執行 Composer。

在全域#

你可以將 Composer PHAR 放置在任何想要的地方。如果你放在做為 PATH 其中一部分的目錄中, 你可以全域存取。在 unix 系統你甚至可以讓它變成可執行文件並調用,而無需直接使用 php 解釋器。

在依循 下載頁面說明 執行安裝程序之後,你可以執行此操作,把 composer.phar 移動到 path 目錄:

mv composer.phar /usr/local/bin/composer

注意: 如果上述由於權限失敗,你可能需要使用 sudo 再次執行。

注意: 在某些版本的 OSX,/usr 目錄預設不存在。 如果你收到 "/usr/local/bin/composer: No such file or directory" 錯誤,那麼你必須在繼續進行之前手動建立該目錄: mkdir -p /usr/local/bin

注意: 有關變更 PATH 的資訊,請參閱 Wikipedia 主題 和/或使用 Google。

現在只須執行 composer 即可執行 Composer,而非 php composer.phar

安裝 - Windows#

使用安裝程序#

這是將 Composer 設置在你的機器上最簡單的方式。

下載並執行 Composer-Setup.exe。 它會安裝最新版本的 Composer 並設置你的 PATH 以便你可以在命令列中的任何目錄呼叫 composer

注意: 關閉你的終端機。用新的終端機來測試: 這很重要,因為 PATH 只會在終端機啟動時載入。

手動安裝#

切換到你做為 PATH 一部分的目錄並依循 下載頁面說明 來下載 composer.phar

composer.phar 旁邊建立一個新的 composer.bat 檔案:

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

如果還沒有的話,添加該目錄到你的 PATH 環境變數。 有關變更 PATH 變數的資訊,請參閱 本文 和/或使用 Google。

關閉你目前的終端機。用一個新的終端機測試使用:

C:\Users\username>composer -V
Composer version 1.0.0 2016-01-10 20:34:53

使用 Composer#

現在你已經完成安裝 Composer,準備好要使用它了! 前往下一章,進行簡短的示範。

基本使用

發現錯字?在這個文件中有些錯誤?只要 fork 並編輯 它!