PhpStorm类型提示派生类返回值

是否有可能提示PhpStorm在下面的代码中返回item()方法的值具有类型DOMElement(没有修改实际的 PHP语句,即通过某些外部设置的PhpStorm或插件或使用某种类型的PHPDoc注释等) ？

同样,请不要建议我修改代码中的语句,特别是部分$list-> item(0) – > getAttribute(‘test’).

另外,我发现了一个类似的问题PhpStorm type-hinting for factories?,但它处理用户定义函数的类型提示,在我的例子中,函数item()是一个预定义的库函数.

$doc = new DOMDocument();
$doc->loadXML('<x test="123"/>');
$list = $doc->getElementsByTagName('x');
if($list->length > 0)
    var_dump($list->item(0)->getAttribute('test'));

解决方法

因此,official docs $list-> item(0)返回没有getAttribute()方法的DOMNode类的元素. PhpStorm遵循官方文档.

但是如果你在你的代码中添加额外的行并在调试器中进行分析(例如$z = $list-> item(0);),你会发现$z是具有这种方法的DOMElement的实例.

答：您无法动态地向预定义方法(尤其是链中)添加文档.没门.

B.正如您所看到的 – 这里的“问题”在于文档：他们说item()返回一个类的实例,而在您的特定情况下它返回不同类的实例.

几个选项：

1.修改代码以引入中间变量,您可以为其提供正确的类型提示.据我了解你不想使用它.

2.忽略这些警告：您可以完全禁用它或只删除该文件;你可以降低严重程度(例如“信息”而不是“警告”)等

3.改变文档(不确定这是否是一个好主意).

这可以通过修改实际存根文件(PhpStorm发布的一部分……在全局范围内完成…因此它将影响所有项目,并且您必须在再次升级到更新版本后重做此项).

或者您可以在本地级别执行此操作(仅适用于此项目)：

>从原始存根文件中提取DOMNodeList类的存根
>将其放在项目中任何位置的单独文件中
>更改item()方法的@return标签 – 将它变成@return Domelement,无论你需要什么.

这将使IDE从两个来源“合并”文档：@return DOMNode | DOMElement.

再次 – 这将涵盖您的特定情况 – 这将如何影响您无法分辨的其他情况.