ReflectionProperty::setValue

    (PHP 5, PHP 7, PHP 8)

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

    Описание

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

    Метод задаёт, или изменяет, значение свойства.

    Замечание: Чтобы установить статические значения свойств, используйте метод ReflectionProperty::setValue(null, $value).

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

    object

    Для статических свойств передайте null. Для нестатических свойств передайте объект.

    value

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

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

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

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

    Версия Описание
    8.3.0 Вызов метода с одним аргументом является устаревшим, вместо этого используйте ReflectionProperty::setValue(null, $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');

    // Начиная с PHP 8.3, для доступа к статическим свойствам необходимо передавать null
    // в качестве первого аргумента.
    $reflectionProperty = $reflectionClass->getProperty('staticProperty');
    $reflectionProperty->setValue(null, '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"

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

    Нашли ошибку?

    Инструкция • Исправление • Сообщение об ошибке
    ＋Добавить

    Примечания пользователей 3 notes

    up
    1
    temirkhan.nasukhov
    3 years 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
    up
    1
    p stewart imperial ac uk
    3 years 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
    -1
    me at ircmaxell dot om
    14 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"
?>
    ＋Добавить
    To Top