Skip to content

Platforms

Psalm tags

The Psalm Tags are the annotations that belong to Psalm’s own vocabulary, written under its @psalm-* vendor prefix. Psalm uses the prefix for two purposes: to introduce capabilities the shared PHPDoc convention never had — taint tracking, assertions, mutation freedom — and to offer a Psalm-scoped override of a tag that also exists unprefixed, so that a project can tighten a type for Psalm only without affecting other tools.

Where a Psalm tag is simply the prefixed twin of a tag already documented elsewhere — @psalm-param beside @param, @psalm-return beside @return — the two carry the same meaning; the prefix only says “trust this spelling over the plain one when Psalm is the analyzer reading it.”

The tags here span Psalm’s full feature surface, including:

For the authoritative definitions, see Psalm’s supported annotations.