Mars's Blog

Composer安裝

Mars Hung
tutorial
文章閱讀量次

一、說明

Composer是PHP套件管理器，將特定功能的函式庫/專案拆分成套件，透過套件管理器安裝使用，好處有：

  • 統一維護程式碼
  • 支援版本控制
  • 自動管理依賴函式庫

使用Composer管理套件，讓您的開發更方便順利。

二、安裝

2.1 Windows

  • 下載 Composer-Setup.exe 並安裝
    下載並執行 Composer-Setup.exe。 它會安裝最新版本的 Composer 並設置你的 PATH 以便你可以在命令列中的任何目錄呼叫 composer。

    注意： 關閉你的終端機。用新的終端機來測試： 這很重要，因為 PATH 只會在終端機啟動時載入。
    Composer 依賴 PHP，請確保已安裝 PHP

  • 驗證安裝（開啟新的 CMD 或 PowerShell）：

    1
    2
    composer --version
    # 輸出範例：Composer version 2.6.5 2023-10-06 10:12:55

  • 手動設定 PATH 環境變數（如果找不到 composer 指令）：

    1. 開啟「系統內容」→「進階」→「環境變數」
    2. 在「系統變數」中找到「Path」，點擊「編輯」
    3. 新增 Composer 安裝路徑（預設：C:\ProgramData\ComposerSetup\bin）
    4. 確定後重新開啟終端機

2.2 macOS

  • 使用 Homebrew 安裝（推薦）

    1
    $ brew install composer

  • 驗證安裝：

    1
    2
    $ composer --version
    # 輸出範例：Composer version 2.6.5 2023-10-06 10:12:55

2.3 Linux(Ubuntu 20.04/22.04 LTS)

  • 安裝Composer
    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    # 下載安裝程式
    $ sudo php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"

    # 執行安裝
    $ sudo php composer-setup.php

    # 刪除安裝檔
    $ sudo php -r "unlink('composer-setup.php');"

    # 移動Composer命令至全域執行路徑
    $ sudo mv composer.phar /usr/local/bin/composer

    # 查看Composer版本
    $ composer --version
    Composer version 2.x.x 202x-xx-xx xx:xx:xx

    Composer 依賴 PHP，請確保已安裝 PHP 7.2.5 以上版本

三、常用指令

  • 安裝新套件： composer require <packages>

    加入新套件使用本命令

  • 移除套件： composer remove <packages>
  • 列出可用套件： composer show

    已安裝套件資訊

  • 安裝依賴套件： composer install

    安裝composer.lock文件定義過的套件，如果沒有，則只會解析composer.json文件中列出的所有依賴項，並將其最新版本的文件下載到vendor項目的目錄中。

  • 將依賴套件更新為其最新版本： composer update [<packages>]

    如果你只想要安裝或升級單一依賴套件，可以指定套件名稱

  • 初始化： composer init

    首次使用時，自動建立composer.json檔

  • 更新Composer本身： composer self-update

實際應用範例：安裝 Monolog 日誌套件

1
2
3
4
5
6
7
8
9
10
11
# 建立新專案目錄
mkdir my-project && cd my-project

# 初始化 composer.json
composer init --no-interaction

# 安裝 Monolog 套件
composer require monolog/monolog

# 查看已安裝套件
composer show

安裝完成後，專案目錄會出現：

  • composer.json：套件依賴清單
  • composer.lock：鎖定的套件版本
  • vendor/：套件安裝目錄

四、參考

Recents

Archives

Categories

Tags