如何在phpdocumentor的类中正确记录数组属性？

Question

我想了解如何正确地为phpdocumentor文档中的数组属性。

例：

<?php 
class foo { 
    /** 
    * This holds something important 
    * @var string 
    */ 
    protected $junk; 
    /** 
    * This holds an important array of strings 
    * @var ??????? 
    */ 
    protected $stuff = array(); 
    // ... 
} 
?> 

我无法找到有关阵列性能的PHPDoc的手动什么。

Answer 1

/** @var array */对于您的protected $stuff是正确的语法。 @var的phpDocumentor手册页显示“数据类型应该是一个有效的PHP类型（int，string，bool等）”，而“array”是这样一个有效的PHP类型。

一些IDE也开始认识到/** @var ElementType[] */表示“这是一个数组，其元素都是ElementType类型”。该语法将在即将发布的phpDocumentor版本中提供。