对于抽象函数,是应该为抽象函数,实现函数还是两者定义phpdoc？

例如：

AbstractFoo.php：

abstract class AbstractFoo {
    /**
     * Does the phpdoc go here?
     */
    public function fooFunction();
}

Foo.php：

class Foo extends AbstractFoo {
    /**
     * Or does the phpdoc go here?
     */
    public function fooFunction(){
        // some implementation
    }
}

请考虑以下问题：

>如果你将phpdoc放在抽象的FooFunction()中,并且控制点击$foo-> FooFunction(),你将最终得到Foo类’FooFunction(),这是没有文档的,并且不会立即明显它正在实现一个抽象功能.如果很明显,没有简单的方法可以在抽象函数中找到phpdoc

>确定对象是什么类
>找到它继承的抽象类
>对该抽象类中的函数名称执行“查找”

>如果您只将phpdoc放在子函数中,那么您将面临在n个继承类的子函数中复制phpdoc.
>如果你把phpdoc放在两者中,抽象函数的phpdoc就变得没用了,除非子类没有phpdoc,想要继承抽象的phpdoc.但即便在这种情况下,也没有简单的方法可以导航到那个抽象的phpdoc.