PHPDoc，Factory @return类型

Question

假设我已经

• 具有一个抽象方法的抽象类。
• 两个以自己的方式定义抽象方法的子类。
• 基于参数返回两个子类之一的实例的工厂。

下面是示例代码

abstract class Datalist{
    abstract public function render($arg1, $arg2);
}

class Datalist_Table{
    public function render($arg1, $arg2){
        /* do something here */
    }
}

class Datalist_List{
    public function render($arg1, $arg2){
        /* do something here */
    }
}

class DatalistFactory{

    /**
     * usual stuff
     *
     * @return Datalist
     */
    public static function build($args){
        $class_name = 'Datalist_' . $args['type'];
        return new $class_name($args['m'][0], $args['m'][1]);
    }
}

//in some other file
$list = DatalistFactory::build($args);
$list-> ....

我的问题

我的IDE (PHPStorm)没有暗示$list->render()。我猜这是因为它已经被声明为abstract。

问题

在PHPDoc for DatalistFactory::build()中，我应该把什么放在DatalistFactory::build()前面，以便IDE也提示在子类中定义的函数。

P.S.

• 我试过以下问题的说明，但没有成功 phpDoc notation to specify return type identical to parameter type
• PHPDoc: Is is possible to reference the object property descriptions from factory method docblock?
• PHPDoc preconditions
• PHPDoc for fluent interface in subclass?

Answer 1

您需要在项目中打开此文件。我使用phpstorm8.0.3在项目中创建新文件并插入代码。所有工作都很好=

​

​