PHP マニュアル: 値を取得する

説明

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

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

パラメータ

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