从父结构继承元数据

如果一个类扩展另一个类并使用相同的元数据,那么提供它 @inheritDoc 是一种使用相同文档的简单方法。如果多个类继承自基类,则只需要更改基类以使子项受影响。

abstract class FooBase
{
    /**
     * @param Int $a First parameter to add
     * @param Int $b Second parameter to add
     * @return Int
     */
    public function sum($a, $b) {}
}

class ConcreteFoo extends FooBase
{
    /**
     * @inheritDoc
     */
    public function sum($a, $b)
    {
        return $a + $b;
    }
}