下面由composer教學專欄來介紹composer.lock檔案的作用,希望對需要的朋友有幫助!
Composer#的基本使用
在專案中使用composer.json
在專案中使用composer,你需要有一個composer.json文件,此文件的作用主要用來聲明包之間的相互關係和其他的一些元素標籤。
require 關鍵字
第一件事情在composer.json就是使用require關鍵字了,你會告訴composer哪些套件是你專案所需要的
程式碼如下:
{ "require": { "monolog/monolog": "1.0.*" } }
如你所見,require的物件將會映射套件的名稱( monolog/monolog)和套件的版本是1.0.*
套件的命名
基本上包的命名是主名/項目名稱( monolog/monolog),主名必須唯一,但是項目也就是我們的包的名稱可以有相同的,例如: igorw/json,和seldaek /json
套件的版本
我們需要使用monolog的版本是1.0.*,他的意思是只要版本是1.0分支即可,例如1.0.0,1.0.2或1.0 .99
版本定義的兩種方式:
1. 標準的版本:定義保準的版本包文件,如:1.0.2
2. 一定範圍的版本:使用比較符號來定義有效的版本的範圍,有效的符號有>, >=, <,<=, !=
3. 通配符:特別的匹配符號*,例如1.0.*就相當於>=1.0,<1.1版本的即可
4. 下一個重要的版本:~符號最好的解釋就是,~1.2就相當於>1.2,<2.0,但~1.2.3就相當於>=1.2.3,<1.3版本。
安裝套件
在專案檔案路徑下執行
程式碼如下:
$ composer install
這樣子他會自動下載monolog/monolog檔案到你的vendor目錄下面。
接下來要說明一件事情就是
composer.lock - 鎖定檔案
在安裝完所有需要的套件之後,composer會生成一張標準的套件版本的檔案在composer.lock檔案中。這將鎖定所有套件的版本。
使用composer.lock(當然和composer.json一起)來控制你的專案的版本
這一點非常的重要,我們使用install指令來處理的時候,它首先會判斷composer.lock檔案是否存在,如果存在,將會下載相對應的版本(不會在於composer.json裡面的設定),這表示任何下載專案的人都會得到一樣的版本。
如果不存在composer.lock,composer將會透過composer.json來讀取需要的套件和相對的版本,然後建立composer.lock檔案
這樣子就可以在你的包有新的版本之後,你不會自動更新了,升級到新的版本,使用update命令即可,這樣子就能獲取最新版本的包並且也更新了你的composer.lock檔。
$ php composer.phar update 或者 $ composer update
Packagist(這應該就是composer,感覺有點像python的包,雖然沒那麼強大,呵呵,有了這種標準以後,以後大家開發網站絕對會很輕鬆,可以藉鑑很多人的程式碼了,並且更加方便了!)
Packagist是composer的主要倉庫,大家可以去看看,composer倉庫的基礎是包的源碼,你可以隨意的獲取,Packagist的目的建成一個任何人都可以使用的倉庫,這意味著在你的文件中任意的require包了。
關於自動載入
為了方便的載入套件文件,Composer自動產生了一個文件vendor/autoload.php,你可以方便只有的使用它在任何你需要使用的地方
require 'vendor/autoload.php';
這表示你可以非常非常方便的使用第三方程式碼了,假設你的專案需要使用monlog,你直接使用吧,他們都已經自動載入了的!
程式碼如下:
$log = new Monolog\Logger('name'); $log->pushHandler(new Monolog\Handler\StreamHandler('app.log', Monolog\Logger::WARNING)); $log->addWarning('Foo');
當然你也可以在composer.json中載入自己的程式碼:
#程式碼如下:
{ "autoload": { "psr-0": {"Acme": "src/"} } }
composer會把psr-0註冊為Acme的命名空間
你可以定義一個映射透過命名空間到檔案目錄,src目錄是你的根目錄,vendor是同一層級的目錄,例如一個檔案為:src/Acme/Foo.php就包含了Acme\ Foo類別
當你在增加autoload之後,你必須要重新install來產生vendor/autoload.php檔案
#在我們引用此檔案的時候,將會傳回一個autoloader類別的實力,所以你可以把傳回的值放入一個變量,然後在增加更多的命名空間,如果在開發環境下這是非常方便的,例如:
程式碼如下:
$loader = require 'vendor/autoload.php'; $loader->add('Acme\Test', __DIR__);
composer.lock檔案的作用
install 指令從目前目錄讀取composer.json 文件,處理了依賴關係,並將其安裝到vendor 目錄下。
程式碼如下:
composer install
如果当前目录下存在 composer.lock 文件,它会从此文件读取依赖版本,而不是根据 composer.json 文件去获取依赖。这确保了该库的每个使用者都能得到相同的依赖版本。
如果没有 composer.lock 文件,composer 将在处理完依赖关系后创建它。
为了获取依赖的最新版本,并且升级 composer.lock 文件,你应该使用 update 命令。
代码如下:
composer update
这将解决项目的所有依赖,并将确切的版本号写入 composer.lock。
如果你只是想更新几个包,你可以像这样分别列出它们:
代码如下:
composer update vendor/package vendor/package2
你还可以使用通配符进行批量更新:
代码如下:
composer update vendor/*
以上是關於composer.lock檔案的作用介紹的詳細內容。更多資訊請關注PHP中文網其他相關文章!