PHP Code Sniffer や PHP Mess Detector を使用して、クラス/プロパティ/メソッドに適切な docblock があるかどうかを検出する方法はありますか? 例えば:
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(){
// ...
}
}
私は定義上、docblock が正しいかどうか (戻り値の型が返されるものと一致するかどうか) には興味がありません。 docblock が存在します。