想象一下以下假设的类结构,而不是一个非常罕见的场景,所有
PHPdoc提示设置正确:
class BaseFilter {
/** ...base methods... */
}
class TextFilter extends BaseFilter {
public function setMinLength($len)
{
/** ...irrelevant */
}
}
class SomethingWithFilters
{
/**
* @param BaseFilter $filter A valid filter to be added.
* @return BaseFilter The filter that was added for easy chaining
*/
public function addFilter(BaseFilter $filter)
{
$this->filters[] = $filter;
return $filter;
}
/** @var BaseFilter[] A list of filters */
private $filters = [];
}
现在我使用以下代码:
$myClass = new SomethingWithFilters();
$myClass->addFilter(new TextFilter())->setMinLength(8);
在phpStorm(可能大多数其他IDE,因为它有意义)第二行产生一个警告,说明BaseFilter不包含方法setMinLength.虽然绝对正确,但这是多态行为,充分利用PHP的后期绑定特性 – 在像C#这样的语言中你必须明确地进行上传.因此我希望phpDoc语法在这里支持某种动态表示法,声明addFilter的返回类型与提供的$filter类型相同.
我尝试将其更改为:
@return $filter
但是这只是作为对BaseFilter的引用而显示出来并且被视为这样,仍然发出警告.
是否有任何标准化的方法来实现这种效果,至少通用IDE可以理解它?