Platforms
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
Section titled “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 — @expectedException, 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.