PHP 8.5.0 Alpha 1 available for testing

ReflectionProperty::getDocComment

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

ReflectionProperty::getDocCommentRecupera el comentario de documentación de una propiedad

Descripción

public ReflectionProperty::getDocComment(): string|false

Recupera el comentario de documentación de una propiedad.

Parámetros

Esta función no tiene parámetros.

Valores devueltos

El comentario de documentación si existe, de lo contrario false.

Ejemplos

Ejemplo #1 ReflectionProperty::getDocComment() ejemplo

<?php
class Str
{
/**
* @var int El tamaño de la cadena de caracteres
*/
public $length = 5;
}

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

var_dump($prop->getDocComment());

?>

El resultado del ejemplo sería algo similar a:

string(53) "/**
     * @var int  El tamaño de la cadena de caracteres
     */"

Ejemplo #2 Múltiples declaraciones de propiedades

Si múltiples declaraciones de propiedades son precedidas por un único comentario de documentación, el comentario de documentación hace referencia únicamente a la primera propiedad.

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

El resultado del ejemplo sería:

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

Ver también

add a note

User Contributed Notes 1 note

up
2
Jim
3 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