Home/ Manual/ reflection / reflectionproperty/ ReflectionProperty::getDocComment

ReflectionProperty::getDocComment

PHP function Edit on GitHub ✎

(PHP 5 >= 5.1.0, PHP 7, PHP 8)

Gets the property doc comment

Description

ReflectionProperty::getDocComment(): string|false

Gets the doc comment for a property.

Parameters Parameters

Return Values

The doc comment if it exists, otherwise false.

Examples

ReflectionProperty::getDocComment example

php

<?php
class Str
{
    /**
     * @var int  The length of the string
     */
    public $length = 5;
}

$prop = new ReflectionProperty('Str', 'length');

var_dump($prop->getDocComment());

?>

The above example will output something similar to:

output

string(53) "/**
     * @var int  The length of the string
     */"

Multiple property declarations

If multiple property declarations are preceded by a single doc comment, the doc comment refers to the first property only.

php

<?php
class Foo
{
    /** @var string */
    public $a, $b;
}
$class = new \ReflectionClass('Foo');
foreach ($class->getProperties() as $property) {
    echo $property->getName() . ': ' . var_export($property->getDocComment(), true) . PHP_EOL;
}
?>

The above example will output: