有没有正确或标准的方法来做到这一点?
例如:
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.
您应该记录接口或抽象实现. 否则,使用@ inheritdoc / document实现一个接口方法.
版权声明:本文内容由互联网用户自发贡献,该文观点与技术仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容, 请发送邮件至 dio@foxmail.com 举报,一经查实,本站将立刻删除。