如何用PHP_CodeSniffer檢查代碼規范

這篇文章將為大家詳細講解有關如何用PHP_CodeSniffer檢查代碼規范，文章內容質量較高，因此小編分享給大家做個參考，希望大家閱讀完這篇文章后對相關知識有一定的了解。

PHP_CodeSniffer 是一個代碼風格檢測工具。它包含兩類腳本，phpcs 和 phpcbf（GitHub地址）。

phpcs 腳本對 PHP、JavaScript、CSS 文件定義了一系列的代碼規范（通常使用官方的代碼規范標準，比如 PHP 的 PSR2），能夠檢測出不符合代碼規范的代碼并發出警告或報錯（可設置報錯等級）。

phpcbf 腳本能自動修正代碼格式上不符合規范的部分。比如 PSR2 規范中對每一個 PHP 文件的結尾都需要有一行空行，那么運行這個腳本后就能自動在結尾處加上一行空行。

安裝

推薦使用 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，將后者的內容全部復制到前者。

配置插件

將以下這幾個配置項配置一下：

當前環境中 php 的執行路徑

"phpcs_php_prefix_path": "/usr/bin/php",

當前環境中 phpcs 的執行路徑

"phpcs_executable_path": "~/.composer/vendor/bin/phpcs",

執行腳本時額外添加的參數，一般以 PSR2 代碼規范作為標準，你也可以選擇 PSR1、PEAR 等

"phpcs_additional_args": {
    "--standard": "PSR2",
    "-n": ""
},

當前環境中 phpcbf 的執行路徑

"phpcbf_executable_path": "/Users/stephen/.composer/vendor/bin/phpcbf",

開啟保存就執行 cbf 腳本功能

"phpcbf_on_save": true,

現在就可以愉快的玩耍了，編輯完 .php 后綴的文件保存后就會自動回復修正代碼不規范的地方。

這個插件還有其他代碼規范可以設置的地方，比如 PHP Mess Detector settings、PHP Linter settings、PHP Scheck settings

下次在研究其他幾個，目前是夠我用了，逃)

PhpStrom 中集成

配置 Code Sniffer

在 Settings -> Languages & Frameworks -> PHP -> Code Sniffer 中對 phpcs 進行配置

點擊 Configuration: Local 旁邊的 ...，將當前環境的 phpcs 執行腳本所在路徑配置進去，旁邊有一個 Validate 按鈕可以進行驗證，其他兩個參數默認就好，這里也稍微說一下吧。

Maxumum number of messages per file[1...100]：每個文件最多顯示不符合代碼規范的條數，一般出現50個了那你有很多工作可以做了，其實10個就夠了，尤其對我這種代碼潔癖和強迫癥晚期的人來說一個足矣  。。。

Tool process timeout, sec[1...30]：腳本執行的超時時間

開啟驗證

在 Settings -> Editor -> Inspections 中進行開啟

找到 PHP -> PHP Code Sniffer validation 選項，對其打鉤，在右側進行詳細配置

我是將 Options -> Show warnings as: Error 開啟了，當然你也可以選擇 Warnning，提示級別高一點能夠強迫自己，沒啥不好的吧~

Coding standard 依舊是選擇 PSR2，如果找不到這個選項，記得點一下緊挨著的刷新按鈕。

自動修復

我找了半天沒發現 PhpStrom 有支持 phpcbf 的可用選項，所以只能通過 External Tools 來實現了。

在 Settings -> Tools -> External Tools 中進行添加，下面是我的一個示例，基本可以照搬 :)

現在就可以在菜單欄上的 Tools -> External Tools 中找到它并愉快的使用了。

亮哥，這樣很不方便誒。。。

那就加一個快捷鍵把。。。

在 Settings -> Keymap -> External Tools -> phpcbf 中進行添加快捷鍵操作，我設置的是 Option + F，或者 Windows 上的 Alt + F。

蜜汁延伸

之前沒用 phpcbf，代碼自動修復使用的是 php-cs-fixer，但后來發現兩者功能差不多，所以秉著能少一個包就少一個包的原則，放棄了 php-cs-fixer。

關于如何用PHP_CodeSniffer檢查代碼規范就分享到這里了，希望以上內容可以對大家有一定的幫助，可以學到更多知識。如果覺得文章不錯，可以把它分享出去讓更多的人看到。