(PHP 5, PHP 7, PHP 8)
ReflectionProperty::setValue — Устанавливает значение свойству
Метод задаёт, или изменяет, значение свойства.
Замечание: Начиная с PHP 8.3.0 вызов метода с единственным аргументом устарел, вместо него вызывают метод ReflectionClass::setStaticPropertyValue().
object
Чтобы метод изменил нестатическое свойство, в метод передают объект.
Если свойство статическое, нужно передать значение null.
valueНовое значение.
Функция не возвращает значения после выполнения.
| Версия | Описание |
|---|---|
| 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"
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:<?phpclass 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"?>setValue can be used for readonly properties, but only if the property has not yet been initialised:<?phpclass 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.Keep in mind that setValue won't work for readonly properties. <?phpclass 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