Sane ruleset for the code in external standards for PHP_CodeSniffer.
This is an external ruleset for PHP CodeSniffer intended for use by sniff developers.
- PHPCSDev ruleset for sniff repos
Run the following from the root of your project:
composer require --dev phpcsstandards/phpcsdevcs:"^1.0"
If you work on several different sniff repos, you may want to install this toolset globally:
composer global require --dev phpcsstandards/phpcsdevcs:"^1.0"
Composer will automatically install dependencies and register the PHPCSDev and other external standards with PHP_CodeSniffer using the DealerDirect Composer PHPCS plugin.
Once this project is installed, you will see a new
PHPCSDev ruleset in the list of installed standards when you run
Important: This ruleset currently requires PHP_CodeSniffer >=
As sniffs developers will mostly work with the latest version of PHP_CodeSniffer, this shouldn't cause any problems.
Similarly, the CS check in automated CI runs should normally be run on a high PHPCS version for the best results.
PHPCSDev standard can be used by sniff developers to check the code style of their sniff repo code.
Often, sniff repos will use the code style of the standard they are adding. However, not all sniff repos are actually about code style.
So for those repos which need a basic standard which will still keep their code-base consistent, this standard should be useful.
The standard checks your code against the following:
- Compliance with PSR-12, with a few exceptions.
- Use of camelCase variable and function names.
- Use of normalized arrays.
- All files, classes, functions and properties are documented with a docblock and contain the minimally needed information.
- A number of arbitrary additional code style and QA checks.
- PHP cross-version compatibility, while allowing for the tokens back-filled by PHPCS itself.
Note: for optimal results, the project custom ruleset should set the
testVersionconfig variable. This is not done by default as config variables are currently difficult to overrule.
The ruleset can be used like any other ruleset and specific sniffs and settings can be added to or overruled from a custom project based ruleset.
phpcs . --standard=PHPCSDev
Add the following line to your project's
Contributions to this project are welcome. Just clone the repo, branch off from
master, make your changes, commit them and send in a pull request.
If unsure whether the changes you are proposing would be welcome, open an issue first to discuss your proposal.
This code is released under the GNU Lesser General Public License (LGPLv3). For more information, visit http://www.gnu.org/copyleft/lesser.html