tigitz / phpcs
官方 Geolid 编码标准,支持 php7.1。
8.0.0
2019-01-20 13:11 UTC
Requires
- php: ^7.1
- escapestudios/symfony2-coding-standard: ^3.4
- object-calisthenics/phpcs-calisthenics-rules: ^3.3
- slevomat/coding-standard: ^4.7
- squizlabs/php_codesniffer: ^3.3
- wp-coding-standards/wpcs: ^1.0
README
composer require --dev tigitz/phpcs
您只需要此包,无需手动要求 squizlabs/php_codesniffer
。
require 之后,将以下文件复制到您的路径中: phpcs.xml.dist
并将其重命名为 phpcs.xml
,或者在现有的 phpcs.xml
中添加以下规则。
<rule ref="./vendor/tigitz/phpcs/src/Geolid/ruleset.xml" />
用法
通常使用 phpcs。
vendor/bin/phpcs
描述
我们遵循 PSR-2 编码风格,并添加了额外的规则。
附加规则
- 私有方法和属性不得以下划线开头。
- 在连接操作符周围有一个空格。
- 在类型转换操作符后有一个空格。
- 数组必须使用短语法。
- 尾随逗号:多行数组必须在所有行中都有逗号。
- 不允许超过 3 个嵌套缩进级别。
- 命名(函数、变量、常量等)的最小长度是 3 个字符(i、id、em、om、to、ID、TO 除外)。
- 对象实例化必须始终使用括号。
- 必须在返回语句之前有一个空行。
- 必须在返回类型提示之前有一个空格。
public function foo(): self {}
- PHP 必须包含
declare(strict_types=1);
,并在声明和 PHP 开头标签之间有一个空行。 - 必须在所有常量上声明可见性(PSR-12)。
- 不允许有未使用的导入(
use
语句)。
命名
- 除了 PHPUnit *TestCase 的名称外,所有抽象类都必须以前缀 Abstract 开头。(目前无法检测空抽象类的名称)。
- 接口后缀为 Interface。
- 特质后缀为 Trait。
- 异常后缀为 Exception。
测试
composer test