一次因composer錯誤使用引發(fā)的問題與解決
前言
這個思考源自于一個事故。讓我對版本依賴重新思考了一下。分享出來供有需要的朋友們參考學習,下面話不多說了,來一起看看詳細的介紹吧
事故現(xiàn)象
一個線上的管理后臺,一個使用laravel搭建的管理后臺,之前在線上跑的好好的,今天comopser install之后,出現(xiàn)錯誤信息:
[2019-02-25 16:00:33] production.ERROR: Parse error: syntax error, unexpected '?', expecting variable (T_VARIABLE) {"exception":"[object] (Symfony\\Component\\Debug\\Exception\\FatalThrowableError(code: 0): Parse error: syntax error, unexpected '?', expecting variable (T_VARIABLE) at /xxxx/application/estimate-admin/vendor/symfony/translation/Translator.php:89)
事故分析
這個是個底層庫,基本上,一看就知道是版本兼容問題,進去代碼一看,里面有行代碼是 ?string,這個是php7.1引入的一種新特性。
看了下我的composer.json,里面主要引用的是laravel的框架,之前的laravel/framework的版本是"~5.5"
于是想當然以為是laravel的版本升級導致的,于是我把laravel的版本固定到一個子版本
"laravel/framework": "5.5.21",
發(fā)現(xiàn)還是會出現(xiàn)這個錯誤。估摸可能不是laravel版本升級導致的。于是從laravel的版本依賴追到問題的包"symfony/translation"。
鏈條如下:
我的項目 "laravel/framework": "5.5.21",
laravel/framework "symfony/http-kernel": "~3.3",
symfony/http-kernel(3.3.13版本) "symfony/translation": "~2.8|~3.0",
symfony/http-kernel(3.4版本) "symfony/translation": "~2.8|~3.0|~4.0",
symfony/translation3.4版本:
public function __construct($locale, $formatter = null, $cacheDir = null, $debug = false)
而在4.0的時候加入了7.1的特性
public function __construct(?string $locale, MessageFormatterInterface $formatter = null, string $cacheDir = null, bool $debug = false)
我機器上的版本是PHP 7.0。所以導致了在composer升級的時候symfony/http-kernel也升級,帶來了symfony/translation升級到4.x,引入了PHP7.1的新特性。
解決方法
升級線上機器PHP版本是不可能的事情。于是我只能強制限定版本號。
直接在最上層我的項目中require symfony/translation,并且指定版本號。
"symfony/translation" : "3.3.13"
重新composer update 就可以了。
思考
這是一個典型的依賴包升級導致的業(yè)務(wù)應(yīng)用出錯的案例。symfony/translation 從 3.3.13 升級到4.*,需要的PHP版本從7.0升級到7.1。這樣的升級,laravel/framework 版本 v5.5.21 是無感知的。
而我們看 laravel/framework v5.5.21 的(comopser.json)[https://github.com/laravel/framework/blob/v5.5.21/composer.json]
{ "name": "laravel/framework", "description": "The Laravel Framework.", ... "require": { "php": ">=7.0", "ext-mbstring": "*", "ext-openssl": "*", ... "symfony/http-kernel": "~3.3", }, ... }
這里的 PHP >= 7.0 是不是格外扎眼,根本已經(jīng)不靠譜了。
真正解決辦法
哈,其實這里并沒有結(jié)束。這個問題包版本依賴其實各個包都沒有問題。
其實這里有一個問題,我打包機器的PHP版本是7.1,但是線上機器是7.0.0,所以會導致這個問題。
其實composer比我們想象的更為強大。它會根據(jù)你當前機器的PHP版本,判斷你的所有依賴分別使用什么版本,在composer update的時候,會根據(jù)所有依賴的版本需求選擇一個最好的版本。
所以我把我的打包機器上的PHP切換成7.0,查看生成的composer.lock,里面的symfony/translation就限制到使用3.3.x版本 就不會出現(xiàn)這個問題了。
composer的正確使用姿勢
是否要將composer.lock加入到git庫
這個是我這次犯的一個錯誤,沒有將composer.lock進入版本庫,打包機器composer install的時候就相當于update操作了。對于業(yè)務(wù)來說,這個是不對的。業(yè)務(wù)要做的事情是保證業(yè)務(wù)穩(wěn)定性,其實任何的庫依賴的升級,都需要經(jīng)過業(yè)務(wù)的測試和驗證才能上線。所以,這里強烈建議在業(yè)務(wù)項目里面,將composer.lock強制加入git代碼庫中。
是否要使用自動升級
版本依賴的時候,使用~,^符號會在composer udpate的時候根據(jù)依賴包已經(jīng)有的類庫。
我理解自動升級的機制有好也有壞處,這個就相當于把主動權(quán)(這里已經(jīng)說的是update的主動權(quán))放在哪里。作為一個基礎(chǔ)類庫,我當然希望你使用我的時候能相信我,我的每次版本升級都是兼容的,也不會引入bug。所以類庫是會希望你會使用自動升級。這樣我的一些bug修復(fù),在你update的時候你就會自動下載并且修復(fù)了。
但是對于業(yè)務(wù)來說,業(yè)務(wù)穩(wěn)定是死要求。一旦我update的時候,我使用了你的新下載的包,這個實際上就有可能引入一個bug。沒有經(jīng)過完整的測試,是不應(yīng)該做這種操作的。
但是實際上,我們是無法完全杜絕這個情況,比如你的一個lib包依賴了另外一個lib包的時候,它如果使用了自動升級,你是完全沒有辦法的。
所以一旦我們使用包依賴,自動升級的事情,是無法杜絕的。
慎用update
使用update操作的時候,必須想到會引發(fā)什么操作,盡量將composer.lock做下差異比對,明白下前后兩個依賴包差別在哪里。
總結(jié)
包依賴問題,不僅php有,golang也有,基本注意點都是如上,一樣的。
好了,以上就是這篇文章的全部內(nèi)容了,希望本文的內(nèi)容對大家的學習或者工作具有一定的參考學習價值,如果有疑問大家可以留言交流,謝謝大家對腳本之家的支持。
- Laravel框架中composer自動加載的實現(xiàn)分析
- PHP管理依賴(dependency)關(guān)系工具 Composer的自動加載(autoload)
- Laravel 解決composer相關(guān)操作提示php相關(guān)異常的問題
- laravel 實現(xiàn)向公共模板中傳值 (view composer)
- 淺談laravel 5.6 安裝 windows上使用composer的安裝過程
- 使用composer 安裝 laravel框架的方法圖文詳解
- tp5框架使用composer實現(xiàn)日志記錄功能示例
- windows環(huán)境下使用Composer安裝ThinkPHP5
- PHP創(chuàng)建自己的Composer包方法
- 分析Composer實現(xiàn)自動加載原理
相關(guān)文章
php源碼之將圖片轉(zhuǎn)化為data/base64數(shù)據(jù)流實例詳解
在網(wǎng)站開發(fā)中,我們可以看到有的網(wǎng)站將圖片轉(zhuǎn)化為base64數(shù)據(jù)流,這樣做的好處有兩點,一是減少服務(wù)器http請求,二是可以將圖片作為字符串存儲在數(shù)據(jù)庫中,即圖片可以直接從數(shù)據(jù)庫中讀取,那么php如何將圖片轉(zhuǎn)化為data/base64字符串呢?,需要的朋友可以參考下2016-11-11Yii2使用小技巧之通過 Composer 添加 FontAwesome 字體資源
前天幫同事改個十年前的網(wǎng)站 bug,頁面上一堆 include require 不禁讓人抱頭痛哭??吹?V2EX 上的討論說,寫 PHP 不用框架等同于耍流氓。Yii Framework 是我使用了 2 年多的 PHP 框架,器大活好,皮實耐操。 Yii2 還在 Beta 中,不過不影響拿來預(yù)研。2014-06-06laravel 判斷查詢數(shù)據(jù)庫返回值的例子
今天小編就為大家分享一篇laravel 判斷查詢數(shù)據(jù)庫返回值的例子,具有很好的參考價值,希望對大家有所幫助。一起跟隨小編過來看看吧2019-10-10