ReflectionProperty クラス

(PHP 5, PHP 7, PHP 8)

はじめに

ReflectionProperty クラスは クラスのプロパティについての情報を報告します。

クラス概要

class ReflectionProperty implements Reflector {
/* 定数 */
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 string $name;
public string $class;
/* メソッド */
public __construct(object|string $class, string $property)
private __clone(): void
public static export(mixed $class, string $name, bool $return = ?): string
public getAttributes(?string $name = null, int $flags = 0): array
public getModifiers(): int
public getName(): string
public getValue(?object $object = null): mixed
public hasType(): bool
public isDefault(): bool
public isInitialized(?object $object = null): bool
public isPrivate(): bool
public isPromoted(): bool
public isProtected(): bool
public isPublic(): bool
public isReadOnly(): bool
public isStatic(): bool
public setAccessible(bool $accessible): void
public setValue(object $object, mixed $value): void
public __toString(): string
}

プロパティ

name

プロパティ名。読み込み専用で、書き込もうとすると ReflectionException をスローします。

class

プロパティが定義されているクラス名。読み込み専用で、書き込もうとすると ReflectionException をスローします。

定義済み定数

ReflectionProperty の修飾子

ReflectionProperty::IS_STATIC

static プロパティを示します。 PHP 7.4.0 より前のバージョンでは、この値は 1 でした。

ReflectionProperty::IS_READONLY

readonly プロパティを示します。 PHP 8.1.0 以降で利用可能です。

ReflectionProperty::IS_PUBLIC

public プロパティを示します。 PHP 7.4.0 より前のバージョンでは、この値は 256 でした。

ReflectionProperty::IS_PROTECTED

protected プロパティを示します。 PHP 7.4.0 より前のバージョンでは、この値は 512 でした。

ReflectionProperty::IS_PRIVATE

private プロパティを示します。 PHP 7.4.0 より前のバージョンでは、この値は 1024 でした。

注意:

これらの定数の値は、PHP のバージョンが異なると変更される可能性があります。 これらの値を直接用いず、常に定数を使うことを推奨します。

変更履歴

バージョン 説明
8.0.0 ReflectionProperty::export() は、削除されました。

目次

add a note add a note

User Contributed Notes 2 notes

up
6
rasmus at mindplay dot dk
13 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...
up
-6
Nanhe Kumar
10 years ago
<?php
//serialize static properties (class variable)

class Student {

    private
$members = array();
    protected
$name;
    public static
$noOfStudent;

    public function
__construct($name = 'Nanhe Kumar') {
       
$this->name = $name;
       
Student::$noOfStudent++;
    }

    public function
__sleep() {
       
$vars = get_class_vars(get_class($this));
        foreach (
$vars as $key => $val) {
            if (!empty(
$val))
               
$this->members[$key] = $val;
        }
        return
array_keys(get_object_vars($this));
    }

    public function
__wakeup() {
        foreach (
$this->members as $key => $val) {
           
$prop = new ReflectionProperty(get_class($this), $key);
           
$prop->setValue(get_class($this), $val);
        }
       
$this->members = array();
    }

    public function
getTotalStudent() {
        return
self::$noOfStudent;
    }

}

$so1 = new Student();
$so2 = new Student();
$serialized = serialize($so1);
print_r($serialized); //O:7:"Student":2:{s:16:"Studentmembers";a:1:{s:11:"noOfStudent";i:2;}s:7:"*name";s:11:"Nanhe Kumar";}
$unserialized = unserialize($serialized);
print_r($unserialized); //Student Object ( [members:Student:private] => Array ( ) [name:protected] => Nanhe Kumar )
echo Student::$noOfStudent; //2
?>
To Top