> For the complete documentation index, see [llms.txt](https://tony915.gitbook.io/laravel-4-2/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://tony915.gitbook.io/laravel-4-2/into-laravel/install-composer.md).

# 安裝 Composer

Composer 是一個 PHP 相依套件的管理工具，它是針對個別專案，而非整個系統(例如: yum 或 apt)。使用上會先建立一個 composer.json 的檔案，內容會以 json 格式來表示該專案所要使用的套件，之後就可以

```
php composer.phar install
```

這樣的指令來安裝相依的套件，非常方便。Composer 安裝的套件會放在專案目錄下的 vendor 目錄中。

Composer 必須在 PHP 5.3.2 以上版本才能執行，所以要注意一下您所使用的 PHP 版本。

Laravel 使用 Composer 做為相依套件管理工具，所以在使用 Laravel 前，要先安裝 Composer。首先到 [Composer網站](https://getcomposer.org/)\[1]下載。依不同的作業系統，各自選擇不同的安裝方式。

## Linux / Unix / OSX

你有兩種方式可以安裝 Composer，一種是成為專案的一部份，只能在專案中執行；另一種是全域的，也就是整個系統中的任何地方都能執行。

### 針對專案

使用 curl 指令下載：

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

如果沒有安裝 curl ，也可以用 php 指令下載：

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

安裝程式會檢查你的 PHP 設定後，下載 composer.phar。但是如果你前面的兩個方式都不能安裝，你還是可以手動下載 [composer.phar](https://getcomposer.org/composer.phar)\[2]。

你可以使用一些參數，把 Composer 安裝在指定目錄，並且重新命名：

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

這樣就會被安裝成 bin/composer。使用方式：

```
php bin/composer
```

如果是在專案根目錄，則是：

```
php composer
```

### 全域使用

前面的方法是將 composer.phar 安裝在專案目錄中，可是這樣有個缺點，也就是每次當你建立新專案時，你必須重做上面的動作來取得 composer.phar，顯然有點麻煩。

其實 composer.phar 是可以移動的，所以你可以將它移動到 usr/local/bin 目錄中，這樣就會成為全域指令，即可在所有專案中使用。另外，為了操作的便利性，可以將 composer.phar 改名為 composer。

現在可以直接使用 composer 指令來取代針對專案的 php composer 指令。

## Windows

如果你使用 Windows 可以直接下載 [Windows install](https://getcomposer.org/Composer-Setup.exe)\[3] 執行檔安裝。安裝程式會將 composer 加到環境變數(PATH)中，這樣命令提示字元就能使用此指令。如果你有已經開啟的命令提示字元，請記得先關閉後在重新開啟。

## Composer 版本

要確認 Composer 是否有安裝成功，可以使用指令顯示其版本：

```
composer -V
```

如果有顯示版本，即代表安裝正確。

* \[1] <https://getcomposer.org/>
* \[2] <https://getcomposer.org/composer.phar>
* \[3] <https://getcomposer.org/Composer-Setup.exe>