PhpStorm类型提示派生类返回值

2019-07-28 13:30:00 阅读：460 来源： 互联网

是否有可能提示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.

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

标签：type-hinting,php,phpstorm,phpdoc
来源： https://codeday.me/bug/20190728/1561985.html

本站声明： 1. iCode9 技术分享网（下文简称本站）提供的所有内容，仅供技术学习、探讨和分享；
2. 关于本站的所有留言、评论、转载及引用，纯属内容发起人的个人观点，与本站观点和立场无关；
3. 关于本站的所有言论和文字，纯属内容发起人的个人观点，与本站观点和立场无关；
4. 本站文章均是网友提供，不完全保证技术分享内容的完整性、准确性、时效性、风险性和版权归属；如您发现该文章侵犯了您的权益，可联系我们第一时间进行删除；
5. 本站为非盈利性的个人网站，所有内容不会用来进行牟利，也不会利用任何形式的广告来间接获益，纯粹是为了广大技术爱好者提供技术内容和技术思想的分享性交流网站。

ICode9

PhpStorm类型提示派生类返回值