WordPress编码标准 - phpcs警告

时间:2017-05-03 10:40:49

标签: php wordpress phpstorm phpcs

我正在使用WordPress-Core规则来处理我刚刚在PhpStorm开始的项目(涉及开发自定义插件和主题),我发现很奇怪大多数默认的php文件都在干净的WordPress中安装(例如,当使用该repo中的任何WordPress规则时,wp-config.php,wp-mail.php等)不会通过phpcs测试。

大多数时候,我看到开括号和近括号警告:

PEAR.Functions.FunctionCallSignature.SpaceAfterOpenBracket
PEAR.Functions.FunctionCallSignature.SpaceBeforeCloseBracket

回购中的WordPress-Core规则集说:

<rule ref="PEAR.Functions.FunctionCallSignature">
    <properties>
        <property name="requiredSpacesAfterOpen" value="1"/>
        <property name="requiredSpacesBeforeClose" value="1"/>
    </properties>
</rule>

这让我觉得警告是合法的(?)。如果是这种情况,为什么WP核心文件不完全遵循WP自己的代码标准?

1 个答案:

答案 0 :(得分:3)

历史上,WordPress避免清理Core代码样式,原因如下:

  • 检查编码标准的工具不是特别可靠。近年来,随着WordPress编码标准(WPCS)项目的成熟,以及PHPCS中修复了许多小边缘案例,这种情况发生了变化。
  • 由于没有可靠的自动化工具,这将是一个手动工作,需要许多提交。这会导致不必要的代码流失,并使查看修订日志变得更加困难。
  • 这不是一个高优先级。 ~4%的WordPress的PHP违反了编码标准,因此大多数人都没有遇到它。

随着工具的成熟,最近这个位置发生了变化,现在有一个in-progress effort可以让PHPCS和WPCS与WordPress Core一起工作。通过适当的自动化测试,WordPress将来会继续匹配自己的编码标准。