php - 如何为来自数组的对象获取类型提示/自动完成？

Question

在我的框架中，我有一个返回包含对象的数组的方法。 它看起来很像这样:

    /**
     * @return array Array with Action objects
     */
    public function getActions() {
        return $this->actions;
    }

此Class 的用户在调用此方法时会得到一个文档弹出窗口，仅表示此方法将返回一个数组。但仅此而已!接下来，当用户从数组中获取一个对象时，IDE 非常愚蠢并且不知道/建议/自动完成任何内容。

作为框架开发人员，我可以做些什么来让框架用户的生活更轻松？或者我还能建议他们做什么，以便他们的 IDE 知道从数组返回哪种对象？

或者一般来说:如何让 IDE 知道数组中的对象类型，以便它可以建议该对象可以使用哪些方法？

Answer 1

当您调用 getActions() 方法时，您可以在迭代的对象数组之前添加注释行:

$actions = $o->getActions();

/* @var Action $action */
foreach ( $actions as $action ) {
    ...
}