PHP Documentor 中的注释关联数组

我在 PHP 应用程序中使用了多个关联数组，并且使用 PHP 文档管理器来注释我的源代码。我从来没有真正为数组中的数组指定注释，但现在我需要这样做，但不知道如何做。

$array = array('id' => 'test', 'class' => 'tester', 'options' => array('option1' => 1, 'option2' => 2))

我如何以正确的方式评论这个数组@var and @param评论？ 我可以这样做，但我不知道这是否正确：

@param string $array['id']
@param string $array['class']
@param int $array['options']['option1']

但如何做到这一点@var part?

您无法记录每个键，但是你可以告诉 phpDocumentor 它是什么类型 http://www.icosaedro.it/phplint/phpdoc.html#literalarrays.

你可以这样做：

/**
 * Form the array like this:
 * <code>
 * $array = array(
 *   'id'      => 'foo',          // the id
 *   'class'   => 'myClass',     // the class
 * );
 * 
 * </code>
 *
 * @var array[string]string 
 */
$array;