xmarcos/php-cs-fixer-config

PHP Coding Standards Fixer Config

xmarcos/php-cs-fixer-config

, _(*1)

A PHP Coding Standards Fixer config with the rules i use in all my projects to verify and enforce coding standards., _(*2)

Requirements

PHP needs to be a minimum version of PHP 5.6.0., _(*3)

Installation

composer require --dev xmarcos/php-cs-fixer-config

Usage

Create a configuration file .php_cs.dist in the root of your project:, _(*4)

<?php

$config = new xmarcos\PhpCsFixer\Config\Php56();

$config
    ->setUsingCache(true)
    ->getFinder()
    ->in(__DIR__);

return $config;

⚠️ If setUsingCache is set to true, add .php_cs.cache to .gitignore., _(*5)

The default Finder configuration is:, _(*6)

$finder
    ->files()
    ->name('*.php')
    ->name('*.phpt')
    ->ignoreDotFiles(true)
    ->ignoreVCS(true)
    ->exclude('vendor');

To enforce a header_comment pass a string to the constructor of the config:, _(*7)

$header = <<<'EOF'
(c) 2017 Marcos Sader.

For the full copyright and license information, please view
the LICENSE file that was distributed with this source code.
EOF;

$config = new xmarcos\PhpCsFixer\Config\Php56($header);

...

Fixing Issues

Using Composer Scripts

You can use Composer Scripts to run the fixer:, _(*8)

"scripts": {
    "cs": "php-cs-fixer fix --config=.php_cs.dist -v --diff --dry-run",
    "cs-fix": "php-cs-fixer fix --config=.php_cs.dist -v --diff"
}

And then run:, _(*9)

# to run the rules but not change/fix any files.
composer cs

# to change/fix files.
composer cs-fix

Credits

Inspired by refinery29/php-cs-fixer-config., _(*10)

License

MIT License, _(*11)