Composer 安裝教學-以 Debian/Ubuntu 環境中示範

Composer是一個PHP相依套件的管理工具,可以讓開發者依自己的需求來自動安裝及更新所需要的相依套件,這在開發及維護上來說會方便許多。現在很多PHP專案可以藉由Composer來進行管理,如:著名的PHP框架有Laravel與Symfony等等,還有很多架站工具,例如:Drupal、Joomla和Magento等等。

本文教學將會指引使用者如何在Debian/Ubuntu環境上安裝Composer,當然如果你是使用其他Linux發行版,也是一樣可以參考此篇教學,只是在更新系統的套件資訊及安裝PHP套件時,指令會有些不一樣(Debian/Ubuntu是使用APT;RHEL/CentOS等等是使用YUM),但在安裝Composer的過程都是一樣的。本文教學所安裝的Composer為全域(globally)方式,這樣你就可以在全域環境使用Composer來管理套件了。

1)更新系統的套件資訊及安裝PHP-CLI套件。

Step 1:將Debian/Ubuntu系統的套件資訊與版本更新到最新。

sudo apt-get update && sudo apt-get upgrade -y

 

Step 2:如果你的系統還未安裝好PHP Command-Line Interface(PHP-CLI),那還需要安裝Composer會用到的PHP-CLI及其他的PHP相依套件,如以下筆者安裝了PHP 8.1版本的PHP-CLI。假如你的Debian/Ubuntu無法安裝PHP 8.1版本的PHP-CLI或其他目前還有在支援的PHP版本,那可以參考此篇Debian/Ubuntu環境下安裝PHP的教學。

**Composer要求的PHP版本為PHP 5.3.2或以上。

**在Debian/Ubuntu系統環境安裝PHP 8.2版本的PHP-CLI指令參考如下:

sudo apt-get install php8.1-cli -y

 

2)下載與安裝Composer,及將Composer設定為全域可執行的指令。

**筆者此篇教學參考了Composer官網的Composer安裝文檔,來將Composer安裝至Linux環境。

Step 1:從Composer官網下載Composer安裝檔至tmp目錄。

php -r "copy('https://getcomposer.org/installer', '/tmp/composer-setup.php');"

 

Step 2:使用官方提供的SHA-384簽章來驗證剛剛下載好的Composer安裝檔。

**Composer安裝檔的SHA-384安裝檔數位簽章(Installer Signature (SHA-384)),可以至Composer Public Keys / Signatures頁面查看。

**如筆者在2023年7月查到Composer安裝檔的SHA-384驗證簽章為:

e21205b207c3ff031906575712edab6f13eb0b361f2085f1f1237b7126d785e826a450292b6cfd1d64d92e6563bbde02

那就將其值輸入進去,相關指令可以參考如下:

php -r "if (hash_file('SHA384', '/tmp/composer-setup.php') === 'e21205b207c3ff031906575712edab6f13eb0b361f2085f1f1237b7126d785e826a450292b6cfd1d64d92e6563bbde02') { echo 'Installer verified'; } else { echo 'Installer corrupt'; unlink('/tmp/composer-setup.php'); } echo PHP_EOL;"

 

Step 3:接著可以來安裝Composer了,為了可以讓Composer可以在全域環境中使用,所以要將Composer安裝至『usr/local/bin』目錄,以及需要將Composer重新命名為『composer』,這樣日後你需要使用Composer來管理套件時,開頭只需輸入『composer』就能使用Composer的指令了。

sudo php /tmp/composer-setup.php --install-dir=/usr/local/bin --filename=composer

 

Step 4:接著可以來查看Composer是否安裝正確,你可以輸入『composer -V』Composer版本檢查指令,如能出現下圖所示的訊息『Composer version 2.x.x DATE TIME』,則表示你的Composer已成功安裝在系統上。

composer -V

**Composer現在的版本v2為最新版本,若你使用的某些套件無法支援Composer的v2來進行管理與更新,那可以將版本降成v1版本,指令如下:

composer self-update --1

若日後想要回到v2版本:

composer self-update --2

甚至若要使用特定版本,也是可以的(關於Composer過去歷史的版本號,請參考Composer Download的最下面):

composer self-update <版本號>

 

Step 5:最後從tmp目錄中,將剛剛下載的Composer安裝檔刪除。

rm /tmp/composer-setup.php

 

Step 6:你可以輸入『composer』來查看Composer有哪些可用的指令。

composer

 

3)更新Composer版本的指令。

Step 1:如果日後需要將Composer更新,那可以輸入『sudo composer self-update』或『sudo composer selfupdate』來將Composer更新至最新版本。

sudo composer self-update

若更新Composer出現錯誤:

[RuntimeException]
  SHA384 is not supported by your openssl extension, could not verify the phar file integrity

請試著從本文教學的第二項目(下載與安裝Composer)重新執行Composer的安裝就能解決。

 

4)解決Composer執行過慢的問題。

**以下教學僅適用於Composer的v1版本,因v2版本已改善Composer執行過慢的問題。

Step 1:如果你在使用Composer檢查相依套件和下載套件的過程有遇到過慢的問題,那可以試著使用由開發者hirak所維護的prestissimo插件,來改善Composer執行過慢的問題,在安裝prestissimo插件之前,你需要安裝好PHP-cURL套件和zip解壓縮工具。因為筆者本篇教學是使用PHP 8.1版本,所以就安裝了PHP 8.1版本的php8.1-curl。

sudo apt-get install php8.1-curl zip unzip -y

 

Step 2:接著安裝hirak所維護的prestissimo插件,就可以改善Composer執行過慢的問題了。

composer require hirak/prestissimo

在安裝的過程,如果遇到『[ErrorException] mkdir(): Permission denied』權限的問題,而無法順利安裝時,那試著輸入以下的指令:

sudo chown -R <使用者名稱> ~/.composer/cache/

比如說筆者的Ubuntu系統的使用者名稱為『demo』,那會輸入如以下的指令:

sudo chown -R demo ~/.composer/cache/

 

此篇文章上次修改日期:
2023/07/16