@version
The @version tag documents the current version of the element it annotates, most often placed once on a file or class to record which release it corresponds to. This differs from @since, which records when a particular feature was first introduced: @version names what the element currently is, not when any part of it arrived.
"@version" [ <Version> ] [ <Description> ]
Parsing a @version tag produces a VersionTag instance exposing $version — the current version of the element, or null when none was given — alongside the inherited $description. It shares this shape with @since and @deprecated.
final class VersionTag extends VersionedTag
{
// extends VersionedTag; adds nothing
// beyond the inherited $version,
// $name and $description.
}
Defined by the PSR-19 draft (FIG proposed PHPDoc Tags, §5.19) and by phpDocumentor.
05 July 2026