Syntax

@see [URI | FQSEN] [<description>]

or inline

{@see [URI | FQSEN] [<description>]}

Description

The @see tag can be used to define a reference to other Structural Elements or to a URI.

When defining a reference to other Structural Elements, you can refer to a specific element by appending a double colon and providing the name of that element (also called the "Fully Qualified Structural Element Name" or _FQSEN_).

A URI MUST be complete and well-formed as specified in RFC 2396.

The @see tag SHOULD have a description to provide additional information regarding the relationship between the element and its target.

The @see tag cannot refer to a namespace element.

Effects in phpDocumentor

Structural Elements, or inline text in a long description, tagged with the @see tag will show a link in their description.

If a description is provided with the inline version of tag then this will be used as link text instead of the URL itself.

In addition, phpDocumentor provides the doc:// virtual scheme. When you provide this scheme, phpDocumentor will interpret that as a reference to .

Examples

Normal tag:

/**
 * @see number_of()                 Alias.
 * @see MyClass::$items             For the property whose items are counted.
 * @see MyClass::setItems()         To set the items for this collection.
 * @see https://example.com/my/bar  Documentation of Foo.
 * @see doc://getting-started/index Getting started document.
 *
 * @return int Indicates the number of items.
 */
function count()
{
    <...>
}

Inline tag:

/**
 * @return int Indicates the number of {@see \Vendor\Package\ClassName}
 *             items.
 */
function count()
{
    <...>
}