Language injections let you work with pieces of code inside string literals as well as tags or attributes in XML-like languages.
When you have a piece of formal language (such as HTML, CSS, XML, RegExp, and so on) inside a string literal, a tag, or an attribute, you can get comprehensive language assistance for editing that piece.
Temporarily inject a language
Position the caret inside the string literal, tag, or attribute, in which you want to inject a language and press Alt+Enter (or use the intention action icon ).
Select Inject language or reference and choose the language you want to inject.
Open a code fragment in the dedicated editor section
Position the caret within the injected code piece and press Alt+Enter (or use the intention action icon ).
Select Edit <language ID> Fragment.
PhpStorm will open a dedicated editor section for editing the code with the injected language. This editor provides full code assistance, including code completion, inspections, intentions and code style actions.
Use the @lang annotation
In the PHP context, you can also use the
@lang <language_ID> annotation to inject a language.
@lang <language_ID>PHPDoc annotation preceding the target string literal. Language IDs are generally intuitive, for example SQL, RegExp, XML, HTML.
Inject a language inside a nowdoc/heredoc string
Start typing a heredoc / nowdoc string and set the marker to the language ID you want to inject. Language IDs are generally intuitive, for example SQL, RegExp, XML, HTML.
Use language injection comments
Add a blank line before the target string literal, and type the following comment:
For comments, use the syntax of the language you want to inject. Language IDs are generally intuitive, for example, SQL, RegExp, XML, HTML.
Position the caret at the code fragment and press Alt+Enter (or use the intention action icon ).
Select Uninject language or reference.
To cancel a language injection, you can also delete the injection comment or annotation.
Configure injection rules
All pre-defined injection rules are configured for the Built-in scope. In other words, they are global (and therefore available in all PhpStorm projects). Custom rules can be configured for the IDE or for one project only. To change the scope of custom injections, use the .
To configure custom injection rules, click to add a new rule, or copy a predefined rule and change its settings.