ReflectionProperty::getValue

(PHP 5, PHP 7, PHP 8)

ReflectionProperty::getValue値を取得する

説明

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"

参考

add a note

User Contributed Notes 1 note

up
9
sergiy dot sokolenko at gmail dot com
14 years ago
To allow protected and private properties to be accessed, you should use
ReflectionProperty::setAccessible(bool $accessible):

<?php
/** Class Foo with protected and private members */
class Foo {
protected
$bar = 'barrr!';
private
$baz = 'bazzz!';
}

$reflFoo = new ReflectionClass('Foo');
$reflBar = $reflFoo->getProperty('bar');
$reflBaz = $reflFoo->getProperty('baz');

// Set private and protected members accessible for getValue/setValue
$reflBar->setAccessible(true);
$reflBaz->setAccessible(true);

$foo = new Foo();
echo
$reflBar->getValue($foo); // will output "barrr!"
echo $reflBaz->getValue($foo); // will output "bazzz!"

// You can also setValue
$reflBar->setValue($foo, "new value");
echo
$reflBar->getValue($foo); // will output "new value"
?>
To Top