ReflectionProperty::setValue
(PHP 5)
ReflectionProperty::setValue — Задание значения свойству
Описание
Задает (изменяет) значение свойства.
Список параметров
-
object -
Если свойство нестатическое, необходимо передать объект, свойство в котором нужно изменить. Если свойство статическое, этот аргумент пропускается, и требуется задать только
value. -
value -
Новое значение.
Возвращаемые значения
Эта функция не возвращает значения после выполнения.
Ошибки
Вызывает исключение ReflectionException, если свойство недоступно. Можно делать защищенные и частные свойства доступными с помощью ReflectionProperty::setAccessible().
Примеры
Пример #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);
$reflectionProperty->setValue($foo, 'foobar');
var_dump($reflectionProperty->getValue($foo));
?>
Результат выполнения данного примера:
string(3) "foo" string(3) "bar" string(6) "foobar"
Смотрите также
- ReflectionProperty::getValue() - Получение значения
- ReflectionProperty::setAccessible() - Задание доступности свойства
- ReflectionClass::setStaticPropertyValue() - Устанавливает значение static-свойства
- 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.