php - phpDocumentor：带有@var标签的DocBlock重复描述

Question

我在 php 抽象类中有这个 DocBlock：

/**
* @var string $foo a useful foo and <code>some.code()</code> too
* @var string $bar a useless bar
*
* @todo do something with <code>$this->bar</code>
*/
protected $foo, $bar;

我用 phpDocumentor 解析了这个类；这是html结果：

正如您所看到的，两者都$foo具有$bar相同的描述（$foo 之一），并且降价也没有被解析。另一方面，@todo标记的降价被正确解析。

我哪里错了？我错过了什么？

我在标签中发现了一张关于降价@var的错误票：这可能与这个问题有关吗？

Answer 1

我总是在 var 本身上方记录。也许这就是问题

/**
* @var string $foo a useful foo and <code>some.code()</code> too
*/
protected $foo;
/*
* @var string $bar a useless bar
*
* @todo do something with <code>$this->bar</code>
*/
protected $bar;