consistence/coding-standard

一致性 - 编码规范 - PHP 代码规范规则


README

完整的规范描述在单独的文档.

这是一个自定义编码规范,由所有 Consistence 项目使用。它也适合与其他项目一起使用,或作为您自己标准的基石。

本标准的 主要目标包括

  • 严格(且可预测)的代码。
  • 防止常见错误。
  • 可读性高于可写性(字符计数)。
  • 友好地对待差异 - 最小化更改的影响。
  • 不要编写不必要的/不可靠的信息。

自动检查

本标准的自动检查是通过为 PHP_CodeSniffer (phpcs) 实现的嗅探器,但并非所有规则都已检查。PHP_CodeSniffer 还包含自动修正某些错误的工具 phpcbf,但此工具也不完全可靠 - 由它产生的结果可能不符合此标准。

这些检查还包括一些代码分析工具,如检测不可达代码等。这些不是标准的一部分,但可能很有帮助。

稳定性

本软件包使用以下规则使用 SemVer

Coding Standard 文档应被视为 SemVer 的真理来源和主要对象。

  • 如果向文档中添加了新规则,则将增加 MAJOR 版本。
  • 如果为检查现有描述的规则实现了新嗅探器,则将增加 MINOR 版本。
  • 为修复错误 - 修复错误被视为不符合文档的一切 - 这甚至可能导致(暂时)禁用一个现有的嗅探器或其部分,直到有更好的检查可用或正确修复。

自动检查的实现(自定义嗅探器和 ruleset.xml 文件)不受 SemVer 的约束,并且可能随着时间的推移而变化,以适应 PHP_CodeSniffer 和提供的默认嗅探器的变化,这些嗅探器也由本标准使用。

本软件包的推荐依赖项是 MINOR 版本(例如 ~1.0.0),这意味着实际上

  • 不会添加新规则。
  • 可能会添加新的自动检查。
  • 您将获得现有自动检查的修复,或者如果发现回归,则其中一些可能被禁用。

安装与使用

使用 Composer 安装软件包 consistence/coding-standard

composer require --dev consistence/coding-standard

然后使用此标准运行 phpcs

vendor/bin/phpcs --standard=vendor/consistence/coding-standard/Consistence/ruleset.xml --extensions=php --encoding=utf-8 -sp src

有关进一步的使用选项,请参阅 PHP_CodeSniffer 文档