从构建器方法调用的类型提示方法

Question

考虑一个使用静态构建器返回模型实例的 Active Record 实现。这是要演示的 ModelBuilder 和 Model 类的非常简化版本，所有与问题无关的代码都已删除：

class ModelBuilder {
    public function __construct($class) {
        $this->class = $class
    }

    private function _execute() {
        $result = $pdo->query("SELECT * FROM {$this->class}");
        return $result->fetchAll(PDO::FETCH_CLASS, $this->class);
    }

    public function all() {
        return $this->_execute();
    }

    public function one() {
        return $this->_execute()[0];
    }
}

class Model {
    public static function builder() {
        return new ModelBuilder(get_called_class());
    }
}

class FooModel extends Model {

}

为了得到一个 Foo 项目，我们这样调用 FooModel 类：

$foo = FooModel::builder()->one();

在这种情况下，智能 IDE（在我的情况下为 PhpStorm）不知道 $foo 是什么类型的对象。我可以在每次创建对象时对变量 /** @var $foo FooModel */ 进行类型提示，但我更喜欢在 all() 和 one() 方法上进行适当的类型提示。

添加到all() 和one() 方法的正确类型提示是什么？ 请注意，static 不起作用，我相信因为 ModelBuilder 不是初始调用的祖先类，它在builder() 方法中被显式调用。

这个特定项目使用的是 PHP 5.6，但也欢迎使用 PHP 7 特定的答案。

Answer 1

如果您的模型具有像 BaseModel 这样的父类 - 您可以在文档块内的返回块中使用 BaseModel all 和 one 方法，例如：

/**
* @return BaseModel Model instance.
*/
public function one() {
    return $this->_execute()[0];
}

但在这种情况下 - 它只是 BaseModel 它不是 FooModel 也不是 BooModel...
您将只能访问 BaseModel 方法和属性，但不能访问特定于 FooModel...

为了拥有特定模型 - 您已经使用适当的文档块覆盖子模型中所需的方法，例如：

class FooModel extends BaseModel
{
    /**
    * @return FooModel Foo model instance.
    */
    public function one() {
        return parent::one();
    }
}

或者有类的文档块，像这样：

/**
 * @method FooModel one Foo model instance.
 */
class FooModel extends BaseModel
{
}

或者像你已经提到的那样使用 doc-block /** @var $foo FooModel */。