PHPStorm 的 PHP 自定义代码模板应使用 Live Templates 功能,路径为 Settings → Editor → Live Templates → 选 PHP → 新建模板,设置 Abbreviation、Template text(含 $VAR$ 变量)并勾选 PHP 上下文。

PHPStorm 里怎么添加自定义代码模板(Live Template)
直接说结论:PHPStorm 的 PHP 代码模板不是靠“新建文件模板”实现的,而是用 Live Templates 功能——它响应快捷键触发、支持变量占位、能自动补全结构化代码,这才是日常写 php 时真正高效的模板方式。
在 Settings 中找到 Live Templates 并新建 PHP 模板
路径是:Settings (Preferences on macOS) → Editor → Live Templates。左侧语言列表里选中 PHP,点击右上角 + → Live Template。
关键填写项:
-
Abbreviation:触发缩写,比如填test,之后输入test+Tab就展开 -
Description:随便写,比如PHPUnit test method -
Template text:写实际代码,用$VAR$定义变量,例如:
public function test$NAME$(): void
{
$END$
}
填完后点 Define,勾选 PHP;再点 Edit variables,给 NAME 设置默认值为 methodName,并勾选 Skip if defined(这样按 Tab 时可跳过该变量)。
立即学习“PHP免费学习笔记(深入)”;
为什么不能只靠 File Template 添加 PHP 类模板
File and Code Templates(路径:Settings → Editor → File and Code Templates)只能控制「新建文件时的初始内容」,比如你右键 → New → PHP Class 生成的骨架。但它不响应快捷键、不支持上下文变量、无法在已有文件中插入片段——这些正是 Live Templates 解决的问题。
常见混淆点:
- 改了
PHP Class文件模板,但写方法时仍要手动敲public function→ 这说明你该用Live Template而不是文件模板 - 模板在
.php文件里不生效?检查是否在Live Templates设置里为该模板勾选了PHP上下文 - 缩写冲突(比如
if已被内置模板占用):要么改缩写(如用ifn),要么在Live Templates列表里禁用冲突项
实用 PHP Live Template 示例与变量技巧
几个高频场景的模板建议,复制进 Template text 即可用:
jQuery图片列表动画显示效果,鼠标移到图片上会弹出文字描述,非常适合做素材、网站模板主题的图片列表,兼容主流浏览器,php中文网推荐下载! 使用方法: 1、在head区域引入样式表文件lrtk.css 2、在head区域引入jquery.1.4.2.min.js和lrtk.js 3、在你的网页中加入注释区域
→ 快速写 Laravel Eloquent 查询:
$variable$ = $MODEL$::where('$COLUMN$', '$VALUE$')->get();$END$
然后在 Edit variables 中设:
-
MODEL:ExpressionclassName()(自动补类名) -
COLUMN:默认id,勾选Skip -
VALUE:空,默认光标停在这
→ 写数组解构(PHP 7.1+):
[$key1$, $key2$] = $array$;$END$
注意:$array$ 变量可设 Expression 为 complete() 启用代码补全;$END$ 表示最终光标位置。
变量表达式(Expression)很关键:不用硬记,点 Edit variables 右下角的 ... 就能看到所有可用函数,比如 methodName()、camelCase()、snakeCase() —— 这些能让模板更智能,而不是每次都要手动改大小写。
模板越贴近你真实编码动线,越容易坚持用。别堆一堆“可能有用”的模板,先搞定最常敲的 3 个:测试方法、Eloquent 查询、数组遍历。










