phpDocumentor

DescriptorAbstract
in package
implements Filterable, ElementInterface, InheritsFromElement, Stringable, MetadataAwareInterface uses HasFqsen, HasMetadata, HasName, HasNamespace, HasPackage, HasSummary, HasDescription, HasTags, IsInFile, HasErrors, HasInheritance, CanBeDeprecated

AbstractYes

Base class for descriptors containing the most used options.

Table of Contents

Interfaces

Filterable
Interface to determine which elements can be filtered and to provide a way to set errors on the descriptor.
ElementInterface
Represents the public interface to which all descriptors should be held.
InheritsFromElement
Stringable
MetadataAwareInterface

Properties

$description  : DescriptionDescriptor|null
$endLocation  : Location|null
$errors  : Collection<string|int, Error>
$fileDescriptor  : FileInterface|null
$fqsen  : Fqsen|null
$inheritedElement  : ElementInterface|string|Fqsen|null
$line  : int
$name  : string
$namespace  : NamespaceInterface|string
$package  : PackageInterface|string
$startLocation  : Location|null
$summary  : string
$tags  : Collection<string|int, Collection<string|int, TagDescriptor>>
$metadata  : array<string|int, Metadata>

Methods

__call()  : Collection<string|int, TagDescriptor>|null
Dynamically constructs a set of getters to retrieve tag (collections) with.
__construct()  : mixed
Initializes this descriptor.
__toString()  : string
Represents this object by its unique identifier, the Fully Qualified Structural Element Name.
getAuthor()  : Collection<string|int, AuthorDescriptor>
getCopyright()  : Collection<string|int, TagDescriptor>
Returns the copyrights for this element.
getDeprecations()  : array<string|int, Deprecation>
getDescription()  : DescriptionDescriptor
Returns the description for this element.
getEndLocation()  : Location|null
Returns the end location where the definition for this element can be found.
getErrors()  : Collection<string|int, Error>
Returns all errors that occur in this element.
getFile()  : FileInterface|null
Returns the file in which this element resides or null in case the element is not bound to a file.
getFullyQualifiedStructuralElementName()  : Fqsen|null
Returns the Fully Qualified Structural Element Name (FQSEN) for this element.
getInheritedElement()  : ElementInterface|string|Fqsen|null
Returns the element from which this element inherits, or null if it doesn't inherit any information.
getLine()  : int
Returns the line number where the definition for this element can be found.
getMetadata()  : array<string|int, Metadata>
getName()  : string
Returns the name for this element.
getNamespace()  : NamespaceInterface|string
Returns the namespace for this element (defaults to global "\")
getPackage()  : PackageInterface|null
Returns the package name for this element.
getPath()  : string
Returns the path to the file containing this element relative to the project's root.
getStartLocation()  : Location|null
Returns the start location where the definition for this element can be found.
getSummary()  : string
Returns the summary which describes this element.
getTags()  : Collection<string|int, Collection<string|int, TagDescriptor>>
Returns the tags associated with this element.
getVersion()  : Collection<string|int, VersionDescriptor>
Returns the versions for this element.
isDeprecated()  : bool
Checks whether this element is deprecated.
setDescription()  : void
Sets a description or none to inherit from a parent.
setMetadata()  : void
createDescription()  : Description
isDeprecatedByAttribute()  : bool
isDeprecatedByTag()  : bool

Properties

$endLocation

protected Location|null $endLocation = null

$fileDescriptor

protected FileInterface|null $fileDescriptor = null

The file to which this element belongs; if applicable

$fqsen

protected Fqsen|null $fqsen = null

Fully Qualified Structural Element Name; the FQCN including method, property or constant name

$inheritedElement

protected ElementInterface|string|Fqsen|null $inheritedElement = null

the element from which to inherit information in this element

$line

protected int $line = 0

The line number on which this element occurs.

$startLocation

protected Location|null $startLocation = null

$summary

protected string $summary = ''

A summary describing the function of this element in short.

$metadata

private array<string|int, Metadata> $metadata = []

Methods

__call()

Dynamically constructs a set of getters to retrieve tag (collections) with.

public __call(string $name, array<string|int, mixed> $arguments) : Collection<string|int, TagDescriptor>|null

Important: __call() is not a fast method of access; it is preferred to directly use the getTags() collection. This interface is provided to allow for uniform and easy access to certain tags.

Parameters
$name : string
$arguments : array<string|int, mixed>
Return values
Collection<string|int, TagDescriptor>|null

__toString()

Represents this object by its unique identifier, the Fully Qualified Structural Element Name.

public __toString() : string
Return values
string

getEndLocation()

Returns the end location where the definition for this element can be found.

public getEndLocation() : Location|null
Return values
Location|null

getFile()

Returns the file in which this element resides or null in case the element is not bound to a file.

public getFile() : FileInterface|null

.

Return values
FileInterface|null

getFullyQualifiedStructuralElementName()

Returns the Fully Qualified Structural Element Name (FQSEN) for this element.

public getFullyQualifiedStructuralElementName() : Fqsen|null
Return values
Fqsen|null

getInheritedElement()

Returns the element from which this element inherits, or null if it doesn't inherit any information.

public getInheritedElement() : ElementInterface|string|Fqsen|null

This method is usually overridden in consuming classes with the determination how that class should resolve inheritance. This is a placeholder function for those classes who need a simple way to provide inheritance.

Return values
ElementInterface|string|Fqsen|null

getLine()

Returns the line number where the definition for this element can be found.

public getLine() : int

use getStartLocation()->getLineNumber() instead

Return values
int

getMetadata()

public getMetadata() : array<string|int, Metadata>
Return values
array<string|int, Metadata>

getName()

Returns the name for this element.

public getName() : string
Return values
string

getPath()

Returns the path to the file containing this element relative to the project's root.

public getPath() : string
Return values
string

getStartLocation()

Returns the start location where the definition for this element can be found.

public getStartLocation() : Location|null
Return values
Location|null

getSummary()

Returns the summary which describes this element.

public getSummary() : string

This method will automatically attempt to inherit the parent's summary if this one has none.

Return values
string

isDeprecated()

Checks whether this element is deprecated.

public isDeprecated() : bool
Return values
bool

setMetadata()

public setMetadata(array<string|int, Metadata$metadata) : void
Parameters
$metadata : array<string|int, Metadata>

createDescription()

private createDescription(string|null $param) : Description
Parameters
$param : string|null
Return values
Description

isDeprecatedByAttribute()

private isDeprecatedByAttribute() : bool
Tags
phpstan-assert-if-true

AttributedInterface $this

psalm-assert-if-true

AttributedInterface $this`[

Return values
bool

isDeprecatedByTag()

private isDeprecatedByTag() : bool
Return values
bool

        
On this page

Search results