对象数组的PHPDoc类型提示？

Question

因此，在 PHPDoc 中，可以在成员变量声明上方指定 @var 以提示其类型。然后是 IDE，例如。 PHPEd 将知道它正在使用什么类型的对象，并将能够为该变量提供代码洞察力。

<?php
  class Test
  {
    /** @var SomeObj */
    private $someObjInstance;
  }
?>

这很有效，直到我需要对一组对象执行相同的操作，以便稍后在遍历这些对象时获得适当的提示。

那么，有没有办法声明一个PHPDoc标签来指定成员变量是一个SomeObj的数组呢？ @var 数组是不够的，例如 @var array(SomeObj) 好像不成立。

Answer 1

在 JetBrains 的 PhpStorm IDE 中，您可以使用 /** @var SomeObj[] */，例如:

/**
 * @return SomeObj[]
 */
function getSomeObjects() {...}

phpdoc documentation推荐这种方法:

specified containing a single type, the Type definition informs the reader of the type of each array element. Only one Type is then expected as element for a given array.

Example: @return int[]