2

我在一些遗留代码中添加了一些注释，并且遇到了 PHPDocumentor 的一个小问题。

这是一个例子：

/**
 * Constructs the Widget object
 * 
 * Basic constructor for the widget object.
 * Another line of pointless explanation, badly worded.
 *
 * @param  string   $id    The ID of the widget
 * @param  int      $size  The Size of the widget
 * @throws InvalidArgumentException
 */
public function __construct($id, $size) {
    if (!is_string($id) || !is_integer($size)) {
        throw new InvalidArgumentException('$id must be a string, $size an integer');
    }
    $this->id = $id;
    $this->size = $size;
}

我从命令行运行 PHPDocumentor，并得到一个充满文档的可爱文件夹。

文档看起来不错，但我得到 PHPDocumentor 编译错误，如下所示：

Argument $id is missing from the Docblock of __construct

只是 PHPDocumenator 不必要地抱怨，还是有什么明显的我遗漏了？

4

1 回答 1

5

我对 phpDocumentor 2.8.1 版有同样的问题。看来这是这个版本的一个错误： 在此处输入链接描述

我使用的是2.7.0 版本，现在很好。

于 2014-12-07T05:01:36.333 回答