如何从另一个方法继承phpdoc(不是我们覆盖的方法)

时间:2015-06-19 14:34:49

标签: php phpdoc

如果有一种方法可以在相同和/或不同的类中的不同方法上复制(继承)完全相同的phpdoc,那么我就会徘徊。

我知道Method Not Allowed,它只提供从父类到其子类的继承(正如人们所期望的那样:)。

但是看看下面的内容,我必须在3个不同的地方复制相同的描述,同一个类中的2个方法和单独的类中的一个(不是继承但是已启动)。 我想知道是否有一种方法可以解决这个问题,而不需要复制粘贴。

{{1}}

提前感谢任何建议:)

1 个答案:

答案 0 :(得分:1)

{@inheritdoc}是内置的,不支持指定继承源。请使用@see标记。

不太可能以相同的方式描述两种方法。如果它是代理,或者只是简单地传递数据,则说明应该注意这种行为,@see标记应该将用户引导到接口方法。

我经常使用@see@link标记链接到SAPI文档,或者解析代理。也就是说,我总是尝试包含某种描述,并始终记录参数和返回,即使它们是相同的(在查看代码时也有帮助)。

小心过分依赖PHPDoc的快捷方式。