php - 如何用子数组(混合类型)记录数组？

Question

要记录一个变量，它可以接受一个数组，该数组接收一个值为字符串的向量:

/*
 * @var string[] An array of string objects.
 */
$foo = array('A', 'B', 'C');

要记录一个变量，它可以接受一个数组，该数组接收一个值为整数的向量:

/*
 * @var int[] An array of string objects.
 */
$foo = array(1, 5, 0);

我应该如何记录一个值是混合数组的变量？

我需要记录这样一个数组:

$foo = array(
    array('value A',  1, $this),
    array('value b',  2, NULL),
    array('value X', 15, new Test)
);

我想它是这样的:

/*
 * @var array[][string|int|object|null] Description.
 */

Answer 1

根据current draft PHPDoc(FIG PSR-5申请人)的@var标签是deprecated .他们建议使用 @type tag相反。

变量的类型仍然是数组；该数组的内容将在描述中简要提及。

/**
 * @var array $foo An array of string elements.
 */

或

/**
 * @type array $foo An array of string elements.
 */

如果变量可能包含字符串以外的东西，我可能会说 An array of mixed elements.，或者如果我知 Prop 体它们可能是什么 An array of bool|string|object元素。

如果变量本身可能有多种类型，我会给出它可能的类型列表。

/**
 * @type bool|string|array $foo Mixed type, depending on result of baz().
 */