avto-dev/php-cs-fixer

A tool to automatically fix PHP code style

, _(*1)

Автоматический Code Style Fixer для PHP

![Version][badge_packagist_version] ![Downloads count][badge_downloads_count] , _(*2)

Данный пакет для composer позволяет запускать автоматический Code Style Fixer для PHP с фиксированным набором правил, принятых в качестве основных для оформления исходного php кода., _(*3)

Install

Require this package with composer using the following command:, _(*4)

$ composer require avto-dev/php-cs-fixer "^1.6"

Installed composer is required (how to install composer)., _(*5)

Использование

В директории с вашим приложением выполните в терминале:, _(*6)

$ php ./vendor/bin/cs-fix

Опционально можете передать свои параметры запуска. При передаче параметра --config - все параметры, что формирует данный пакет - будут проигнорированы, и будет произведен запуск именно с теми параметрами, что будут переданы вами., _(*7)

Если вам требуется опционально переопределить переопределить параметры правил fixer-а, то создайте в корне вашего приложения файл .cs_rules.php, возвращающий ассоциированный массив правил (более подробно о самих правилах можешь ознакомиться по этой ссылке). При его наличии его контент будет мерджиться с конфигом пакета, опционально перекрывая необходимые правила. Иметь он должен следующий вид:, _(*8)

<?php

/**
 * CS Fixer Rules.
 *
 * @see https://github.com/FriendsOfPHP/PHP-CS-Fixer
 * @see https://mlocati.github.io/php-cs-fixer-configurator/
 */
return [
    '@PSR2'                  => true,
    '@PHP71Migration'        => true,
    'binary_operator_spaces' => [
        'operators' => [
            '='  => 'align_single_space',
            '=>' => 'align_single_space',
        ],
    ],
    'blank_line_after_namespace'         => true,
    'blank_line_after_opening_tag'       => true,
];

Так же в корне можете разместить файл .cs_excludes.php, содержащий пути директорий, которые следует исключить при обработке, вида:, _(*9)

<?php

/**
 * Excludes directories names.
 *
 * NOTE: excludes will works only for directories.
 */
return [
    'bootstrap',
    'storage',
    'vendor',
    'public',
    'resources',
];

Для переопределения пути файла кэша - установите в переменной окружения переменную с именем PHP_CS_FIX_CACHE_FILE_PATH, значение которой - необходимый путь. Например:, _(*10)

$ PHP_CS_FIX_CACHE_FILE_PATH=./.new.cache ./cs-fix

Более подробно о работе пакета - Look into the sources, Luke., _(*11)

Changes log

![Release date][badge_release_date] , _(*12)

Changes log can be found here., _(*13)

Support

![Issues][badge_issues] , _(*14)

If you will find any package errors, please, make an issue in current repository., _(*15)

License

This is open-sourced software licensed under the MIT License., _(*16)