# packagist [packagist](https://packagist.org) 是 Composer 的主要資源庫。 一個 Composer 的庫基本上是一個包的源：記錄了可以得到包的地方。Packagist 的目標是成為大家使用庫資源的中央存儲平臺。這意味著你可以 require 那里的任何包。 當你訪問 packagist website (packagist.org)，你可以瀏覽和搜索資源包。 # `composer.json`文件和`vendor`目錄 項目中使用 Composer獲取的組件，只需要一個 `composer.json `文件生命依賴關系就可以了。該文件包含了項目的依賴和其它的一些元數據。 `vendor`目錄下存放拉下來的`composer`組件包。 # 關于` require Key` 第一件事情（并且往往只需要做這一件事），你需要在` composer.json `文件中指定 `require key` 的值。你只需要簡單的告訴 Composer 你的項目需要依賴哪些包。 { "require": { "monolog/monolog": "1.0.*" } } 你可以看到， `require `需要一個 包名稱 （例如 `monolog/monolog`） 映射到 包版本 （例如 1.0.*） 的對象。 # 包名稱 包名稱由供應商名稱和其項目名稱構成。通常容易產生相同的項目名稱，而供應商名稱的存在則很好的解決了命名沖突的問題。它允許兩個不同的人創建同樣名為 json 的庫，而之后它們將被命名為 `igorw/json `和 `seldaek/json`。 這里我們需要引入 `monolog/monolog`，供應商名稱與項目的名稱相同，對于一個具有唯一名稱的項目，我們推薦這么做。它還允許以后在同一個命名空間添加更多的相關項目。如果你維護著一個庫，這將使你可以很容易的把它分離成更小的部分。 # 包版本 在前面的例子中，我們引入的 monolog 版本指定為 1.0.*。這表示任何從 1.0 開始的開發分支，它將會匹配 `1.0.0、1.0.2 `或者` 1.0.20`。 ## 版本約束 可以用幾個不同的方法來指定。 | 名稱 | 實例 | 描述 | | --- | --- | --- | | 確切的版本號 | 1.0.2 | 你可以指定包的確切版本。 | | 范圍 | >=1.0 >=1.0,<2.0 >=1.0,<1.1,>=1.2 | 通過使用比較操作符可以指定有效的版本范圍。有效的運算符：>、>=、<、<=、!=。你可以定義多個范圍，用逗號隔開，這將被視為一個邏輯AND處理。一個管道符號，將作為邏輯OR處理。AND 的優先級高于 OR。 | | 通配符 | 1.0.* | 你可以使用通配符*來指定一種模式。1.0.*與>=1.0,<1.1是等效的。 | | 賦值運算符 | ~1.2 | 這對于遵循語義化版本號的項目非常有用。~1.2相當于>=1.2,<2.0。 | ## 下一個重要版本（波浪號運算符） `~` 最好用例子來解釋：` ~1.2 `相當于` >=1.2,<2.0`，而 `~1.2.3 `相當于` >=1.2.3,<1.3`。正如你所看到的這對于遵循 語義化版本號 的項目最有用。一個常見的用法是標記你所依賴的最低版本，像 `~1.2 `（允許1.2以上的任何版本，但不包括2.0）。由于理論上直到2.0應該都沒有向后兼容性問題，所以效果很好。你還會看到它的另一種用法，使用 `~ `指定最低版本，但允許版本號的最后一位數字上升。 注意： 雖然 2.0-beta.1 嚴格地說是早于 2.0，但是，根據版本約束條件， 例如 ~1.2 卻不會安裝這個版本。就像前面所講的 ~1.2 只意味著 .2 部分可以改變，但是 1. 部分是固定的。 ## 穩定性 默認情況下只有穩定的發行版才會被考慮在內。如果你也想獲得 RC、beta、alpha 或 dev 版本，你可以使用 穩定標志。你可以對所有的包做 `最小穩定性` 設置，而不是每個依賴逐一設置。 # 安裝依賴包 推薦使用`install`命令 composer install 接著前面的例子，這將會找到依賴組件的指定版本，并將它下載到 vendor 目錄。 > 如果你正在使用Git來管理你的項目， 你可能要添加 vendor 到你的 .gitignore 文件中。 你不會希望將所有的代碼都添加到你的版本庫中。另一件事是 install 命令將創建一個 composer.lock 文件到你項目的根目錄中。 # composer.lock - 鎖文件 在安裝依賴后，Composer 將把安裝時確切的`版本號`列表寫入 composer.lock 文件。這將鎖定改項目的特定版本。 請提交你應用程序的 composer.lock （包括 composer.json）到你的版本庫中 這是非常重要的，因為 `install `命令將會檢查鎖文件是否存在，如果存在，它將下載指定的版本（忽略` composer.json` 文件中的定義）。 這意味著，任何人建立項目都將下載與指定版本完全相同的依賴。你的持續集成服務器、生產環境、你團隊中的其他開發人員、每件事、每個人都使用相同的依賴，從而減輕潛在的錯誤對部署的影響。即使你獨自開發項目，在六個月內重新安裝項目時，你也可以放心的繼續工作，即使從那時起你的依賴已經發布了許多新的版本。 如果不存在 composer.lock 文件，Composer 將讀取 composer.json 并創建鎖文件。 這意味著如果你的依賴更新了新的版本，你將不會獲得任何更新。此時要更新你的依賴版本請使用 update 命令。這將獲取最新匹配的版本（根據你的 composer.json 文件）并將新版本更新進鎖文件。 compose update 如果只想安裝或更新一個依賴。 compose update monolog/monolog 還有更多關于composer的操作，推薦查看： [phpcomposer中文文檔](http://docs.phpcomposer.com/) [composer命令全解](http://composer.json.jolicode.com/)