tiagohillebrandt / phpcs-diff
Detects coding standard violations based on a git diff.
Requires
- php: >=7.3.0
- ext-gettext: *
- ext-json: *
- ext-xml: *
- league/climate: ^3.8
- squizlabs/php_codesniffer: ^3.10
Requires (Dev)
- ext-mbstring: *
- ext-phar: *
- phpunit/php-code-coverage: ^9.2
- phpunit/phpunit: ^7.5.20 || ^8.5.21 || ^9.5.10
README
phpcs-diff
detects violations of a defined set of coding standards based on a git diff
.
Requirements
The latest version of phpcs-diff
requires PHP version 7.3.0 or later.
This project also depends on squizlabs/php_codesniffer
which is used internally to fetch the failed violations via phpcs
.
Finally, the league/climate
package is also installed. This is to deal with console output, but this dependency may be removed in a future release.
Installation
Composer
If you use Composer, you can install phpcs-diff
system-wide with the following command:
composer global require tiagohillebrandt/phpcs-diff
It's also possible to install phpcs-diff
as a development dependency in your project:
composer require --dev tiagohillebrandt/phpcs-diff
Or alternatively, you can manually include a dependency for tiagohillebrandt/phpcs-diff
in your composer.json
file. For example:
{ "require-dev": { "tiagohillebrandt/phpcs-diff": "^3.0" } }
You will then be able to run phpcs-diff from the vendor bin directory:
./vendor/bin/phpcs-diff
Git Clone
You can also download the phpcs-diff
source and create a symlink to your /usr/bin
directory:
git clone https://github.com/tiagohillebrandt/phpcs-diff.git
cd phpcs-diff
php bin/phpcs-diff main -v
You could also add a symlink to your /usr/bin
directory:
ln -s phpcs-diff/bin/phpcs-diff /usr/bin/phpcs-diff
Getting Started
Basic Usage
phpcs-diff <current-branch> <base-branch> -v
In this example, the current branch is compared to the main
branch. phpcs-diff
would execute the following diff statement behind the scenes:
git diff current-branch main
Please note:
- The
-v
flag is optional and provides verbose output during processing. - The
current-branch
parameter is optional. If not specified,phpcs-diff
will use the current commit hash obtained viagit rev-parse --verify HEAD
. - By default,
phpcs-diff
looks for theruleset.xml
file in the root directory of the project. To use a different ruleset file or standard, specify it using the--standard
option.
After running phpcs-diff
, the executable will return an output similar to the following:
########## START OF PHPCS CHECK ##########
module/Poject/src/Console/Script.php
- Line 28 (WARNING) Line exceeds 120 characters; contains 190 characters
- Line 317 (ERROR) Blank line found at end of control structure
########### END OF PHPCS CHECK ###########
Custom Standards and Ruleset Files
phpcs-diff
allows you to specify custom coding standards and ruleset files to suit your needs. For example, to use a predefined standard like PSR-12, you can run:
phpcs-diff --standard=PSR12 main
You can find a list of available standards in PHP_CodeSniffer's GitHub repository.
To apply a custom ruleset file, simply use:
phpcs-diff --standard=phpcs.xml.dist main
These options let you customize the code analysis to align with your specific coding standards and project requirements.
About
phpcs-diff
detects violations of a defined set of coding standards based on a git diff
. It uses phpcs
from the PHP_CodeSniffer project.
This project offers the following benefits:
- Accelerates your CI/CD pipeline by validating only the modified files instead of the entire codebase.
- Facilitates the migration of legacy codebases, enabling incremental compliance with coding standards without the risk of extensive changes at once.
This executable works by checking the changed lines, compared to the base branch, against all failed violations for those files. This ensures that any new or changed code will be compliant.
Over time, this approach will help your codebase become more compliant with the coding standard, and you may eventually reach a point where you can run phpcs
on the entire codebase.
Fork
This project is derived from the olivertappin/phpcs-diff library. It was created to ensure more frequent updates, as the original repository appears to be abandoned.