How to use PHP_CodeSniffer to check code specifications (detailed explanation)

Some students may not have heard of this thing yet. Let me give you a brief introduction:

PHP_CodeSniffer is a code style detection tool. It contains two types of scripts, phpcs and phpcbf (GitHub address).

phpcs The script defines a series of code specifications for PHP, JavaScript, CSS files (usually using the official Code specification standards, such as PSR2 of PHP), can detect code that does not comply with code specifications and issue a warning or error (the error level can be set).

phpcbf The script can automatically correct the parts of the code format that do not comply with the standards. For example, the PSR2 specification requires a blank line at the end of each PHP file. Then running this script will automatically add a blank line at the end.

Installation

It is recommended to use composer to install:

composer global require "squizlabs/php_codesniffer=*"

After installation, it will be in Two soft links are generated in bin under the global Vendor directory:

phpcbf -> ../squizlabs/php_codesniffer/bin/phpcbf
phpcs -> ../squizlabs/php_codesniffer/bin/phpcs

If you don’t know where the global Vendor directory is, use Just issue this command:

composer global config bin-dir --absolute

Command line usage

At this point, you can actually use these two commands happily:

Oh, but if you want to use these two commands globally, you should make a soft link and put it in /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

Integration in Sublime Text

##Installing plug-ins

Package Control To install it properly, you definitely don’t have this The problem (inexplicable self-confidence, escape)

phpcs plug-in, and then open the Settings - User and Settings - Default of this plug-in. , copy all the contents of the latter to the former.

Configuration plug-in

php in the current environment

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

phpcs in the current environment

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

PSR2 code specification. You can also You can choose PSR1, PEAR, etc.

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

phpcbf in the current environment

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

cbf Script function

"phpcbf_on_save": true,

.php suffix and saving it, it will automatically reply to correct the irregularities in the code.

PHP Mess Detector settings, PHP Linter settings, PHP Scheck settings

Integrated in PhpStrom

Configure Code Sniffer

phpcs in Settings -> Languages ​​& Frameworks -> PHP -> Code Sniffer

Configuration: Local Next to ..., configure the path where the phpcs execution script of the current environment is located. There is a Validate button next to it. For verification, just leave the other two parameters as default. Let’s talk about it a little here.

Maxumum number of messages per file[1...100]: Each file displays the maximum number of messages that do not comply with the code specifications. Generally, 50 messages appear, so you have a lot of work to do. I have done it. In fact, 10 is enough, especially for people like me who are code-obsessed and in the late stages of obsessive-compulsive disorder. One is enough. . .

Tool process timeout, sec[1...30]: Timeout for script execution

Enable verification

Automatic repair

PhpStrom has an available option that supports phpcbf, so I can only pass External Tools is implemented.

You can now find it in Tools -> External Tools on the menu bar and use it happily.

Brother Liang, this is very inconvenient. . .

Then add a shortcut key. . .

Add shortcut keys in Settings -> Keymap -> External Tools -> phpcbf. I set Option F, or Alt F## on Windows. #.

Honey extension

phpcbf, the code is automatically repaired using php-cs -fixer, but later I found that the functions of the two are similar, so I gave up php-cs-fixer based on the principle of missing one package if possible.

PHP Video Tutorial"

The above is the detailed content of How to use PHP_CodeSniffer to check code specifications (detailed explanation). For more information, please follow other related articles on the PHP Chinese website!