PhpStorm 2021.3 Help

语言注入

语言注入让您可以使用嵌入在代码中的其他语言的代码片段。当您将一种语言(例如 HTML、CSS、XML、RegExp 等)注入字符串文字时,您将获得用于编辑该文字的全面代码帮助。

在 PHP 上下文中,您可以使用称为Injectable PHP的特殊 PHP 方言。这种方言与 PHP 类似,只是<?php开始标记不同,可以省略。可注入PHP可以手动注入字符串文字,就像任何其他语言一样。此外,它会自动注入到eval()调用和Markdown防护代码块中,语言标识符设置为php.

临时注入一种语言

默认情况下,IDE 会临时注入一种语言。这意味着如果您删除嵌入的元素,注入也会丢失。

  1. 将插入符号放在要在其中注入语言的字符串文字、标记或属性中,然后按Alt+Enter(或使用意图操作图标意图操作图标)。

  2. 选择注入语言或参考,然后选择要注入的语言。

    注入 HTML

打开注入编辑器

  1. 将插入符号放置在注入的代码片段中并按下Alt+Enter(或使用意图操作图标意图操作图标)。

  2. 选择编辑 <语言 ID> 片段

    PhpStorm 将打开一个专门的编辑器部分,用于使用注入的语言编辑代码。此编辑器提供完整的代码帮助,包括代码完成、检查、意图和代码样式操作。

    在专用编辑器中编辑 HTML 片段

使用@lang 注解

在 PHP 上下文中,您还可以使用@lang <language_ID>注解来注入语言。

  • 在目标字符串文字之前提供@lang <language_ID>PHPDoc 注释。语言 ID 通常很直观,例如 SQL、RegExp、XML、HTML。

    使用 lang 注解注入

在 nowdoc/heredoc 字符串中注入一种语言

在 PHP 上下文中,您可以在 nowdoc / heredoc字符串中注入一种语言。

  • 开始输入 heredoc / nowdoc 字符串并将标记设置为您要注入的语言 ID。语言 ID 通常很直观,例如 SQL、RegExp、XML、HTML。

    在 nowdoc/heredoc 中注入

使用语言注入注释

  • 在目标字符串文字前添加一个空行,然后键入以下注释:

    // 语言=<语言 ID>

    对于注释,请使用您要注入的语言的语法。语言 ID 通常是直观的,例如 SQL、RegExp、XML、HTML。

    CSS 注入注释

取消注射

  1. 将插入符号放在代码片段上并按下Alt+Enter(或使用意图操作图标意图操作按钮)。

  2. 选择取消注入语言或参考

要取消语言注入,您还可以删除注入注释或注释。

配置自动注入规则

在 PhpStorm 中,有一组预定义的规则,IDE 根据这些规则自动在代码中的某些位置注入语言。

您可以在编辑器上配置语言注入规则| IDE 设置的语言注入Ctrl+Alt+S页面。

所有预定义的注入规则都是为内置范围配置的。换句话说,它们是全局的(因此在所有 PhpStorm 项目中都可用)。可以为 IDE 或仅为一个项目配置自定义规则。要更改自定义注入的范围,请使用移至项目/IDE 范围按钮.

要通过 VCS 共享自定义规则,请使用工具栏上的相应选项将其移动到项目范围。通过这样做,您将在名为IntelliLang.xml的.idea目录中创建一个新文件,其中包含您可以置于版本控制之下的自定义规则。

如果您不使用 VCS,您可以通过将规则导出到 XML 文件(单击出口工具栏上的 )然后将它们导入到另一个项目来共享您的规则。

要配置自定义注入规则,请单击添加按钮以添加新规则,或复制预定义规则并更改其设置。

最后修改:2022 年 1 月 24 日