phpdoc не наследует параметры метода
В родительском классе у меня есть:
/**
* 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, параметры метода должны быть унаследованы независимо от наличия атрибута attribute.
Решение
@inheritDoc не был разработан для этой цели.
Встроенный тег {@inheritdoc} используется в классе DocBlocks дочерних классов. phpDocumentor автоматически унаследует тег @author, тег @version и @copyright тег из родительского класса.
Посмотри Вот для официальной документации.
Другие решения
Если вы не переопределите метод в дочернем классе, то я думаю, что структура различных выходных преобразователей покажет вам только список унаследованных методов. Некоторые конвертеры будут включать по крайней мере краткое описание метода из docblock (HTML: Smarty: PHP), в то время как другие не включают
Из принятого ответа Вот.