La classe ReflectionProperty

(PHP 5, PHP 7, PHP 8)

Introduction

La classe ReflectionProperty rapporte des informations sur les propriétés des classes.

Synopsis de la classe

class ReflectionProperty implements Reflector {
/* Constantes */
public const int IS_STATIC;
public const int IS_READONLY;
public const int IS_PUBLIC;
public const int IS_PROTECTED;
public const int IS_PRIVATE;
public const int IS_ABSTRACT;
public const int IS_PROTECTED_SET;
public const int IS_PRIVATE_SET;
public const int IS_VIRTUAL;
public const int IS_FINAL;
/* Propriétés */
public string $name;
public string $class;
/* Méthodes */
public function __construct(object|string $class, string $property)
private function __clone(): void
public static function export(mixed $class, string $name, bool $return = ?): string
public function getAttributes(?string $name = null, int $flags = 0): array
public function getDefaultValue(): mixed
public function getDocComment(): string|false
public function getHooks(): array
public function getModifiers(): int
public function getName(): string
public function getRawValue(object $object): mixed
public function getSettableType(): ?ReflectionType
public function getType(): ?ReflectionType
public function getValue(?object $object = null): mixed
public function hasDefaultValue(): bool
public function hasHook(PropertyHookType $type): bool
public function hasHooks(): bool
public function hasType(): bool
public function isAbstract(): bool
public function isDefault(): bool
public function isDynamic(): bool
public function isFinal(): bool
public function isInitialized(?object $object = null): bool
public function isLazy(object $object): bool
public function isPrivate(): bool
public function isPrivateSet(): bool
public function isPromoted(): bool
public function isProtected(): bool
public function isProtectedSet(): bool
public function isPublic(): bool
public function isReadOnly(): bool
public function isStatic(): bool
public function isVirtual(): bool
#[\Deprecated]
public function setAccessible(bool $accessible): void
public function setRawValue(object $object, mixed $value): void
public function setRawValueWithoutLazyInitialization(object $object, mixed $value): void
public function setValue(?object $object, mixed $value): void
public function skipLazyInitialization(object $object): void
public function __toString(): string
}

Propriétés

name

Nom de la propriété. En lecture seule, lance une ReflectionException lors d'une tentative d'écriture.

class

Nom de la classe où la propriété a été définie. En lecture seule, lance une ReflectionException lors d'une tentative d'écriture.

Constantes pré-définies

Modificateurs de ReflectionProperty

ReflectionProperty::IS_STATIC int

Indique que la propriété est static Antérieur à PHP 7.4.0, la valeur était 1.

ReflectionProperty::IS_READONLY int

Indique que la propriété est readonly Disponible à partir de PHP 8.1.0.

ReflectionProperty::IS_PUBLIC int

Indique que la propriété est publique. Antérieur à PHP 7.4.0, la valeur était 256.

ReflectionProperty::IS_PROTECTED int

Indique que la propriété est protégée. Antérieur à PHP 7.4.0, la valeur était 512.

ReflectionProperty::IS_PRIVATE int

Indique que la propriété est privée. Antérieur à PHP 7.4.0, la valeur était 1024.

ReflectionProperty::IS_ABSTRACT int
Indique que la propriété est abstraite. Disponible à partir de PHP 8.4.0.
ReflectionProperty::IS_PROTECTED_SET int
Disponible à partir de PHP 8.4.0.
ReflectionProperty::IS_PRIVATE_SET int
Disponible à partir de PHP 8.4.0.
ReflectionProperty::IS_VIRTUAL int
Disponible à partir de PHP 8.4.0.
ReflectionProperty::IS_FINAL int
Indique que la propriété est finale. Disponible à partir de PHP 8.4.0.

Note:

La valeur de ces constantes peut changer entre les versions de PHP. Il est recommandé de toujours utiliser les constantes et de ne pas dépendre des valeurs directement.

Historique

Version Description
8.4.0 Les constantes de classe sont désormais typées.
8.4.0 Ajout de ReflectionProperty::IS_VIRTUAL, ReflectionProperty::IS_PRIVATE_SET, ReflectionProperty::IS_PROTECTED_SET, ReflectionProperty::IS_ABSTRACT, et ReflectionProperty::IS_FINAL.
8.0.0 ReflectionProperty::export() a été supprimée.

Sommaire

add a note

User Contributed Notes 1 note

up
7
rasmus at mindplay dot dk
15 years ago
I think a more accurate explanation is this:

The Reflection classes are designed to reflect upon the source code of an application, not on any runtime information.

I think you misunderstand the ReflectionProperty constructor in your example above. The fact that it accepts an object as argument is just a convenience feature - you are actually inspecting the class of that object, not the object itself, so it's basically equivalent to:

<?php

// works fine 
$Reflection = new ReflectionProperty(get_class($a), 'a');

// throws exception 
$Reflection = new ReflectionProperty(get_class($a), 'foo');

?>

Getting the class of the object you're passing in is implied, since inspecting a defined property is the purpose of this class.

In your example, $a->foo is a dynamic member - it is not defined as a member of class, so there is no defining class reference, line number, default value, etc. - which means, there is nothing to reflect upon.

Clearly this very useful library could use some real documentation...
To Top