La classe ReflectionClass

(PHP 5, PHP 7, PHP 8)

Introduction

La classe ReflectionClass rapporte des informations sur une classe.

Synopsis de la classe

class ReflectionClass implements Reflector {
/* Constantes */
public const int IS_IMPLICIT_ABSTRACT;
public const int IS_FINAL;
public const int IS_READONLY;
public const int SKIP_DESTRUCTOR;
/* Propriétés */
public string $name;
/* Méthodes */
public function __construct(object|string $objectOrClass)
public static function export(mixed $argument, bool $return = false): string
public function getAttributes(?string $name = null, int $flags = 0): array
public function getConstant(string $name): mixed
public function getConstants(?int $filter = null): array
public function getDefaultProperties(): array
public function getDocComment(): string|false
public function getEndLine(): int|false
public function getExtensionName(): string|false
public function getFileName(): string|false
public function getInterfaceNames(): array
public function getInterfaces(): array
public function getLazyInitializer(object $object): ?callable
public function getMethod(string $name): ReflectionMethod
public function getMethods(?int $filter = null): array
public function getModifiers(): int
public function getName(): string
public function getNamespaceName(): string
public function getProperties(?int $filter = null): array
public function getProperty(string $name): ReflectionProperty
public function getReflectionConstants(?int $filter = null): array
public function getShortName(): string
public function getStartLine(): int|false
public function getStaticProperties(): array
public function getStaticPropertyValue(string $name, mixed &$def_value = ?): mixed
public function getTraitAliases(): array
public function getTraitNames(): array
public function getTraits(): array
public function hasConstant(string $name): bool
public function hasMethod(string $name): bool
public function hasProperty(string $name): bool
public function implementsInterface(ReflectionClass|string $interface): bool
public function initializeLazyObject(object $object): object
public function inNamespace(): bool
public function isAbstract(): bool
public function isAnonymous(): bool
public function isCloneable(): bool
public function isEnum(): bool
public function isFinal(): bool
public function isInstance(object $object): bool
public function isInstantiable(): bool
public function isInterface(): bool
public function isInternal(): bool
public function isIterable(): bool
public function isReadOnly(): bool
public function isSubclassOf(ReflectionClass|string $class): bool
public function isTrait(): bool
public function isUninitializedLazyObject(object $object): bool
public function isUserDefined(): bool
public function markLazyObjectAsInitialized(object $object): object
public function newInstance(mixed ...$args): object
public function newInstanceArgs(array $args = []): ?object
public function newLazyGhost(callable $initializer, int $options = 0): object
public function newLazyProxy(callable $factory, int $options = 0): object
public function resetAsLazyGhost(object $object, callable $initializer, int $options = 0): void
public function resetAsLazyProxy(object $object, callable $factory, int $options = 0): void
public function setStaticPropertyValue(string $name, mixed $value): void
public function __toString(): string
}

Propriétés

name

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

Constantes pré-définies

Modificateurs de ReflectionClass

ReflectionClass::IS_IMPLICIT_ABSTRACT int

Indique si la classe est abstraite car elle contient des méthodes abstraites.

ReflectionClass::IS_EXPLICIT_ABSTRACT int

Indique si la classe est abstraite en raison de sa définition.

ReflectionClass::IS_FINAL int

Indique si la classe est finale.

ReflectionClass::IS_READONLY int

Indique si la classe est readonly.

ReflectionClass::SKIP_INITIALIZATION_ON_SERIALIZE int
Indique que serialize() ne doit pas déclencher l'initialisation d'un objet en chargement paresseux.
ReflectionClass::SKIP_DESTRUCTOR int
Indique qu'un destructeur d'objet ne doit pas être appelé lors de sa réinitialisation en tant qu'objet paresseux.

Historique

Version Description
8.4.0 Les constantes de classe sont désormais typées.
8.0.0 ReflectionClass::export() a été supprimée.

Sommaire

add a note

User Contributed Notes 4 notes

up
41
danbettles at yahoo dot co dot uk
17 years ago
To reflect on a namespaced class in PHP 5.3, you must always specify the fully qualified name of the class - even if you've aliased the containing namespace using a "use" statement.

So instead of:

<?php
use App\Core as Core;
$oReflectionClass = new ReflectionClass('Core\Singleton');
?>

You would type:

<?php
use App\Core as Core;
$oReflectionClass = new ReflectionClass('App\Core\Singleton');
?>
up
26
Anonymous
14 years ago
Unserialized reflection class cause error.

<?php
/**
 * abc
 */
class a{}

$ref = new ReflectionClass('a');
$ref = unserialize(serialize($ref));
var_dump($ref);
var_dump($ref->getDocComment());

// object(ReflectionClass)#2 (1) {
//   ["name"]=>
//   string(1) "a"
// }
// PHP Fatal error:  ReflectionClass::getDocComment(): Internal error: Failed to retrieve the reflection object
?>
up
21
Anonymous
13 years ago
Reflecting an alias will give you a reflection of the resolved class.

<?php

class X {
    
}

class_alias('X','Y');
class_alias('Y','Z');
$z = new ReflectionClass('Z');
echo $z->getName(); // X

?>
up
5
featherbits
5 years ago
In order to get class attributes look here (php8)
https://www.php.net/manual/en/language.attributes.reflection.php
To Top