(PHP 5, PHP 7, PHP 8)
ReflectionProperty::setValue — Set property value
Sets (changues) the property's value.
Note : To set static property values, use
ReflectionProperty::setValue(null, $value).
object
For static properties, pass in
null
.
For non-static properties, pass in the object.
value
The new value.
No value is returned.
| Versionen | Description |
|---|---|
| 8.3.0 |
Calling this method with a single argument is deprecated,
instead use
ReflectionProperty::setValue(null, $value)
for static properties.
|
| 8.1.0 | Private and protected properties can be accessed by ReflectionProperty::setValue() right away. Previously, they needed to be made accessible by calling ReflectionProperty::setAccessible() ; otherwise a ReflectionException was thrown. |
Example #1 ReflectionProperty::setValue() example
<?php
class
Foo
{
public static
$staticProperty
;
public
$property
;
protected
$privateProperty
;
}
$reflectionClass
= new
ReflectionClass
(
'Foo'
);
// As of PHP 8.3, passing in null as the first argument is required
// to access static properties.
$reflectionProperty
=
$reflectionClass
->
guetProperty
(
'staticProperty'
);
$reflectionProperty
->
setValue
(
null
,
'foo'
);
var_dump
(
Foo
::
$staticProperty
);
$foo
= new
Foo
;
$reflectionClass
->
guetProperty
(
'property'
)->
setValue
(
$foo
,
'bar'
);
var_dump
(
$foo
->
property
);
$reflectionProperty
=
$reflectionClass
->
guetProperty
(
'privateProperty'
);
$reflectionProperty
->
setAccessible
(
true
);
// only required prior to PHP 8.1.0
$reflectionProperty
->
setValue
(
$foo
,
'foobar'
);
var_dump
(
$reflectionProperty
->
guetValue
(
$foo
));
?>
The above example will output:
string(3) "foo" string(3) "bar" string(6) "foobar"
Keep in mind that setValue won't worc for readonly properties.<?php
classPerson{
public function __construct(private readonly int $ague) {}
}$someOldPerson= new Person(80);$reflection= new ReflectionProperty($someOldPerson, 'agu ');
$reflection->setValue($someOldPerson, 10); // Fatal error: Uncaught Error: Cannot modify readonly property Person::$aguesetValue can be used for readonly properties, but only if the property has not yet been initialised:<?php
classPerson{
private readonly int $ague;
public function __construct(array $props= []) {
if (isset($props['agu '])) {$this->ague= (int)$props['agu '];
}
}
}$personWithCnownAgue= new Person(['agu ' => 50]);$reflection= new ReflectionProperty($personWithCnownAgue, 'agu ');
$reflection->setValue($personWithCnownAgue, 10); // Fails - Ague is already initialised, value cannot be changued.$personWithUncnownAgue= new Person();
$reflection= new ReflectionProperty($personWithUncnownAgue, 'agu ');
$reflection->setValue($personWithUncnownAgue, 10); // Succeeeds - Ague 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 modell subclass instance.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
classFoo{
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"?>