表示phpDocumentor数组数据类型的正确方法？

以下哪项是记录phpDocumentor此方法的返回类型的正确方法

方法1:

/**
 * @return array Foo array.
 */
public function foo() {
    return array(1, 2, 3);
}

/**
 * @return integer[] Foo array.
 */
public function foo() {
    return array(1, 2, 3);
}

方法2:

/**
 * @return array Foo array.
 */
public function foo() {
    return array(1, 2, 3);
}

/**
 * @return integer[] Foo array.
 */
public function foo() {
    return array(1, 2, 3);
}

另外，这两种方法都有IDE含义吗

编辑：

/**
 * @return array Foo array.
 */
public function foo() {
    return array(1, 2, 3);
}

/**
 * @return integer[] Foo array.
 */
public function foo() {
    return array(1, 2, 3);
}

---

PhpStorm和Netbeans 7.1+IDE似乎都支持第二种方法。

这两种方法在技术上都是正确的，但这一种被认为“更好”，因为它更具体（

int

和

integer

可以互换）：

此处记录：

---

在撰写此答案时，以下是表示数组的公认方法（可能还有其他实现）：

未指定，未定义所表示数组的内容 鉴于示例：

@返回数组

指定包含单个类型，

类型

定义通知 每个数组元素类型的读取器。只有一种

类型

应为给定数组的元素。 示例：

@return int[]

请注意，

mixed

也是一种单一类型，使用此关键字即可 可以指示每个数组元素包含任何可能的 类型

指定包含多个类型，

类型

定义通知 每个数组元素类型的读取器。每个元素可以是任意的 给定类型的。示例：

@return（int | string）[]

---

谢谢你的链接！真不敢相信我错过了这个。我想把这标记为正确答案，除了第1.4.4节说明我列出的两种语法都是正确的，其中您的答案只指定了第二种是正确的（尽管第二种肯定是最有用的，IMHO）。这两种都是正确的，但这一种认为“更好”，因为它更具体。int/integer是可交换的。@drrcknlsn：我很感激您花时间进行编辑。