本篇文章帶大家了解一下官方新項目 laravel pint,一個基于 php-cs-fixer 專為 laravel 優化的編碼格式化工具,希望對大家有所幫助!
期待已久的炒作終于結束了,Laravel 最新的開源 CLI 應用程序已經發布到世界各地,我們已經著手介紹它——Laravel Pint。
“Laravel pint 是一個零依賴的、構建在 PHP-CS-Fixer 之上的 PHP 代碼風格修復器,適用于極簡主義者。”,以上是 readme 原文。
一讀到這里,我就興奮起來,我的意思是非常興奮。在現代 PHP 中,我們一直在磨練我們的工藝,使我們的代碼更嚴格和更好地測試,并確保我們擁有一致的代碼風格。 這一切都始于 PHP-FIG 成立時,他們開始發布 PSRs,并且隨著具有自己特定發布樣式規則的框架不斷發展壯大。這個包沒有什么不同,它將根據預設自動測試和修復你的代碼風格。
想要用這個包,請用 composer 安裝它:
composer?require?laravel/pint?--dev
安裝后,無需配置即可運行。你可以運行以下命令:
./vendor/bin/pint
無需配置、無需設置、無需思考或努力 – 我的項目會立即針對 PSR-12 樣式進行評估并自動修復。是不是很神奇?保持代碼干凈和一致有時需要耗費一些精力或思考如何進行此設置以及需要實現哪些規則。或者使用 PHP CS Fixer,你必須創建一個配置文件,然后創建一個查找器以將規則添加到 PHP 文件的數組中。事情很快變得一團糟,對吧?
如果您在項目的根目錄中創建 pint.json 文件,它會簡單地加載并讀取配置,否則, 會加載并讀取默認值。配置全部使用 JSON 的格式,使其更易于使用且更具可讀性。
讓我們快速瀏覽一下使用預設設置新的 pint 配置。但是讓我們看看用一個全新的 Laravel 項目來做這件事,所以創建一個新項目:
laravel?new?pint-demo
在終端中打開這個新項目并安裝 pint:
composer?require?laravel/pint?--dev
使用我們全新的 Laravel 應用程序,讓我們為 Laravel 配置一個預設。創建一個 pint.json 文件并添加:
{ ????"preset":?"laravel" }
現在運行 pint:
./vendor/bin/pint
你應該看到類似于以下的輸出:
蕪湖,起飛 ?
所以現在讓我們將預設更改為 PSR-12 并檢查輸出:
{ ????"preset":?"psr12" }
重新運行 pint,讓我們看看輸出:
./vendor/bin/pint
你應該看到以下輸出:
讓我們檢查一下,發現它實施了single_trait_insert_per_statement、braces和new_with_braces等規則。如果我們想稍微定制這些怎么辦? 很簡單,因為我們可以輕易地定義和刪除規則,讓我們在 pint.json 文件中關閉大括號:
{ ????"preset":?"psr12", ??????"rules":?{ ????????"braces":?false ????} }
這就對了!自定義設置代碼樣式的方式很簡單。不再需要凌亂的 PHP 和數組來配置你的編碼風格。所以讓我們重新運行 pint,但這次我們想進行一次試運行,看看會發生什么變化:
./vendor/bin/pint?—test
厲害吧?漂亮干凈的輸出,進行試運行,看看什么會失敗以及為什么!那么如果想要更多的信息會發生什么呢?我已經修復了上面的文件并返回到用戶遷移以及撤消了這些更改,以便我們可以對其進行測試。讓我們再次試運行,但這次想使用 -v 標識請求詳細輸出:
我們得到了很好的輸出,就像使用 GitHub 時一樣,可以做出改變。 所以我們可以看到代碼風格問題,如果我們修復了它會發生什么變化 – 所有這些都來自使用一個非常簡單的命令。
我對你不了解,但這是我所有即將進行的項目、包以及我從事的任何其他工作的必備軟件。
原文地址:https://laravel-news.com/laravel-pint譯文地址:https://learnku.com/laravel/t/69321
【相關推薦:Laravel Pint】