lin3s/php-cs-fixer-config

PHP linting tool using PHP CS Fixer for LIN3S projects

LIN3S PHP CS Fixer Config

PHP linting tool using PHP CS Fixer for LIN3S projects, _(*1)

, _(*2)

It's based on kreta/php-cs-fixer-config., _(*3)

Installation

$ composer require --dev lin3s/php-cs-fixer-config

Usage

Configuration

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

<?php

/*
 * This file is part of the PhpCsFixerConfig project.
 *
 * Copyright (c) 2017-present LIN3S <info@lin3s.com>
 *
 * For the full copyright and license information, please view the LICENSE
 * file that was distributed with this source code.
 */

declare(strict_types=1);

use LIN3S\PhpCsFixerConfig\Lin3sConfig;

$config = new Lin3sConfig('LIN3S awesome project', '2017', 'project');
$config->getFinder()->in(__DIR__ . '/src');

$cacheDir = getenv('TRAVIS') ? getenv('HOME') . '/.php-cs-fixer' : __DIR__;

$config->setCacheFile($cacheDir . '/.php_cs.cache');

return $config;

In case your project uses [PhpSpec][3] BDD test framework, also create a .phpspec_cs file in the root of your project:, _(*5)

<?php

/*
 * This file is part of the PhpCsFixerConfig project.
 *
 * Copyright (c) 2017-present LIN3S <info@lin3s.com>
 *
 * For the full copyright and license information, please view the LICENSE
 * file that was distributed with this source code.
 */

declare(strict_types=1);

use LIN3S\PhpCsFixerConfig\Lin3sConfig;

$config = new Lin3sConfig('LIN3S awesome project', '2017', 'project', true);
$config->getFinder()
    ->in(__DIR__ . '/spec')
    ->name('*Spec.php');

$cacheDir = getenv('TRAVIS') ? getenv('HOME') . '/.php-cs-fixer' : __DIR__;

$config->setCacheFile($cacheDir . '/.php_cs.cache');

return $config;

Git

Add .php_cs.cache (this is the cache file created by php-cs-fixer) to .gitignore:, _(*6)

/vendor
/.php_cs.cache

Composer

Add the following scripts in the composer.json file:, _(*7)

(...)

"scripts": {
    (...)

    "cs": [
        "php-cs-fixer fix --config=.php_cs -v",
        "php-cs-fixer fix --config=.phpspec_cs -v"
    ]
},

Travis

Update your .travis.yml to cache the php_cs.cache file:, _(*8)

cache:
  directories:
    - $HOME/.php-cs-fixer

Then run php-cs-fixer in the script section:, _(*9)

script:
  - vendor/bin/php-cs-fixer fix --config=.php_cs --verbose --diff --dry-run
  - vendor/bin/php-cs-fixer fix --config=.phpspec_cs --verbose --diff --dry-run

Fixing issues

Manually

If you need to fix issues locally and if you previously added the composer script, just run:, _(*10)

$ composer run-script cs

otherwise you can run:, _(*11)

$ vendor/bin/php-cs-fixer fix -v
$ vendor/bin/php-cs-fixer fix -v --config=.phpspec_cs 

Licensing Options

, _(*12)