jumptwentyfour/php-coding-standards

Coding standards for our PHP applications.

V3.0.0 2024-07-05 09:58 UTC

Requires

• php: ^8.0
• nikic/php-parser: ^5.0
• slevomat/coding-standard: ^8.0
• symplify/easy-coding-standard: ^12.3.0

MIT

• Alex Williams
• Daniel Newns
• Mante Balzaraviciute

• php
• standards
• code standards

README

At Jump24 we pride ourselves on keeping our coding standards under tight control, this is why we built this package.

Installation

To install this package, simply use composer:

composer require jumptwentyfour/php-coding-standards

Setup

Once installed you will have access to our PHPStan configuration file, which you can easily add to your phpstan.neon:

includes:
    - ./vendor/jumptwentyfour/php-coding-standards/phpstan.neon

Running

To run the code standard checks, simply run the following command:

./vendor/bin/ecs check

This will run the configured code standard checks for you, giving you feedback on where your code is and what improvements you need to implement

Extending

These code standards are extendable, all you need to do is create your own ecs.php in the root directory of your project:

<?php

declare(strict_types=1);

use JumpTwentyFour\PhpCodingStandards\Support\ConfigHelper;
use Symplify\EasyCodingStandard\Config\ECSConfig;
use Symplify\EasyCodingStandard\ValueObject\Option;

return static function (ECSConfig $ecsConfig): void {
    $ecsConfig->import(__DIR__ . '/vendor/jumptwentyfour/php-coding-standards/ecs.php');

    $parameters = $ecsConfig->parameters();
    
    $parameters->set(Option::PATHS, [
        __DIR__ . '/app',
        __DIR__ . '/tests',
    ]);
    
    $ecsConfig->skip(array_merge(ConfigHelper::make($ecsConfig)->getParameter(Option::SKIP), [
        UnusedParameterSniff::class => [
            __DIR__ . '/app/Console/Kernel.php',
            __DIR__ . '/app/Exceptions/Handler.php',
        ],
        'Unused parameter $attributes.' => [
            __DIR__ . '/database/*.php',
        ],
        CamelCapsFunctionNameSniff::class => [
            '/tests/**',
        ],
    ]));
};