shlinkio / php-coding-standard
shlink PHP项目使用的编码规范
v2.3.0
2022-07-25 07:46 UTC
Requires
README
此仓库提供了一组由shlink PHP项目使用的PHP_CodeSniffer规则。
使用方法
首先,使用composer安装此包
composer require shlinkio/php-coding-standard --dev
然后,更新您的phpcs.xml
文件,添加一个引用到Shlinkio的规则。
<?xml version="1.0"?> <ruleset name="Coding standard"> <description>Coding standard</description> <!-- display progress --> <arg value="p" /> <arg name="colors" /> <!-- inherit rules from: --> <rule ref="Shlinkio" /> <!-- [...] --> </ruleset>
规则
此规则集扩展了PSR-12规则,并包括以下内容:
- 不允许使用长数组语法 [
array(...)
]。 - 确保字符串连接运算符周围有空格。
- 不允许多余的空格。
- 不允许使用未使用的use语句。
- 要求use语句按字母顺序排序。
- 要求使用严格的比较运算符 (
===
和!==
) 而不是==
和!=
)。 - 要求在多行数组的每个元素后使用逗号。
- 要求在多行函数调用中的每个元素后使用逗号。
- 要求在多行函数声明中的每个元素后使用逗号。
- 强制所有全局命名空间类、函数和常量必须显式导入。
- 要求注释为单行,以单行形式书写 [
/* @var SomeType **/
]。 - 要求所有类常量都有可见性修饰符 (
public
、protected
或private
)。 - 要求具有默认
null
值的函数参数定义为可空类型 (?string $foo = 'foo'
)。 - 要求尽可能在函数参数上使用原生类型提示。
- 要求尽可能在函数上使用原生返回类型提示。
- 要求尽可能在属性上使用原生类型提示。
- 要求在异常变量未使用时使用非捕获捕获。
- 格式化无空格的联合类型 (
foo|bar
) 并强制null类型在可空类型后出现 (foo|bar|null
)。