php - 使用 phpdoc 记录子类中的继承函数/变量

Question

假设我有一个带有一些变量的父类，它有 phpdoc:

class Parent
{
    /**
     * This variable stores some important value that
     * is going to be changed in child classes
     * @var integer
     */
    public $variable = 0;
}

现在我正在编写子类，它覆盖了这个变量:

class Child extends Parent
{
    public $variable = 10;
}

所以我的问题是:我应该为 Child 类中的 $variable 编写什么 phpdoc，这样我就不必复制和粘贴变量描述？同样的问题也适用于方法。非常感谢您的帮助。

更新:我在创建 phpdoc 后看到错误后问过这个问题，例如 Child 类中的“No summary for property $variable”。如果我添加此摘要 - 错误消失，但 phpdoc 无论如何都会显示父类的描述，无论我在子类中写什么。我做错了什么？

Answer 1

这种行为对我来说听起来像是一个错误。子类属性完全缺少 docblock 应该会导致父属性 docblock 被完全继承。请将其报告为 github 存储库中的问题。