PHP Conference Nagoya 2025

    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"

    参考

    Found A Problem?

    Learn How To Improve This Page • Submit a Pull Request • Report a Bug
    ＋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"
    ?>
    ＋add a note
    To Top