lasselehtinen/laravel-conventions-checker

grumphp config to automatically check conventions for Laravel projects

v6.0.0 2024-11-15 17:22 UTC

Requires

• larastan/larastan: ^3.0
• php-parallel-lint/php-parallel-lint: ^1.4
• phpmd/phpmd: ^2.10
• phpro/grumphp: ^2.3
• squizlabs/php_codesniffer: ^3.7

MIT

• Lasse Lehtinen

README

Configuration for grumphp that is checking on each commit that the committed code passes the unit tests, complies with the PSR2 coding style and static analysis check. It runs the following checks:

• Check that composer.json is valid
• Check that composer does not have any dependencies for known security vulnerabilities with Local PHP Security Checker
• Check that the PHP syntax is valid
• Check that commit does not contain any debugging (var_dump, die, exit)
• Check that code complies with the PSR2 coding style
• Perform static code analysis using phpstan
• Check code for unnecessary complexity etc. with PHP Mess Detector
• Check that unit tests pass with PHPUnit

Installation

1. Add checker to your composer.json:

composer require --dev lasselehtinen/laravel-conventions-checker

2. Download Local PHP Security Checker

Download a binary from the Releases page on Github, rename it to local-php-security-checker and make it executable.

3. Add path to grumphp configuration file to your composer.json's extra:

    "extra": {
        "grumphp": {
            "config-default-path": "vendor/lasselehtinen/laravel-conventions-checker/grumphp.yml"
        }
    }

Test suites

If you want to run the coding syntax, style or static analysis checks only, you can run the following commands:

vendor/bin/grumphp run --testsuite=syntax
vendor/bin/grumphp run --testsuite=style
vendor/bin/grumphp run --testsuite=static

License

The MIT License (MIT). Please see License File for more information.