這篇文章將為大家詳細講解有關(guān)如何用PHP_CodeSniffer檢查代碼規(guī)范,文章內(nèi)容質(zhì)量較高,因此小編分享給大家做個參考,希望大家閱讀完這篇文章后對相關(guān)知識有一定的了解。
為鄂托克前等地區(qū)用戶提供了全套網(wǎng)頁設(shè)計制作服務(wù),及鄂托克前網(wǎng)站建設(shè)行業(yè)解決方案。主營業(yè)務(wù)為成都網(wǎng)站制作、網(wǎng)站設(shè)計、外貿(mào)網(wǎng)站建設(shè)、鄂托克前網(wǎng)站設(shè)計,以傳統(tǒng)方式定制建設(shè)網(wǎng)站,并提供域名空間備案等一條龍服務(wù),秉承以專業(yè)、用心的態(tài)度為用戶提供真誠的服務(wù)。我們深信只要達到每一位用戶的要求,就會得到認可,從而選擇與我們長期合作。這樣,我們也可以走得更遠!
PHP_CodeSniffer
是一個代碼風(fēng)格檢測工具。它包含兩類腳本,phpcs
和 phpcbf
(GitHub地址)。
phpcs
腳本對 PHP
、JavaScript
、CSS
文件定義了一系列的代碼規(guī)范(通常使用官方的代碼規(guī)范標(biāo)準,比如 PHP
的 PSR2
),能夠檢測出不符合代碼規(guī)范的代碼并發(fā)出警告或報錯(可設(shè)置報錯等級)。
phpcbf
腳本能自動修正代碼格式上不符合規(guī)范的部分。比如 PSR2
規(guī)范中對每一個 PHP
文件的結(jié)尾都需要有一行空行,那么運行這個腳本后就能自動在結(jié)尾處加上一行空行。
安裝
推薦使用 composer
來安裝:
composer global require "squizlabs/php_codesniffer=*"
安裝完后就會在全局的 Vendor
目錄下的 bin
中生成兩個軟鏈接:
phpcbf -> ../squizlabs/php_codesniffer/bin/phpcbf phpcs -> ../squizlabs/php_codesniffer/bin/phpcs
如果你不知道全局 Vendor
目錄在哪,用下這個命令吧:
composer global config bin-dir --absolute
命令行使用
到這一步,其實你就可以愉快的使用這兩個命令了:
哦,不過如果要全局使用這兩個命令那還是做個軟鏈接放在 /usr/local/bin
下吧~
$ phpcs test.php FILE: /Users/stephen/Develop/Code/test.php -------------------------------------------------------------------------------------------- FOUND 2 ERRORS AFFECTING 2 LINES -------------------------------------------------------------------------------------------- 2 | ERROR | [ ] Missing file doc comment 3 | ERROR | [x] TRUE, FALSE and NULL must be lowercase; expected "false" but found "FALSE" -------------------------------------------------------------------------------------------- PHPCBF CAN FIX THE 1 MARKED SNIFF VIOLATIONS AUTOMATICALLY -------------------------------------------------------------------------------------------- Time: 45ms; Memory: 4Mb $ phpcbf test.php PHPCBF RESULT SUMMARY ---------------------------------------------------------------------- FILE FIXED REMAINING ---------------------------------------------------------------------- /Users/stephen/Develop/Code/test.php 1 1 ---------------------------------------------------------------------- A TOTAL OF 1 ERROR WERE FIXED IN 1 FILE ---------------------------------------------------------------------- Time: 49ms; Memory: 4Mb
Sublime Text 中集成
安裝插件
前提 Package Control
要安裝好,這個你肯定沒問題的(莫名的自信,逃)
安裝 phpcs
這個插件,然后打開這個插件的 Settings - User
和 Settings - Default
,將后者的內(nèi)容全部復(fù)制到前者。
配置插件
將以下這幾個配置項配置一下:
當(dāng)前環(huán)境中 php
的執(zhí)行路徑
"phpcs_php_prefix_path": "/usr/bin/php",
當(dāng)前環(huán)境中 phpcs
的執(zhí)行路徑
"phpcs_executable_path": "~/.composer/vendor/bin/phpcs",
執(zhí)行腳本時額外添加的參數(shù),一般以 PSR2
代碼規(guī)范作為標(biāo)準,你也可以選擇 PSR1
、PEAR
等
"phpcs_additional_args": { "--standard": "PSR2", "-n": "" },
當(dāng)前環(huán)境中 phpcbf
的執(zhí)行路徑
"phpcbf_executable_path": "/Users/stephen/.composer/vendor/bin/phpcbf",
開啟保存就執(zhí)行 cbf
腳本功能
"phpcbf_on_save": true,
現(xiàn)在就可以愉快的玩耍了,編輯完 .php
后綴的文件保存后就會自動回復(fù)修正代碼不規(guī)范的地方。
這個插件還有其他代碼規(guī)范可以設(shè)置的地方,比如 PHP Mess Detector settings
、PHP Linter settings
、PHP Scheck settings
下次在研究其他幾個,目前是夠我用了,逃)
PhpStrom 中集成
配置 Code Sniffer
在 Settings -> Languages & Frameworks -> PHP -> Code Sniffer 中對 phpcs
進行配置
點擊 Configuration: Local
旁邊的 ...
,將當(dāng)前環(huán)境的 phpcs
執(zhí)行腳本所在路徑配置進去,旁邊有一個 Validate
按鈕可以進行驗證,其他兩個參數(shù)默認就好,這里也稍微說一下吧。
Maxumum number of messages per file[1...100]
:每個文件最多顯示不符合代碼規(guī)范的條數(shù),一般出現(xiàn)50個了那你有很多工作可以做了,其實10個就夠了,尤其對我這種代碼潔癖和強迫癥晚期的人來說一個足矣 。。。
Tool process timeout, sec[1...30]
:腳本執(zhí)行的超時時間
開啟驗證
在 Settings -> Editor -> Inspections 中進行開啟
找到 PHP -> PHP Code Sniffer validation 選項,對其打鉤,在右側(cè)進行詳細配置
我是將 Options -> Show warnings as: Error 開啟了,當(dāng)然你也可以選擇 Warnning,提示級別高一點能夠強迫自己,沒啥不好的吧~
Coding standard 依舊是選擇 PSR2,如果找不到這個選項,記得點一下緊挨著的刷新按鈕。
自動修復(fù)
我找了半天沒發(fā)現(xiàn) PhpStrom
有支持 phpcbf
的可用選項,所以只能通過 External Tools
來實現(xiàn)了。
在 Settings -> Tools -> External Tools 中進行添加,下面是我的一個示例,基本可以照搬 :)
Parameter | Value |
---|---|
Name | phpcbf |
Description | Automatically correct coding standard violations. |
Program | phpcbf |
Parameters | --standard=PSR2 "$FileDir$/$FileName$" |
現(xiàn)在就可以在菜單欄上的 Tools -> External Tools 中找到它并愉快的使用了。
亮哥,這樣很不方便誒。。。
那就加一個快捷鍵把。。。
在 Settings -> Keymap -> External Tools -> phpcbf 中進行添加快捷鍵操作,我設(shè)置的是 Option + F
,或者 Windows 上的 Alt + F
。
蜜汁延伸
之前沒用 phpcbf
,代碼自動修復(fù)使用的是 php-cs-fixer
,但后來發(fā)現(xiàn)兩者功能差不多,所以秉著能少一個包就少一個包的原則,放棄了 php-cs-fixer
。
關(guān)于如何用PHP_CodeSniffer檢查代碼規(guī)范就分享到這里了,希望以上內(nèi)容可以對大家有一定的幫助,可以學(xué)到更多知識。如果覺得文章不錯,可以把它分享出去讓更多的人看到。