novius/additional-php-cs-fixers

Some additional custom fixers for php-cs-fixer.

This library adds some custom fixers for php-cs-fixer (v2)., _(*1)

Installation

Add this package to your composer.json:, _(*2)

{
    "require-dev": {
        "novius/additional-php-cs-fixers": "~1.0.0"
    },
}

Modify your .php_cs:, _(*3)

• Include the composer autoload:

include 'vendor/autoload.php';

• Register the custom fixers:

return PhpCsFixer\Config::create()
    //...
    ->registerCustomFixers(SebC\AdditionalPhpCsFixers\Helper::getCustomFixers())

• Use the new rules as you wish:

$rules = [
    // ...
    'SebCAdditionalPhpCsFixers/disallow_unaliased_classes' => [
        'replace_namespaces' => [
            'Fuel\Core' => '',
            'Illuminate\Support\Facades' => '',
        ],
    ],
];

disallow_unaliased_classes rule:

This prevents any use of some specific namespace, and encourages to replace it with another., _(*4)

This is mainly useful/designed to force the use of aliased classes in some frameworks like Laravel or FuelPHP., _(*5)

As example, with the following rules configuration: - 'Fuel\Core' => '', will trigger an error everytime a class such as Fuel\Core\Config is directly called, and will suggest to replace it with Config - 'Illuminate\Support\Facades' => '', will prevent a call like Illuminate\Support\Facades\Validator and replace it with Validator - 'Some\Evil\Stuff' => 'OtherStuff', will replace Some\Evil\Stuff\Foo::myFunction() with OtherStuff\Foo::myFunction(), _(*6)

This also works with used namespaces., _(*7)

TODO

Unit tests, _(*8)