1. 程式人生 > >composer 介紹及安裝

composer 介紹及安裝

https://docs.phpcomposer.com/00-intro.html

簡介

Composer 是 PHP 的一個依賴管理工具。它允許你申明專案所依賴的程式碼庫,它會在你的專案中為你安裝他們



依賴管理

Composer 不是一個包管理器。是的,它涉及 "packages" 和 "libraries",但它在每個專案的基礎上進行管理,在你專案的某個目錄中(例如 vendor)進行安裝。預設情況下它不會在全域性安裝任何東西。因此,這僅僅是一個依賴管理。

這種想法並不新鮮,Composer 受到了 node's npm 和 ruby's bundler 的強烈啟發。而當時 PHP 下並沒有類似的工具。

Composer 將這樣為你解決問題:

a) 你有一個專案依賴於若干個庫。

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

c) 你宣告你所依賴的東西。

d) Composer 會找出哪個版本的包需要安裝,並安裝它們(將它們下載到你的專案中)。

宣告依賴關係

比方說,你正在建立一個專案,你需要一個庫來做日誌記錄。你決定使用 monolog。為了將它新增到你的專案中,你所需要做的就是建立一個 composer.json 檔案,其中描述了專案的依賴關係。

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

我們只要指出我們的專案需要一些 monolog/monolog 的包,從 1.2 開始的任何版本。

系統要求

執行 Composer 需要 PHP 5.3.2+ 以上版本。一些敏感的 PHP 設定和編譯標誌也是必須的,但對於任何不相容項安裝程式都會丟擲警告。

我們將從包的來源直接安裝,而不是簡單的下載 zip 檔案,你需要 git 、 svn 或者 hg ,這取決於你載入的包所使用的版本管理系統。

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

安裝 - *nix

下載 Composer 的可執行檔案

區域性安裝

要真正獲取 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 的歸檔格式可以幫助使用者在命令列中執行一些操作。

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

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

全域性安裝

你可以將此檔案放在任何地方。如果你把它放在系統的 PATH 目錄中,你就能在全域性訪問它。 在類Unix系統中,你甚至可以在使用時不加 php 字首。

你可以執行這些命令讓 composer 在你的系統中進行全域性呼叫:

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

注意: 如果上訴命令因為許可權執行失敗, 請使用 sudo 再次嘗試執行 mv 那行命令。

現在只需要執行 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,它將安裝最新版本的 Composer ,並設定好系統的環境變數,因此你可以在任何目錄下直接使用 composer 命令。

手動安裝

設定系統的環境變數 PATH 並執行安裝命令下載 composer.phar 檔案:

C:\Users\username>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:\Users\username>composer -V
Composer version 27d8904

使用 Composer

現在我們將使用 Composer 來安裝專案的依賴。如果在當前目錄下沒有一個 composer.json 檔案,請檢視基本用法章節。

要解決和下載依賴,請執行 install 命令:

php composer.phar install

如果你進行了全域性安裝,並且沒有 phar 檔案在當前目錄,請使用下面的命令代替:

composer install

繼續 上面的例子,這裡將下載 monolog 到 vendor/monolog/monolog 目錄。

自動載入

除了庫的下載,Composer 還準備了一個自動載入檔案,它可以載入 Composer 下載的庫中所有的類檔案。使用它,你只需要將下面這行程式碼新增到你專案的引導檔案中:

require 'vendor/autoload.php';