Come indicare che il metodo è una parte dell'interface con PHPDoc?

Come indicare che il metodo è una parte dell'interface con PHPDoc?

Per esempio:

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

C'è qualcosa di appropriato per sostituire @thisMethodIsHereBecauseItIsAPartOf("BarInterface") con?

Come indicare che il metodo è una parte dell'interface con PHPDoc?

Non è necessario documentarlo perché si utilizza implements BarInterface e un sistema di documentazione del codice sorgente normalmente lo gestisce automaticamente.

Tuttavia puoi anche usare @inherit(doc) :

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

A proposito del tuo @implements BarInterface , questo è superfluo , perché è già scritto nella definizione della class. Dato che i commenti contano come codice, e come non dovresti scrivere codice superfluo , ti suggerisco di rimuoverlo.