This is a plugin for Sublime Text which provides checkstyle reports using the following tools (all optional):

• PHP_CodeSniffer (phpcs)
• Linter (php -l)
• PHP Mess Detector (phpmd)

You can also configure the plugin to fix the issues using either

• PHP Coding Standards Fixer (php-cs-fixer)
• PHP Code Beautifier (phpcbf) application

Requirements for this plugin, should you want all the options to work:

• PHP_CodeSniffer 3.5+
• PHPMD 2.8+
• PHP CS Fixer 2.6+

This plugin has been tested on:

• Mac OS X 10.8.2
• Ubuntu 11.10
• Windows 7
• Sublime Text 2
• Sublime Text 3
• Sublime Text 4

It may work with other versions, but we cannot confirm that.

Use Sublime Text’s Package Control (Tools -> Command Palette -> Package Control: Install Package -> Phpcs) to install this plugin. This is the recommended installation path.

Or

Simply checkout the git repo into "~/Library/Application Support/Sublime Text/Packages/ or the equivalent folder on Windows or Linux.

cd ~/Library/Application\ Support/Sublime\ Text/Packages/
git clone git://github.com/benmatselby/sublime-phpcs.git Phpcs

In both cases, you may need to then configure the following with the actual path to the application:

• "phpcs_php_path"
• "phpcs_executable_path"
• "phpmd_executable_path"
• "php_cs_fixer_executable_path"

They are optional for the plugin. The path needs to include the application such as /usr/local/bin/phpcs.

In order to get the path of the application (On a Mac/Linux based environment), you can use:

which phpcs
which phpmd
which php-cs-fixer
which phpcbf

• Ability to run PHP_CodeSniffer
• Ability to run php -l on the open file
• Ability to run PHP Mess Detector on the open file
• Show cached results from PHP_CodeSniffer in open file
• Show errors in the Quick Panel
• Show errors in the Gutter
• Highlight the errors in the editor
• Show the error for a given line in the status bar
• Ability to specify the regular expression of the linter errors
• Ability to specify the location of the PHP_CodeSniffer application
• Ability to specify the location of the PHP Mess Detector application
• Ability to run the PHP Coding Standards Fixer tool which fixes most issues in your code when you want to follow the PHP coding standards as defined in the PSR-1 and PSR-2 documents
• Ability to run the PHP Code Beautifier tool which fixes most issues in your code when you want to follow PHP coding standards

Once you have right clicked on a file and selected "PHP CodeSniffer" > "Sniff this file..." you will get the output as shown below (depending on the settings you have defined):

You can also define the configuration for the following settings, be it for a project, user settings or the default settings:

• show_debug – Do you want the debug information to be sent to the console?
• extensions_to_execute – Which filetypes do you want the plugin to execute for?
• extensions_to_blacklist – Override the extensions_to_execute in case you have a sub extension such as twig.php etc.
• phpcs_execute_on_save – Do you want the code sniffer plugin to run on file save for php files?
• phpcs_show_errors_on_save – Do you want the errors to be displayed in quick_panel on save?
• phpcs_show_gutter_marks – Do you want the errors to be displayed in the gutter?
• phpcs_outline_for_errors – Do you want the errors to be highlighted in the editor?
• phpcs_show_errors_in_status – Do you want the errors to be displayed in status bar when clicking on the line with error?
• phpcs_show_quick_panel – Do you want the errors to be displayed in the quick panel?
• phpcs_php_prefix_path – Needed on windows for phar based applications. Also if you cannot make phar executable. Avoid if possible
• phpcs_commands_to_php_prefix – List of commands you want the php path to prefix. This would be useful, if you have some commands as a phar that cannot be run without the php prefix, and others using native command.
• phpcs_icon_scope_color - What colour to stylise the icon. This needs knowledge of theming of Sublime Test, as it uses scope colours from the theme to "tint" the dot icon. See here

• phpcs_sniffer_run – Do you want the PHPCS checker to run?
• phpcs_command_on_save – Do you want the command to execute on save?
• phpcs_executable_path – The path to the phpcs executable. If empty string, use PATH to find it
• phpcs_additional_args – This is the extra information you want to pass to the phpcs command. For example which "standard" you want to run, and if you want to show warnings or not

• php_cs_fixer_on_save – Do you want to run the fixer on file save?
• php_cs_fixer_show_quick_panel – Do you want the quick panel to display on execution?
• php_cs_fixer_executable_path – The path to the php-cs-fixer application.
• php_cs_fixer_additional_args – This is the extra information you want to pass to the php-cs-fixer command. For example which "fixers" you want to run

• phpcbf_on_save – Do you want to run the fixer on file save?
• phpcbf_show_quick_panel – Do you want the quick panel to display on execution?
• phpcbf_executable_path – The path to the phpcbf application.
• phpcbf_additional_args – This is the extra information you want to pass to the phpcbf command. For example which "standard" to use in order to fix the issues

• phpcs_linter_run – Do you want the PHP linter to run?
• phpcs_linter_command_on_save – Do you want the command to execute on save?
• phpcs_php_path – The path to the PHP executable. If empty string, use PATH to find it
• phpcs_linter_regex – The regex for the PHP linter output

• phpmd_run – Do you want the PHPMD to run? Off by default
• phpmd_command_on_save – Do you want the command to execute on save?
• phpmd_executable_path – The path to the phpmd executable. If empty string, use PATH to find it
• phpmd_additional_args – This is the extra information you want to pass to the phpmd command. For example which "rulesets" you want to run

Your .project file should look something like this:

{
 "folders": [{}],
 "settings": {
 "phpcs": {
 "phpcs_additional_args": {
 "--standard": "/path/to/.composer/vendor/drupal/coder/coder_sniffer/Drupal"
 }
 }
 }
}

Of course this is a example to apply Drupal code sniffer. This could be anything. Whatever you can have on this package settings it can be overwritten under the settings -> phpcs

• This seems to be an issue you may get with regards to wrapper scripts.
• Please make sure that the application/script you are referencing has the correct shebang line, as per GH-79

• Well, first of all you need to check that you have PHP_CodeSniffer, and if being used, the phpmd application.
• If you have these applications installed, then it sounds like those applications are not in your PATH, or cannot be found in your PATH by the Python runtime, so configure "phpcs_php_path", "phpcs_executable_path", "phpmd_executable_path" and "php_cs_fixer_executable_path" with the actual paths to those applications

• It sounds like your path settings are incorrect.
• You need to make sure that when you specifiy the path you include the entire path including the application

$ which phpcs
/usr/local/bin/phpcs

• That entire output is the path you need in your configs.

If you have installed php-cs-fixer, phpmd or phpcs via homebrew then please make sure that you define the "_executable_path" option to the .phar application and not the wrapper script that is placed in your bin folder, as this will cause odd behaviour.

The following is a list of commands that you can bind to a keyboard shortcut:

• phpcs_fix_this_file
• phpcs_clear_sniffer_marks
• phpcs_goto_next_error
• phpcs_show_previous_errors
• phpcs_sniff_this_file

In order to achieve this you need to add the following to one of your key bindings settings file:

{ "keys": ["ctrl+super+t"], "command": "phpcs_clear_sniffer_marks" }

To decide which "Fixer" to use, you can do:

{ "keys": ["super+k", "super+f"], "command": "phpcs_fix_this_file", "args": {"tool": "CodeBeautifier"}},

or

{ "keys": ["super+k", "super+f"], "command": "phpcs_fix_this_file", "args": {"tool": "Fixer"}},

You can then change the ctrl+super+t combination to something of your choosing.