How to indicate that method is a part of interface with PHPDoc?
For example:
/**
* @implements BarInterface
*/
class Foo implements BarInterface
{
/**
* @thisMethodIsHereBecauseItIsAPartOf("BarInterface")
*/
public function doBar()
{
}
}
Is there anything appropriate to replace @thisMethodIsHereBecauseItIsAPartOf("BarInterface")
with?
How to indicate that method is a part of interface with PHPDoc?
You do not need to document that, because you use implements BarInterface
and a source-code documentation system normally handles these automatically.
However you can also use @inherit(doc)
:
/**
* @implements BarInterface
*/
class Foo implements BarInterface
{
/**
* @inherit
* {@inherit}
* {@inheritdoc}
*/
public function doBar()
{
}
}
About your @implements BarInterface
on top, this is superfluous, because it's already written in the class definition. As comments count as code, and as you should not write superfluous code, I suggest you to remove it.
If you love us? You can donate to us via Paypal or buy me a coffee so we can maintain and grow! Thank you!
Donate Us With