php - PHP Docbloc：将继承方法更改为标准链接@inheritDoc - 最佳实践？

Question

我有大量的 PHP 行。许多方法包含实际上继承自它们覆盖的方法的文档块。

例子：

MyBaseClass {

    /**
     * @param string $first - first name
     * @param string $last  - last name
     */    
    protected function MyMethod($first, $last) 
    {

    }


    /**
     * @return bool
     */    
    public function MyMethod2($first, $last) 
    {

    }

}

MyChildClass extends MyBaseClass {

    /**
     * @param string $first - first name
     * @param string $last  - last name
     */    
    protected function MyMethod($first, $last) 
    {

    }


    /**
     * @return bool
     */    
    public function MyMethod2($first, $last) 
    {

    }

}

基本上，我希望子类中的文档块可以阅读：

/**
 * @inheritDoc
 */

因为据我了解，这是最佳实践。如果这是最佳实践，有人可以推荐我可以使用什么程序/技巧/代码将所有这些继承的文档更改为上述基本文档吗？

Answer 1

PhpStorm 应该能够做到这一点inheritDoc——所以如果你使用PhpStorm 的覆盖/扩展方法 UI 扩展方法，应该有一个复选框来启用插入。还有额外的插件来调整这种行为，例如这个。