Phpstorm如何添加PHP代码模板_Phpstorm添加PHP代码模板法【入门】

5次阅读

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

Phpstorm 如何添加 PHP 代码模板_Phpstorm 添加 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 即可用:

→ 快速写 Laravel Eloquent 查询:

$variable$ = $MODEL$::where('$COLUMN$', '$VALUE$')->get();$END$

然后在 Edit variables 中设:

  • MODEL:Expression className()(自动补类名)
  • COLUMN:默认 id,勾选 Skip
  • VALUE:空,默认光标停在这

→ 写数组解构(PHP 7.1+):

[$key1$, $key2$] = $array$;$END$

注意:$array$ 变量可设 Expression 为 complete() 启用代码补全;$END$ 表示最终光标位置。

变量表达式(Expression)很关键:不用硬记,点 Edit variables 右下角的 …… 就能看到所有可用函数,比如 methodName()camelCase()snakeCase() —— 这些能让模板更智能,而不是每次都要手动改大小写。

模板越贴近你真实 编码 动线,越容易坚持用。别堆一堆“可能有用”的模板,先搞定最常敲的 3 个:测试方法、Eloquent 查询、数组遍历。

text=ZqhQzanResources