PhpStorm 2026.2 Help

语言注入设置：SQL 注入

点击 "添加"按钮   在 Language Injection 页面中，选择上下文菜单中的 SQL 注入 ，或选择一条目并点击 编辑按钮 后，将打开此对话框。

PhpStorm 包含预定义的注入配置，可确保高效和易用。建议依赖这些配置，而非创建新配置。 我们建议您使用这些配置，而不是创建新的配置。

项目

描述

名称

注入的名称。

Language

要注入的语言。

  • ID ：选择要注入的语言的 ID 或名称。

  • 前缀 ：指定要在相应字符串值之前添加的字符序列。

  • 后缀 ：指定要在相应字符串值之后添加的字符序列。

前缀和后缀是可选的。

位置模式集

在此字段中，输入规则，以定义您希望 PhpStorm 将文字识别为注入的上下文。

示例：

在 HTML on* 事件属性中 inject JavaScript：

xmlAttribute().withLocalName(string().startsWith("on"))

通过名称和特定父级匹配 XML 标记：

xmlTag().withLocalName("script").withParent(xmlTag().withLocalName("html"))

多个模式

可以为单个注入规则定义多个位置模式。 如果有任意模式匹配，则会激活注入（它们以 OR 逻辑组合）。 请将每个模式写在单独的行上。

高级

在此区域，可选地指定其他设置，以收窄注入规则适用的上下文，从而启用对注入过程更细粒度的控制。

  • 值模式 输入用于确定 inject 语言上下文的正则表达式。 通过使用模式的第一个捕获组作为注入目标，您可以配置过程，使语言仅注入到匹配某个模式的值或匹配该模式的多个部分中。

  • 单个文件 - 如果此选项关闭，与值模式匹配的片段将被单独处理，视为不同的“文件”——例如，从片段编辑器的视角来看。

    如果该选项开启，相应的片段将全部合并在一起，形成一个单一的单元或“文件”。

    鉴于此数值模式

    xxx （.+） yyy （.+） zzz

    以及片段

    xxx 选择 * yyy 从 family zzz,

    select * 和 from family 在选项关闭时被视为两个独立的片段（或“文件”）。 如果此选项开启， select * from family 会被视为单个单元或“文件”。

2026年 7月 16日
语言注入设置：通用 Twig语言注入设置对话框：SQL 类型注入