phpdoc不继承方法参数

Question

在父类我有：

/**
 * Render the widget.
 * @param  array $options
 * @return string
 */
abstract public function render(array $options=[]);

在孩子班上我有：

/**
 * {@inheritDoc}
 */
public function render(array $options=[]) { /*...*/ }

但是phpdoc为子类提供了以下错误：

Argument $options is missing from the Docblock of render()

为什么？

编辑：如果我在http://phpdoc.org/docs/latest/guides/inheritance.html理解它，那么无论inheritDoc存在，都应该继承方法params。

Answer 1

@inheritDoc并未设计用于此目的。

{@inheritdoc}内联标记用于子类的DocBlocks类。 phpDocumentor将自动从父类继承 @author标签，@ version标签和@copyright 标签。

查看here官方文档。

Answer 2

  

如果你不重新声明子类中的方法，那么我认为各种输出转换器的结构只会显示一个继承方法的列表。有些转换器至少会包含docblock（HTML：Smarty：PHP）中方法的简短描述，而其他转换器则不包含

从接受的答案here。