PHP TypeLang Help

PhpStorm Tags

The PhpStorm Tags are the annotations that PhpStorm understands as directives to the IDE itself rather than to a command-line analyzer. They do not describe types or generate documentation; they change how the editor treats the surrounding code — suppressing an inspection, injecting a language into a string, marking a call as one that is expected to throw.

Because they steer editor behavior, these tags have no vendor prefix in the @psalm-* sense: they are spelled as ordinary tags (@noinspection, @language) that happen to be meaningful only inside JetBrains tooling.

What This Group Covers

  • Inspection control@noinspection, which silences one or more named IDE inspections for the element that follows.

  • Language injection@language, telling the editor that a string or heredoc contains another language (SQL, JSON, regexp) so it can be highlighted and analyzed accordingly.

  • Test expectations@expected-exception, recording the exception a test is expected to raise.

  • Formatter control@formatter:off and @formatter:on, bracketing a region the reformatter should leave untouched.

For the authoritative behavior, see PhpStorm's documentation on suppressing inspections and its language injection guide.

07 July 2026