Skip to content
PHP_CodeSniffer tokenizes PHP, JavaScript and CSS files and detects violations of a defined set of coding standards.
Branch: master
Clone or download
gsherwood Fixed bug #2504 : Generic.WhiteSpace.ScopeIndent false positives with…
… nested arrays and nowdoc string

Also removed some duplicated code as it was always run twice and no tests needed it
Latest commit 12b8772 May 14, 2019
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
bin Simplify Windows BAT files Jul 18, 2017
scripts Minor improvement to ValidatePEARPackageXML script Mar 24, 2019
src Fixed bug #2504 : Generic.WhiteSpace.ScopeIndent false positives with… May 14, 2019
tests Native PHPCS ruleset: ignore Utility method test case files Feb 24, 2019
.gitattributes Re-adding tests to git exports (ref #548) Mar 22, 2017
.gitignore gitignore: composer.lock that is already missing added Jun 24, 2016
.travis.yml Try and get snapshots running again Apr 11, 2019
CONTRIBUTING.md Fixed old phpcs command + output info Sep 8, 2017
CodeSniffer.conf.dist Fix typo in config. Jun 11, 2013
README.md Typos in README.md Feb 7, 2019
autoload.php Girlscouting: Use FQN in @param tags and add missing type declaration Jan 6, 2019
composer.json Update homepage link (ref #2417) Feb 15, 2019
licence.txt Included whole licence inside included licence file + standardise lic… Aug 13, 2012
package.xml Fixed bug #2504 : Generic.WhiteSpace.ScopeIndent false positives with… May 14, 2019
php5-testingConfig.ini Changed coding standards + ini files for testing Aug 2, 2016
php7-testingConfig.ini Changed coding standards + ini files for testing Aug 2, 2016
phpcs.xml.dist Native PHPCS ruleset: ignore Utility method test case files Feb 24, 2019
phpcs.xsd Support property-level extending for array properties Sep 5, 2018
phpstan.neon Add basic run of PHPStan (ref #2201) Jan 17, 2019
phpunit.xml.dist Changelog + PEAR support for #1384 Sep 8, 2017

README.md

About

PHP_CodeSniffer is a set of two PHP scripts; the main phpcs script that tokenizes PHP, JavaScript and CSS files to detect violations of a defined coding standard, and a second phpcbf script to automatically correct coding standard violations. PHP_CodeSniffer is an essential development tool that ensures your code remains clean and consistent.

Build Status Code consistency Join the chat at https://gitter.im/squizlabs/PHP_CodeSniffer

Requirements

PHP_CodeSniffer requires PHP version 5.4.0 or greater, although individual sniffs may have additional requirements such as external applications and scripts. See the Configuration Options manual page for a list of these requirements.

If you're using PHP_CodeSniffer as part of a team, or you're running it on a CI server, you may want to configure your project's settings using a configuration file.

Installation

The easiest way to get started with PHP_CodeSniffer is to download the Phar files for each of the commands:

# Download using curl
curl -OL https://squizlabs.github.io/PHP_CodeSniffer/phpcs.phar
curl -OL https://squizlabs.github.io/PHP_CodeSniffer/phpcbf.phar

# Or download using wget
wget https://squizlabs.github.io/PHP_CodeSniffer/phpcs.phar
wget https://squizlabs.github.io/PHP_CodeSniffer/phpcbf.phar

# Then test the downloaded PHARs
php phpcs.phar -h
php phpcbf.phar -h

Composer

If you use Composer, you can install PHP_CodeSniffer system-wide with the following command:

composer global require "squizlabs/php_codesniffer=*"

Make sure you have the composer bin dir in your PATH. The default value is ~/.composer/vendor/bin/, but you can check the value that you need to use by running composer global config bin-dir --absolute.

Or alternatively, include a dependency for squizlabs/php_codesniffer in your composer.json file. For example:

{
    "require-dev": {
        "squizlabs/php_codesniffer": "3.*"
    }
}

You will then be able to run PHP_CodeSniffer from the vendor bin directory:

./vendor/bin/phpcs -h
./vendor/bin/phpcbf -h

Phive

If you use Phive, you can install PHP_CodeSniffer as a project tool using the following commands:

phive install phpcs
phive install phpcbf

You will then be able to run PHP_CodeSniffer from the tools directory:

./tools/phpcs -h
./tools/phpcbf -h

PEAR

If you use PEAR, you can install PHP_CodeSniffer using the PEAR installer. This will make the phpcs and phpcbf commands immediately available for use. To install PHP_CodeSniffer using the PEAR installer, first ensure you have installed PEAR and then run the following command:

pear install PHP_CodeSniffer

Git Clone

You can also download the PHP_CodeSniffer source and run the phpcs and phpcbf commands directly from the Git clone:

git clone https://github.com/squizlabs/PHP_CodeSniffer.git
cd PHP_CodeSniffer
php bin/phpcs -h
php bin/phpcbf -h

Documentation

The documentation for PHP_CodeSniffer is available on the Github wiki.

Issues

Bug reports and feature requests can be submitted on the Github Issue Tracker.

Contributing

See CONTRIBUTING.md for information.

Versioning

PHP_CodeSniffer uses a MAJOR.MINOR.PATCH version number format.

The MAJOR version is incremented when:

  • backwards-incompatible changes are made to how the phpcs or phpcbf commands are used, or
  • backwards-incompatible changes are made to the ruleset.xml format, or
  • backwards-incompatible changes are made to the API used by sniff developers, or
  • custom PHP_CodeSniffer token types are removed

The MINOR version is incremented when:

  • new backwards-compatible features are added to the phpcs and phpcbf commands, or
  • backwards-compatible changes are made to the ruleset.xml format, or
  • backwards-compatible changes are made to the API used by sniff developers, or
  • new sniffs are added to an included standard

NOTE: Backwards-compatible changes to the API used by sniff developers will allow an existing sniff to continue running without producing fatal errors but may not result in the sniff reporting the same errors as it did previously without changes being required.

The PATCH version is incremented when:

  • backwards-compatible bug fixes are made

NOTE: As PHP_CodeSniffer exists to report and fix issues, most bugs are the result of coding standard errors being incorrectly reported or coding standard errors not being reported when they should be. This means that the messages produced by PHP_CodeSniffer, and the fixes it makes, are likely to be different between PATCH versions.

You can’t perform that action at this time.