symplify/easy-coding-standard

Use Coding Standard with 0-knowledge of PHP-CS-Fixer and PHP_CodeSniffer.

Installs: 643 005

Dependents: 218

Suggesters: 1

Stars: 418

Watchers: 16

Forks: 26

v6.1.0 2019-09-14 22:46 UTC

README

Build Status Downloads total

ECS-Run

Used by:

lmc.png space.png nette.png space.png shopsys.png space.png sylius.png

Features

Are you already using another tool?

Install

composer require symplify/easy-coding-standard --dev

Usage

1. Create Configuration and Setup Checkers

Create an ecs.yaml in your root directory and add Sniffs or Fixers you'd love to use.

Let's start with the most common one - array() => []:

# ecs.yaml
services:
    PhpCsFixer\Fixer\ArrayNotation\ArraySyntaxFixer:
        syntax: short

2. Run in CLI

# dry
vendor/bin/ecs check src

# fix
vendor/bin/ecs check src --fix

Tip: Do you want autocomplete too? Just use Symfony Plugin

ECS-Run

More Features

Use Prepared Checker Sets

There are prepared sets in /config/set directory that you can use:

You pick config in CLI with --config:

vendor/bin/ecs check src --config vendor/symplify/easy-coding-standard/config/set/clean-code.yaml

Too long? Try --set shortcut:

vendor/bin/ecs check src --set clean-code

or include more of them in config:

# ecs.yaml
parameters:
    sets:
        - 'clean-code'
        - 'psr12'

In case of custom coding standard and include, you can use %vendor_dir% or %current_working_dir% for:

# lmc-coding-standard.yaml
imports:
    - { resource: '%vendor_dir%/your-vendor/coding-standard/config/set/your-vendor.yaml' }
    # or
    - { resource: '%current_working_dir%/vendor/your-vendodr/coding-standard/config/set/your-vendor.yaml' }

That would load file always from vendor dir, no matter where you are.

Exclude Checkers

What if you add symfony set, but don't like PhpCsFixer\Fixer\PhpTag\BlankLineAfterOpeningTagFixer?

# ecs.yaml
parameters:
    sets:
        - 'symfony'

    skip:
        PhpCsFixer\Fixer\PhpTag\BlankLineAfterOpeningTagFixer: ~

Include Checkers Only for Some Paths

This feature is the exact opposite of skip. Do you want to run your rule only on new code? Limit it with only parameter:

services:
    Symplify\CodingStandard\Sniffs\Naming\AbstractClassNameSniff: ~

parameters:
    only:
        Symplify\CodingStandard\Sniffs\Naming\AbstractClassNameSniff:
            - 'src/NewCode/*'

Ignore What You Can't Fix

Sometimes, checker finds an error in code that inherits from code you can't change.

No worries! Just skip checker for this file:

parameters:
    skip:
        SlevomatCodingStandard\Sniffs\TypeHints\TypeHintDeclarationSniff:
            # relative path to file (you can copy this from error report)
            - 'packages/EasyCodingStandard/packages/SniffRunner/src/File/File.php'

            # or multiple files by path to match against "fnmatch()"
            - '*packages/CodingStandard/src/Sniffs/*/*Sniff.php'

You can also skip specific codes or messages that you know from PHP_CodeSniffer:

parameters:
    skip:
        # code to skip for all files
        SlevomatCodingStandard\Sniffs\TypeHints\TypeHintDeclarationSniff.UselessDocComment: ~

        # same syntax is used for skipping specific sniff messages
        'Cognitive complexity for method "addAction" is 13 but has to be less than or equal to 8.': ~

        # code to skip for specific files/patterns
        SlevomatCodingStandard\Sniffs\TypeHints\TypeHintDeclarationSniff.MissingTraversableParameterTypeHintSpecification:
            -  '*src/Form/Type/*Type.php'

Or just 2 files?

parameters:
    exclude_files:
        # generated files
        - 'lib/PhpParser/Parser/Php5.php'
        - 'lib/PhpParser/Parser/Php7.php'
        # or with fnmatch() pattern
        - '*/lib/PhpParser/Parser/Php*.php'

Do you need to Include other than *.php files?

# ecs.yaml
parameters:
    file_extensions:
        - 'php'
        - 'phpt'

FAQ

How can I see all loaded checkers?

vendor/bin/ecs show
vendor/bin/ecs show --config ...

How do I find checkers by group or type?

vendor/bin/ecs find
vendor/bin/ecs find symplify # for Symplify rules
vendor/bin/ecs find array # for array-related rules

How do I clear cache?

vendor/bin/ecs check src --clear-cache

How can I change the cache directory?

parameters:
    cache_directory: .ecs_cache # defaults to sys_get_temp_dir() . '/_easy_coding_standard/_changed_files_detector_tests'

How can I change the cache namespace?

parameters:
    cache_namespace: my_project_namespace # defaults to Strings::webalize(getcwd())'

This comes in handy when you want to apply ecs caching mechanism on your gitlab pipelines for example, where getcwd() may not always produce same cache key, thus introducing side effect, where cache may not be detected correctly.

Example getcwd() on gitlab CI:

  • /builds/0956d275/0/sites/my_project
  • /builds/0956d275/1/sites/my_project
  • /builds/0956d275/2/sites/my_project

Can I use tabs, 2 spaces or "\r\n" line endings?

parameters:
    indentation: "tab" # "spaces" by default, you can also use "  " (2 spaces), "    " (4 spaces) or "	" (tab)
    line_ending: "\r\n" # PHP_EOL by default; you can also use "\n"

Your IDE Integration

PHPStorm

EasyCodingStandard can be used as an External Tool

PHPStorm Configuration

Go to Preferences > Tools > External Tools and click + to add a new tool.

  • Name: ecs (Can be any value)
  • Description: easyCodingStandard (Can be any value)
  • Program: $ProjectFileDir$/vendor/bin/ecs (Path to ecs executable; On Windows path separators must be a \)
  • Parameters: check $FilePathRelativeToProjectRoot$ (append --fix to auto-fix)
  • Working directory: $ProjectFileDir$

Press Cmd/Ctrl + Shift + A (Find Action), search for ecs, and then hit Enter. It will run ecs for the current file.

To run ecs on a directory, right click on a folder in the project browser go to external tools and select ecs.

You can also create a keyboard shortcut in Preferences > Keymap to run ecs.

Visual Studio Code

EasyCodingStandard for Visual Studio Code extension adds support for running EasyCodingStandard inside the editor.

Tool Integration

Tool Extension Description
GrumPHP nlubisch/grumphp-easycodingstandard Provides a new task for GrumPHP which runs ECS

Contributing

Send issue or pull-request to main repository.