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';