mito/yii2-coding-standards

Mito Yii 2 coding standards

Monday, November 20, 2017
by mito
Repository
7 Watchers
3 Stars
8,197 Installations

PHP
6 Dependents
0 Suggesters
0 Forks
0 Open issues
21 Versions
18 % Grown

The README.md

Mito Yii 2 Coding Standards

This repository contains Mito's coding standards for Yii 2 based applications., _(*1)

, _(*2)

Getting the code

You can get code style definition using one of the following methods., _(*3)

Clone hellowearemito/yii2-coding-standards repository:

$ git clone git://github.com/hellowearemito/yii2-coding-standards.git

Install using composer:

$ composer require mito/yii2-coding-standards:"~2.0.0@beta"

PHP_Codesniffer

This repository contains five phpcs standards:, _(*4)

Application: for normal class files.
Views: for view files, requires using curly braces for control structures.
ViewsAlternate: for view files, requires using alternate syntax for control structures.
ViewsMixed: for view files, allows both curly braces and alternate syntax.
Others: for other files, such as configuration files and migration classes.

These standards are based on PSR2 and Yii 2's coding standard, with some additions and improvements., _(*5)

The Views standards disable some rules that cause problems when mixing php with html, and therefore cannot fully check view files and cannot fix all problems in them, so be careful when using phpcbf with view files., _(*6)

For a full description of the rules, see docs/rules.md., _(*7)

Using the standards

After CodeSniffer is installed, you can launch it with a custom standard using the following syntax:, _(*8)

$ ./vendor/bin/phpcs --extensions=php --standard=vendor/mito/yii2-coding-standards/Application .

To automatically fix most issues, use phpcbf:, _(*9)

$ ./vendor/bin/phpcbf --extensions=php --standard=vendor/mito/yii2-coding-standards/Application .

Warning: always check phpcbf's output and keep backups. If it breaks your code, you get to keep both pieces., _(*10)

You should also run a syntax check using php -l before running phpcbf, because some sniffs assume the code is syntactically valid, and may mangle it if it is not., _(*11)

If you're using PhpStorm you can configure it to use CodeSniffer using Settings → PHP → Code Sniffer. The standard can be specified at Inspections → PHP → PHP Code Sniffer validation., _(*12)

Note that this will check all your files with a single standard, but you should use different standards for different types of files. These standards were designed for use with gulp-phpcs and gulp-phpcbf, so instead of using exclusion patterns in the ruleset.xml, they rely on the gulp task selecting the appropriate standard for a file., _(*13)

You can write your own ruleset.xml that extends from the Application standard and contains appropriate exclusion patterns (check the Others and Views ruleset.xml files for what rules to exclude)., _(*14)

Useful links

Contributing

See CONTRIBUTING.md for information., _(*15)

The Versions

20/11 2017

dev-master

9999999-dev https://mito.hu/

Mito Yii 2 coding standards

library yii2-coding-standards