1

我正在尝试遵循 Zend 编码标准来编写函数的注释块,并且在PHP Function Doc Comment自定义过程中遇到了困难。

这是我当前的代码外观

/**
${PARAM_DOC}
#if(${PARAM_DOC})
 *
#end
 * @return ${TYPE_HINT}
${THROWS_DOC}
*/

对此的假设是,仅当${PARAM_DOC}不可为空时才应添加星号,但此代码不起作用。它总是添加一个星号。PhpStorm 变量的文档不包含任何有用的信息来解决我的问题,所以我希望这里有人可以帮助我。

我的 PhpStorm 版本是 2019.3 EAP。

4

1 回答 1

3

正如用于描述的内置 PhpStorm${PARAM_DOC}所说

参数的文档注释。生成为多行“* @param type name”。如果没有参数,则计算为空内容。

和 Apache Velocity 文档说

当 VTL 引用变量时,例如 $foo,变量可以从模板中的 set 指令或 Java 代码中获取其值。

在那之后,我明白我犯了一个重要的错误。PhpStorm 基于 Java,空字符串不能自动转换为布尔值,因为${PARAM_DOC}它只是一个Java 字符串

所以解决方案原来是

#if (${PARAM_DOC} != "")
 *
#end

明显但不安静。

于 2019-10-22T19:26:46.823 回答