説明

public ReflectionProperty::getValue(?object $object = null): mixed

プロパティの値を取得します。

パラメータ

object: static でないプロパティの場合は、プロパティを取得したいオブジェクトを指定しなければなりません。オブジェクトを指定せずにデフォルトのプロパティを取得したい場合は、かわりに ReflectionClass::getDefaultProperties() を使います。

戻り値

プロパティの現在の値を返します。

変更履歴

バージョン	説明
8.1.0	private と protected なプロパティは ReflectionProperty::getValue() ですぐにアクセスできるようになりました。これより前のバージョンでは、 ReflectionProperty::setAccessible() をコールすることでアクセスできるようにする必要がありました。そうしない場合、 ReflectionException がスローされていました。
8.0.0	`object` は、nullable になりました。

例

例1 ReflectionProperty::getValue() の例

<?php
class Foo {
    public static $staticProperty = 'foobar';
    
    public $property = 'barfoo';
    protected $privateProperty = 'foofoo';
}

$reflectionClass = new ReflectionClass('Foo');

var_dump($reflectionClass->getProperty('staticProperty')->getValue());
var_dump($reflectionClass->getProperty('property')->getValue(new Foo));

$reflectionProperty = $reflectionClass->getProperty('privateProperty');
$reflectionProperty->setAccessible(true); // PHP 8.1.0 より前のバージョンのみ、この行の実行が必須でした
var_dump($reflectionProperty->getValue(new Foo));
?>

上の例の出力は以下となります。

string(6) "foobar"
string(6) "barfoo"
string(6) "foofoo"

参考

ReflectionProperty::setValue() - プロパティの値を設定する
ReflectionProperty::setAccessible() - プロパティのアクセス範囲を設定する
ReflectionClass::getDefaultProperties() - デフォルトプロパティを取得する
ReflectionClass::getStaticPropertyValue() - staticプロパティの値を取得する