ReflectionProperty::setValue

(PHP 5, PHP 7, PHP 8)

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

Описание

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

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

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

Замечание: Начиная с PHP 8.3.0, вызов этого метода с единственным аргументом устарел, вместо него необходимо вызывать метод ReflectionClass::setStaticPropertyValue().

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

object: Если свойство нестатическое, необходимо передать объект, свойство в котором нужно изменить. Если свойство статическое, должно быть передано значение null.
value: Новое значение.

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

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

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

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

Версия

Описание

8.3.0

Вызов этого метода с единственным аргументом устарел, вместо него для изменения статического свойства необходимо вызывать метод ReflectionClass::setStaticPropertyValue().

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');

// С PHP 8.3 больше не нужно вызывать метод setValue для установки значения статического свойства, вместо него необходимо использовать метод setStaticPropertyValue()
$reflectionClass->setStaticPropertyValue('staticProperty', '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"

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

ReflectionProperty::getValue() - Получает значение
ReflectionProperty::setAccessible() - Делает свойство доступным
ReflectionClass::setStaticPropertyValue() - Устанавливает значение статического свойства

add a note

User Contributed Notes 3 notes

down

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"
?>

down

p stewart imperial ac uk ¶

1 year 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.

down

-1

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