Composer 使用

Composer 的使用

要使用 Composer，我們需要先在項目的目錄下建立一個 composer.json 檔案，檔案描述了項目的依賴關系。

檔案格式如下：

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

以上檔案說明我們需要下載下傳從 1.2 開始的任何版本的 monolog。

接下來隻要運作以下指令即可安裝依賴包：

composer install

require 指令

除了使用 install 指令外，我們也可以使用 require 指令快速的安裝一個依賴而不需要手動在 composer.json 裡添加依賴資訊：

$ composer require monolog/monolog      

Composer 會先找到合适的版本，然後更新composer.json檔案，在 require 那添加 monolog/monolog 包的相關資訊，再把相關的依賴下載下傳下來進行安裝，最後更新 composer.lock 檔案并生成 php 的自動加載檔案。

update 指令

update 指令用于更新項目裡所有的包，或者指定的某些包：

# 更新所有依賴

$ composer update

# 更新指定的包

$ composer update monolog/monolog

# 更新指定的多個包

$ composer update monolog/monolog symfony/dependency-injection

# 還可以通過通配符比對包

$ composer update monolog/monolog symfony/*

需要注意的時，包能更新的版本會受到版本限制的限制，包不會更新到超出限制的版本的範圍。例如如果 composer.json 裡包的版本限制為 ^1.10，而最新版本為 2.0。那麼 update 指令是不能把包更新到 2.0 版本的，隻能最高更新到 1.x 版本。關于版本限制請看後面的介紹。

remove 指令

remove 指令用于移除一個包及其依賴（在依賴沒有被其他包使用的情況下），如果依賴被其他包使用，則無法移除：

$ composer remove monolog/monolog
Loading composer repositories with package information
Updating dependencies (including require-dev)
Package operations: 0 installs, 0 updates, 2 removals
  - Removing psr/log (1.0.2)
  - Removing monolog/monolog (1.23.0)
Generating autoload files      

search 指令

search 指令可以搜尋包：

$ composer search monolog      

該指令會輸出包及其描述資訊，如果隻想輸出包名可以使用 --only-name 參數：

$ composer search --only-name monolog      

show 指令

# 列出所有已經安裝的包
$ composer show

# 可以通過通配符進行篩選
$ composer show monolog/*

# 顯示具體某個包的資訊
$ composer show monolog/monolog