如何表明该方法是PHPDoc接口的一部分？

Question

如何表明该方法是PHPDoc接口的一部分？

例如:

/**
 * @implements BarInterface
 */
class Foo implements BarInterface
{
    /**
     * @thisMethodIsHereBecauseItIsAPartOf("BarInterface")
     */
    public function doBar()
    {
    }
}

有什么适合替换@thisMethodIsHereBecauseItIsAPartOf("BarInterface")吗？

Answer 1

如何表明该方法是PHPDoc接口的一部分？

您不需要记录,因为您使用implements BarInterface和源代码文档系统通常会自动处理这些.

但是你也可以使用@inherit(doc):

/**
 * @implements BarInterface
 */
class Foo implements BarInterface
{
    /**
     * @inherit
     * {@inherit}
     * {@inheritdoc}
     */
    public function doBar()
    {
    }
}

关于你的@implements BarInterface问题,这是多余的,因为它已经写在类定义中了.由于注释计为代码,并且您不应该编写多余的代码,我建议您将其删除.