Composer 安裝

簡介

Composer 是一個用于 PHP 依賴管理的工具。它實作了讓你聲明項目所依賴的庫，并幫你完成安裝 / 更新過程。

依賴管理

Composer 不是像 Yum 或 Apt 一樣的包管理器，雖然它會處理『包』或庫，但它管理這些包、庫是基于項目的，它會安裝這些包、庫到你項目的一個目錄下（一般是在 vendor 檔案夾裡)，預設情況下不會全局地安裝。它做為一個包管理器，也支援一個叫做 " global " 的全局指令，我們可以使用此指令來安裝全局的包。

這種擴充包的管理方式，不是 Composer 首創或獨家專利，其實 Composer 很大程度上有受到 node 的 npm 和 ruby 的 bundler 的啟發。

設想:

你有一個項目依賴數個庫；

某些庫依賴于其他庫。

Composer：

使你可以聲明你所依賴的庫；

找到這些庫所提供的和需要安裝的版本，并安裝它們（即下載下傳到你的項目中）。

參見 基本使用 章節擷取更多關于 “依賴聲明” 的内容。

系統要求

Composer 要求 PHP 版本在 5.3.2 以上才能運作。還需要對 PHP 做一些設定和編譯标志，在安裝時會收到所有的不相容警告。

從源碼安裝軟體替代簡單的解壓壓縮檔案，你需要 git，svn，fossil 或者 hg 這取決于軟體所用的版本控制工具。

Composer 是多平台的，可以在 Windows，Linux 和 OSX 上良好運作。

安裝 - Linux / Unix /macOS

下載下傳 Composer 可執行檔案

Composer 提供一個友善的安裝器，你可以直接在指令行裡直接執行它。免費 下載下傳位址 或者你想知道更多關于這個安裝器的資訊，這是源碼位址 GitHub 。

這是兩種簡單的安裝 Composer 途徑，本地安裝（單個項目）和全局安裝（提供全局的系統指令）。

本地安裝

在你的項目檔案夾下，運作安裝器。 檢視說明 安裝頁面 。

安裝器會檢查 PHP 配置然後下載下傳 composer.phar 到你的（工作目錄）項目檔案夾下。 composer.phar 是 Composer 二進制檔案。它是一個 PHAR（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 檔案移動到你的指令目錄：

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

如果你隻想為你的使用者安裝它并避免需要 root 權限，你可以用 ~/local/bin 代替一些 Linux 發行版的預設目錄。

注意：如果以上指令因為權限失敗，你需要使用 sudo 再次運作。

注意：某些版本的 OSX /usr 目錄預設不存在。如果你收到 /usr/local/bin/composer: No such file or directory 的錯誤提示，你必須在運作 mkdir -p /usr/local/bin 指令之前手動建立該目錄。

注意：關于更改 PATH 環境變量的更多資訊，請閱讀 Wiki 百科 或者使用 Google 搜尋。

現在隻需要運作 composer 指令就可以使用 Composer 而不需要輸入 php composer.phar。

安裝 - Windows

使用安裝程式

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

下載下傳并且運作 Composer-Setup.exe，它将安裝最新版本的 Composer ，并設定好系統的環境變量，是以你可以在任何目錄下直接使用 composer 指令。

注意: 請關閉目前的終端視窗。 重新打開一個新的終端視窗進行測試使用：這很重要，因為路徑隻有在終端啟動時才會加載。

手動安裝

設定系統的環境變量 PATH 并運作安裝指令下載下傳 composer.phar 檔案：

在 composer.phar 同級目錄下建立檔案 composer.bat ：

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

如果路徑尚未設定，則将目錄添加到 PATH 環境變量中。有關更改路徑變量的資訊，請參閱 這篇文章 和 / 或使用 Google。

關閉目前的指令行視窗，打開新的指令行視窗進行測試：

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

使用 Composer

現在你已經安裝了 Composer，你已經準備好使用它了！下面繼續進行

Composer 基本使用

。