如何告诉PhpStorm定义了一些变量

Question

我在PhpStorm中使用Yii2框架。

当我使用$this->render函数在主文件中包含一些变量的另一个代码片段时，视图中出现了问题。

代码本身可以完美运行，我只是突出显示一个问题。

这是我的代码：

<?php
echo $this->render('commentsBlock', [
            "comments" => $comments,
            'deleteURL' => $deleteURL,
            'editURL' => $editURL,
        ]);
?>

上面的代码呈现了 commentsBlock.php ，该目标文件的内容如下：

如您所见，PhpStorm认为变量在定义时未声明。

我知道我需要添加一些注释，以告知IDE确实存在vars，但到目前为止，我尝试的操作仍然无效。

我这样做了：

但这不是突出显示。

关于如何正确编写此注释部分以欺骗IDE突出显示我的变量的任何想法吗？

Answer 1

像这样使用vardoc：

/* @var $comments array */

此语法与phpdoc标准略有不同（请注意变量名称和类型切换的位置），但已被IDE（包括PhpStorm）广泛认可。

有关更多参考，请参见this answer。