1

有没有办法可以使用 PHP Code Sniffer 和/或 PHP Mess Detector 来检测我的类/属性/方法是否有正确的文档块？例如：

class Foo
{
    protected $bar;

    public function doStuff(){
        // ...
    }
}

上面的例子应该引发危险信号。但是，以下示例应该通过：

/**
 * Class Foo
 * @package Vendor\Module
 */
class Foo
{
    /**
     * @var Vendor\Module\Model\Bar
     */
    protected $bar;

    /**
     * This method does stuff
     * @return bool
     */
    public function doStuff(){
        // ...
    }
}

如果文档块正确（如果返回类型与返回的内容匹配），我对每个定义不感兴趣，我的意思是：如果它也这样做会很好，但我要采取的第一步是确保存在文档块。

4

1 回答 1

1

重复答案的解决方案也适用于 docblock 存在检查。

这是我的酒吧课程，有评论：

<?php

namespace PhpCSTesting;

use stdClass;

/**
 * Class Bar
 */
class Bar
{
    /**
     * @var stdClass
     */
    protected $bar;

    /**
     * This method does stuff
     *
     * @return boolean
     */
    public function doStuff()
    {
        return true;
    }
}

当我运行嗅探器时，我没有收到任何错误：

bin/phpcs Bar.php --standard=Squiz --sniffs=Squiz.Commenting.FunctionComment,Squiz.Commenting.FunctionCommentThrowTag,Squiz.Commenting.ClassComment,Squiz.Commenting.VariableComment

这是我的Foo类，没有评论：

<?php

namespace PhpCSTesting;

class Foo
{
    protected $bar;

    public function doStuff()
    {
        return true;
    }
}

然而，当我为这个类运行嗅探器时，我得到了错误：

bin/phpcs Foo.php --standard=Squiz --sniffs=Squiz.Commenting.FunctionComment,Squiz.Commenting.FunctionCommentThrowTag,Squiz.Commenting.ClassComment,Squiz.Commenting.VariableComment

FILE: /Users/lukas/workspace/Foo.php
----------------------------------------------------------------------
FOUND 3 ERRORS AFFECTING 3 LINES
----------------------------------------------------------------------
 5 | ERROR | Missing class doc comment
 7 | ERROR | Missing member variable doc comment
 9 | ERROR | Missing function doc comment
----------------------------------------------------------------------

您可以根据需要更新和修改规则集。

于 2017-03-06T10:37:20.157 回答