是否有检查所有函数的类型提示的规则?
/**
* Set the part name.
*
* @param string $name The part name.
*/
public function setName(string $name) : void
{
$this->name = $name;
}
例如,它必须在参数前面有一个类型,并且函数必须有一个指定的返回类型。
随着时间的推移,我之前的回答 - TypeHintDeclarationSniff
- 显示为非常错误。再具体一点:
public function anotherMethod(int $value)
{
// $value is known integer
$this->someMethod($value);
}
/**
* @param string $value
*/
-private function someMethod($value)
+private function someMethod(string $value) // here should be "int"
{
}
遗漏案例:
public function getItems() // here should be "array"
{
return ['Statie', 'EasyCodingStandard', 'Rector'];
}
或者:
public function getResult() // here should be "float"
{
if (true) {
return 5.2;
}
return 5.3;
}
甚至破坏父类型 in 的代码/vendor
。为什么?因为它是基于字符串和令牌的,而不是对代码的静态分析。
这让很多人非常生气,在我向他们推荐这款嗅探器之后。明显地。
我编写了一个名为 Rector ( https://github.com/rectorphp/rector ) 的工具,它考虑了其他变量和其他类及其类型。
这样您就可以在没有任何@param
或@return
注释的情况下完成对代码的类型声明。
安装:
composer require vendor/bin/rector
设置rector.yaml
配置:
# rector.yaml
services:
Rector\Php\Rector\FunctionLike\ParamTypeDeclarationRector: ~
Rector\Php\Rector\FunctionLike\ReturnTypeDeclarationRector: ~
利用:
vendor/bin/rector process src --dry-run # preview
vendor/bin/rector process src # change
而已!
初步答案:
为此,您可以使用Slevomat /CodingStandard中的 TypeHintDeclarationSniff。
我用了一年多了,效果很好。