README.md

MO4 CodeSniffer ruleset

Provides a PHP CodeSniffer ruleset for the MO4 coding standard

MO4 Coding Standard

The MO4 Coding Standard is an extension of the Symfony Coding Standard and adds following rules:

MO4.Arrays.ArrayDoubleArrowAlignment

• In associative arrays, the => operators must be aligned.
• In arrays, the key and => operator must be on the same line.

MO4.Arrays.MultiLineArray

• In multi line arrays, the opening bracket must be followed by newline.
• In multi line arrays, the closing bracket must be in own line.
• In multi line arrays, the elements must be indented.

MO4.Commenting.PropertyComment

• doc blocks of class properties must be multiline and have exactly one @var annotation

MO4.Formatting.AlphabeticalUseStatements

• use statements must be sorted lexicographically. The order function can be configured.

Configuration

The order property of the MO4.Formatting.AlphabeticalUseStatements sniff defines which function is used for ordering.

Possible values for order:

• dictionary (default): based on strcmp, the namespace separator precedes any other character

  use Doctrine\ORM\Query;
  use Doctrine\ORM\Query\Expr;
  use Doctrine\ORM\QueryBuilder;

• string: binary safe string comparison using strcmp

  use Doctrine\ORM\Query;
  use Doctrine\ORM\QueryBuilder;
  use Doctrine\ORM\Query\Expr;
  
  use ExampleSub;
  use Examples;

• string-locale: locale based string comparison using strcoll
• string-case-insensitive: binary safe case-insensitive string comparison strcasecmp

  use Examples;
  use ExampleSub;

To change the sorting order for your project, add this snippet to your custom ruleset.xml:

<rule ref="MO4.Formatting.AlphabeticalUseStatements">
    <properties>
        <property name="order" value="string-locale"/>
    </properties>
</rule>

MO4.Formatting.UnnecessaryNamespaceUsage

• The imported class name must be used, when it was imported with a use statement.

MO4.Strings.VariableInDoubleQuotedString

• Interpolated variables in double quoted strings must be surrounded by { }, e.g. {$VAR} instead of $VAR.

MO4.WhiteSpace.ConstantSpacing

• const must be followed by a single space.

MO4.WhiteSpace.MultipleEmptyLines

• No more than one empty consecutive line is allowed. Taken from mediawiki/mediawiki-codesniffer.

Further rules (imported from other standards)

• See MO4/ruleset.xml, which has each imported rule commented.

Note that with this ruleset, the following Symfony Coding Standard rules are not enforced:

• "add doc blocks for all classes": the doc block for classes can be omitted, if they add no value
• "the license block has to be present at the top of every PHP file, before the namespace": the license block can be omitted

Most of the issues can be auto-fixed with phpcbf.

Requires

• PHP
• Composer is optional, but strongly recommended

Installation

Composer

Using Composer is the preferred way.

1. Add the MO4 coding standard to composer.json

    composer require --dev mayflower/mo4-coding-standard
   

2. Profit

    ./vendor/bin/phpcs --standard=MO4 path/to/my/file.php
   

3. Optionally, you might set MO4 as default coding standard

    ./vendor/bin/phpcs --config-set default_standard MO4
   

Source

1. Checkout this repository

    git clone https://github.com/mayflower/mo4-coding-standard.git
   

2. Install dependencies

    composer install
   

3. Check, that Symfony and MO4 are listed as coding standards

    ./vendor/bin/phpcs -i
   

4. Profit

    ./vendor/bin/phpcs --standard=MO4 path/to/my/file.php
   

5. Optionally, you might set MO4 as default coding standard

    ./vendor/bin/phpcs --config-set default_standard MO4
   

Troubleshooting

If phpcs complains that MO4 is not installed, please check the installed coding standards with phpcs -i and that installed_paths is set correctly with phpcs --config-show

Dependencies

• PHP CodeSniffer
• David Joos's Symfony Coding Standard
• Composer installer for PHP_CodeSniffer coding standards
• Slevomat Coding Standard

Contributing

See CONTRIBUTING.md for information.

License

This project is licensed under the MIT license. See the LICENSE file for details.