PhpStorm 2026.3 Help

语言注入设置：通用 PHP

当您在 语言注入 页面中点击  ，并从上下文菜单中选择 通用 PHP ，或选择一个条目并点击 时，将打开该对话框。

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

项目

描述

名称

注入的名称。

语言

要注入的语言。

  • ID: 选择要 inject 的语言的 ID 或名称。

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

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

前缀和后缀是可选的。

位置模式

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

示例：

在 HTML 开启* 事件属性中 inject JavaScript：

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

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

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

多个模式

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

高级

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

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

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

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

    鉴于此数值模式

    xxx (.+) yyy (.+) zzz

    以及片段

    xxx select * yyy from family zzz，

    如果该选项关闭， select * 和 from family 将被视为两个独立的片段（或 "文件"）。 如果该选项开启， select * from family 将被视为一个单元，或 "文件"。

2026年 11月 9日
语言注入设置对话框：JS Tagged Literal 注入语言注入设置：通用 Smarty