如果有一种方法可以在相同和/或不同的类中的不同方法上复制(继承)完全相同的phpdoc,那么我就会徘徊。
我知道Method Not Allowed,它只提供从父类到其子类的继承(正如人们所期望的那样:)。
但是看看下面的内容,我必须在3个不同的地方复制相同的描述,同一个类中的2个方法和单独的类中的一个(不是继承但是已启动)。 我想知道是否有一种方法可以解决这个问题,而不需要复制粘贴。
{{1}}
提前感谢任何建议:)
答案 0 :(得分:1)
{@inheritdoc}
是内置的,不支持指定继承源。请使用@see
标记。
不太可能以相同的方式描述两种方法。如果它是代理,或者只是简单地传递数据,则说明应该注意这种行为,@see
标记应该将用户引导到接口方法。
我经常使用@see
和@link
标记链接到SAPI文档,或者解析代理。也就是说,我总是尝试包含某种描述,并始终记录参数和返回,即使它们是相同的(在查看代码时也有帮助)。
小心过分依赖PHPDoc的快捷方式。