endouble/symfony3-custom-coding-standard

Customized CodeSniffer ruleset for the Symfony3 projects

2.17 2017-03-22 10:44 UTC

Requires

• squizlabs/php_codesniffer: ~2.0

MIT

• David Joos

• phpcs
• Coding Standard
• symfony3

README

This is a fork of https://github.com/djoos/Symfony2-coding-standard These are the Symfony2 standards, but tweaked to meet some needs we have in our CSB project, for example to comply with PSR-12 for PHP 7

Installation

Composer

This standard can be installed with the Composer dependency manager.

1. Add the repository to your composer.json:

 "repositories": [
        {
            "type": "vcs",
            "url": "[e-mail]:Endouble/Symfony3-custom-coding-standard"
        }

1. Add the coding standard as a dependency of your project

 "require-dev": {
        "endouble/symfony3-custom-coding-standard": "^2.10"
    },

1. Add the coding standard to the PHP_CodeSniffer install path

The path is relative to the php_codesniffer install path. This is important to make it work both in your vagrant, local machine and PHPStorm

    bin/phpcs --config-set installed_paths ../../endouble/symfony3-custom-coding-standard

1. Check the installed coding standards for "Symfony2"

    bin/phpcs -i
   

2. Done!

   bin/phpcs --standard=Symfony3Custom /path/to/code
   

3. (optional) Set up PHPStorm

• configure code sniffer under Languages & Frameworks -> PHP -> Code Sniffer
• Go to Editor -> Inspections -> PHP Code sniffer, refresh the standards and select Symfony3Custom

Customizations

The following adjustments have been made to the original standard:

In Sniff/WhiteSpace/AssignmentSpacingSniff:

• Added an exception for declare(strict_types=1); to comply with PSR-12

In Sniff/WhiteSpace/FunctionalClosingBraceSniff:

• copied from Squiz and adapted to have no blank line at the end of a function

In Sniff/Commenting/FunctionCommentSniff:

• check for 1 blank line above a docblock
• don't check docblocks for test and setUp methods (PHPunit, would be blank)
• do check protected and private methods for docblocks

In Sniff/NamingConventions/ValidClassNameSniff

• remove the abstract class name rule

In ruleset.xml

• Disabled the class comment rule
• Changed the concatenation spacing rule, for readability, to require 1 space around concatenation dot, instead of no spaces as the Symfony standard requires.
• Re-enabled the blank line check from superfluousWhitespace (disabled in PSR-2)