ReflectionProperty::setValue
(PHP 5)
ReflectionProperty::setValue — Set property value
Description
Sets (changes) the property's value.
Parameters
-
object -
If the property is non-static an object must be provided to change the property on. If the property is static this parameter is left out and only
valueneeds to be provided. -
value -
The new value.
Return Values
No value is returned.
Errors/Exceptions
Throws a ReflectionException if the property is inaccessible. You can make a protected or private property accessible using ReflectionProperty::setAccessible().
Examples
Example #1 ReflectionProperty::setValue() example
<?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);
$reflectionProperty->setValue($foo, 'foobar');
var_dump($reflectionProperty->getValue($foo));
?>
The above example will output:
string(3) "foo" string(3) "bar" string(6) "foobar"
See Also
- ReflectionProperty::getValue() - Gets value
- ReflectionProperty::setAccessible() - Set property accessibility
- ReflectionClass::setStaticPropertyValue() - Sets static property value
- PHP Руководство
- Функции по категориям
- Индекс функций
- Справочник функций
- Расширения, относящиеся к переменным и типам
- Reflection
- Функция ReflectionProperty::__clone() - Копирующий конструктор
- Функция ReflectionProperty::__construct() - Конструктор класса ReflectionProperty
- Функция ReflectionProperty::export() - Экспорт
- Функция ReflectionProperty::getDeclaringClass() - Получение объявляющего класса
- Функция ReflectionProperty::getDocComment() - Получение документируемого комментария
- Функция ReflectionProperty::getModifiers() - Получение модификаторов
- Функция ReflectionProperty::getName() - Получение имени свойства
- Функция ReflectionProperty::getValue() - Получение значения
- Функция ReflectionProperty::isDefault() - Проверяет, является ли значение свойством по умолчанию
- Функция ReflectionProperty::isPrivate() - Проверяет, является ли свойство частным (private)
- Функция ReflectionProperty::isProtected() - Проверяет, является ли свойство защищенным (protected)
- Функция ReflectionProperty::isPublic() - Проверяет, является ли свойство общедоступным (public)
- Функция ReflectionProperty::isStatic() - Проверка, является ли свойство статическим
- Функция ReflectionProperty::setAccessible() - Задание доступности свойства
- Функция ReflectionProperty::setValue() - Задание значения свойству
- Функция ReflectionProperty::__toString() - Преобразование в строку
Коментарии
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"
?>
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
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.