ReflectionProperty::getDocComment

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

ReflectionProperty::getDocCommentПолучение doc-комментария для свойства

Описание

public ReflectionProperty::getDocComment(): string|false

Получает doc-комментарий для свойства.

Список параметров

У этой функции нет параметров.

Возвращаемые значения

Doc-комментарий, если он существует, в противном случае false.

Примеры

Пример #1 Пример ReflectionProperty::getDocComment()

<?php
class Str
{
/**
* @var int Длина строки
*/
public $length = 5;
}

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

var_dump($prop->getDocComment());

?>

Вывод приведённого примера будет похож на:

string(52) "/**
     * @var int  Длина строки
     */"

Пример #2 Декларация нескольких свойств

Если doc-комментарий задан перед множественной декларацией, то он будет считаться относящимся только к первому из них.

<?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;
}
?>

Результат выполнения приведённого примера:

a: '/** @var string */'
b: false

Смотрите также

add a note add a note

User Contributed Notes 1 note

up
1
Jim
2 years ago
Unfortunately, inherited doc comments are not supported.

<?php

class A {
   
/**
     * @var string
     */
   
public string $prop = 'A';
}

class
B extends A {
    public
string $prop = 'B';
}

$prop = new ReflectionProperty('B', 'prop');
var_dump($prop->getDocComment());

?>

results in FALSE
To Top