Php 从接口继承文档

Php 从接口继承文档,php,documentation,phpdoc,docblocks,Php,Documentation,Phpdoc,Docblocks,我使用docblocks来记录函数方法、类。。。和往常一样 我发现自己在使用适配器模式,因此,我的所有适配器都实现了一个公共接口并返回相同的内容 公共接口中的所有函数都记录了它们的名称、返回值、变量等 有没有办法使整个适配器类的函数从公共接口中的相同函数继承文档?我知道@inheritDoc,但是我不确定是否每个函数都需要使用它,或者是否可以应用于类docblock,或者这是否完全是一个坏主意 对“真正的”文档来说有点陌生。文档生成器和IDE现在通常都知道如何为您进行这种继承。只要适配器函数上没

我使用docblocks来记录函数方法、类。。。和往常一样

我发现自己在使用适配器模式,因此,我的所有适配器都实现了一个公共接口并返回相同的内容

公共接口中的所有函数都记录了它们的名称、返回值、变量等

有没有办法使整个适配器类的函数从公共接口中的相同函数继承文档?我知道
@inheritDoc
,但是我不确定是否每个函数都需要使用它,或者是否可以应用于类docblock,或者这是否完全是一个坏主意


对“真正的”文档来说有点陌生。

文档生成器和IDE现在通常都知道如何为您进行这种继承。只要适配器函数上没有docblock,接口函数的文档就应该自动继承。有时候,如果你做了一个子docblock,父docblock会被忽略。。。但是通常,现在解释docblock的任何东西都有更好的逻辑来合并子docblock信息和父docblock信息,并将其表示为给定函数的一个信息块

@inheritdoc
标记经常被误用来尝试完成同样的事情,但实际上从未用于此目的。这个标记只有一个任务——控制子文档中显示父文档的详细描述的位置。就这样,没别的了