Submit a Pull Request Report a Bug

    ReflectionProperty::setValue

    (PHP 5, PHP 7, PHP 8)

    ReflectionProperty::setValue — Установка значения свойства

    Описание

    public ReflectionProperty::setValue(object $object, mixed $value): void
    public ReflectionProperty::setValue(mixed $value): void

    Задаёт (изменяет) значение свойства.

    Список параметров

    object

    Если свойство нестатическое, необходимо передать объект, свойство в котором нужно изменить. Если свойство статическое, этот аргумент пропускается, и требуется задать только value.

    value

    Новое значение.

    Возвращаемые значения

    Функция не возвращает значения после выполнения.

    Список изменений

    Версия Описание
    8.1.0 Доступ к закрытым и защищённым свойствам можно сразу же получить с помощью метода ReflectionProperty::getValue(). Ранее их нужно было сделать доступными с помощью метода ReflectionProperty::setAccessible(); в противном случае выбрасывалось исключение ReflectionException.

    Примеры

    Пример #1 Пример использования ReflectionProperty::setValue()

    <?php
    class Foo {
    public static     $staticProperty;

    public     $property;
    protected     $privateProperty;
    }

    $reflectionClass = new ReflectionClass('Foo');

    $reflectionClass->getProperty('staticProperty')->setValue('foo');
    var_dump(Foo::$staticProperty);

    $foo = new Foo;

    $reflectionClass->getProperty('property')->setValue($foo, 'bar');
    var_dump($foo->property);

    $reflectionProperty = $reflectionClass->getProperty('privateProperty');
    $reflectionProperty->setAccessible(true); // требуется только до PHP 8.1.0
    $reflectionProperty->setValue($foo, 'foobar');
    var_dump($reflectionProperty->getValue($foo));
    ?>

    Результат выполнения данного примера:

    string(3) "foo"
string(3) "bar"
string(6) "foobar"

    Смотрите также

    ＋add a note

    User Contributed Notes 3 notes

    up
    2
    me at ircmaxell dot om
    12 years ago
    You can use ReflectionProperty::setValue to set the value on static properties as well as regular instance properties. Simply pass null in place of the instance:

    <?php
    class Foo {
    protected static     $bar = null;
    public static function     sayBar() {
    echo     self::$bar;
    }
    }

    $r = new ReflectionProperty('Foo', 'bar');
    $r->setAccessible(true);
    $r->setValue(null, 'foo');

    Foo::sayBar(); // "foo"
    ?>
    up
    2
    p stewart imperial ac uk
    11 months ago
    setValue can be used for readonly properties, but only if the property has not yet been initialised:

    <?php

    class Person
    {
    private readonly     int $age;
    public function     __construct(array $props = []) {
    if (isset(    $props['age'])) {
    $this->age = (int)$props['age'];
    }
    }
    }

    $personWithKnownAge = new Person(['age' => 50]);

    $reflection = new ReflectionProperty($personWithKnownAge, 'age');
    $reflection->setValue($personWithKnownAge, 10); // Fails - Age is already initialised, value cannot be changed.

    $personWithUnknownAge = new Person();

    $reflection = new ReflectionProperty($personWithUnknownAge, 'age');
    $reflection->setValue($personWithUnknownAge, 10); // Succeeeds - Age is not yet initialised, value can be set.
    ?>

    This can be useful for situations where it is desirable to initialise properties from outside of the defining class, for example an ORM setup where the parent class is responsible for setting properties on a model subclass instance.
    up
    0
    temirkhan.nasukhov
    1 year ago
    Keep in mind that setValue won't work for readonly properties.

    <?php

    class Person
    {
    public function     __construct(private readonly int $age) {}
    }

    $someOldPerson = new Person(80);

    $reflection = new ReflectionProperty($someOldPerson, 'age');
    $reflection->setValue($someOldPerson, 10); // Fatal error: Uncaught Error: Cannot modify readonly property Person::$age
    ＋add a note
    To Top