phpcsstandards / phpcsdevcs
Coding Standards ruleset for the code in external standards for PHP_CodeSniffer.
Fund package maintenance!
Open Collective
PHPCSStandards
jrfnl
Installs: 68 804
Dependents: 10
Suggesters: 0
Security: 0
Stars: 9
Watchers: 4
Forks: 2
Open Issues: 4
Type:phpcodesniffer-standard
Requires
- php: >=5.4
- dealerdirect/phpcodesniffer-composer-installer: ^0.4.1 || ^0.5 || ^0.6.2 || ^0.7 || ^1.0
- phpcompatibility/php-compatibility: ^9.0.0 || ^10.0.0
- squizlabs/php_codesniffer: ^3.6.2
Requires (Dev)
- roave/security-advisories: dev-master
README
This is an external ruleset for PHP CodeSniffer intended for use by sniff developers.
Installation
Composer Project-based Installation
Run the following from the root of your project:
composer config allow-plugins.dealerdirect/phpcodesniffer-composer-installer true composer require --dev phpcsstandards/phpcsdevcs:"^1.0"
Composer Global Installation
If you work on several different sniff repos, you may want to install this toolset globally:
composer global config allow-plugins.dealerdirect/phpcodesniffer-composer-installer true 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 Composer PHPCS plugin.
PHPCSDev ruleset for sniff repos
Once this project is installed, you will see a new PHPCSDev
ruleset in the list of installed standards when you run phpcs -i
.
Important: This ruleset currently requires PHP_CodeSniffer >= 3.6.2+
.
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.
The 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
testVersion
config 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.
Using the ruleset from the command line
phpcs . --standard=PHPCSDev
Using the ruleset from within a project based ruleset
Add the following line to your project's phpcs.xml.dist
file:
<rule ref="PHPCSDev"/>
Contributing
Contributions to this project are welcome. Just clone the repo, branch off from main
, 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.
License
This code is released under the GNU Lesser General Public License (LGPLv3). For more information, visit http://www.gnu.org/copyleft/lesser.html