PhpStorm函数注释的设置

版权声明：转载请注明出处 https://blog.csdn.net/liuxl57805678/article/details/89382048

首先，PhpStorm中文件、类、函数等注释的设置在：setting-》Editor-》FIle and Code Template-》Includes下设置即可，其中方法的默认是这样的：

/**
    ${PARAM_DOC}
    #if (${TYPE_HINT} != "void") * @return ${TYPE_HINT}
    #end
    ${THROWS_DOC}
*/

但是我发现，文件中的默认注释是这样的：

/**
 * Created by ${PRODUCT_NAME}.
 * User: ${USER}
 * Date: ${DATE}
 * Time: ${TIME}
 */

当我把上面这段中3、4、5行的代码直接复制放到PHP Function Doc Comment这个下面的时候，发现其中占位符{}中的东西并没有被替换，而是当成字符串打出来了。

方法：

1、我们在PhpStorm中setting-》Editor-》Live Template，即找到模板选项，会看到各种语言的模板设置；

2、找到右边有个+号，创建一个自定义模板：选择Live Template，然后按照下图的配置顺序进行设置：

3、点保存之后，回到FIle and Code Template-》Includes，在PHP Function Doc Comment这里设置：

/**
 * Notes:
 * User: ${USER}
 * Date: ${DATE}
 * Time: ${TIME}
${PARAM_DOC}
#if (${TYPE_HINT} != "void") * @return ${TYPE_HINT}
#end
${THROWS_DOC}
*/

4、点击Apply，点击OK，然后在方法前面，输入 /**后回车：

/**
     * Notes:测试
     * User: Neal
     * Date: 2019/04/18
     * Time: 16:38
     * @return array
     * @throws \yii\db\Exception
     */

OK，完成。