Skip to content

Tag reference

@since

The @since tag documents the version in which an element first became available. It is the opposite number of @deprecated: where that tag marks the end of an element’s life, @since marks its beginning, letting consumers check whether a given feature exists in the version they depend on.

Grammar

"@since" [ <Version> ] [ <Description> ]

Examples

A method added in a later minor release.
/**
* @since 1.3 Added to support batched sends.
*/
public function sendMany(iterable $messages): void
Just the version, with no further explanation needed.
/**
* @since 1.0
*/

Names by platform

phpdocumentor
@since

Parsing a @since tag produces a SinceTag instance exposing $version — the version at which the element became available, or null when none was given — alongside the inherited $description. It shares this shape with @deprecated and @version.

abstract class VersionedTag extends Tag
{
public function __construct(
string $name,
public readonly ?string $version = null,
?DescriptionInterface $description = null,
) {
parent::__construct($name, $description);
}
}
final class SinceTag extends VersionedTag {}

Defined by the PSR-19 draft @since proposal and phpDocumentor’s own @since reference.