ReflectionProperty::setValue

(PHP 5, PHP 7, PHP 8)

ReflectionProperty::setValue — Define valor da propriedade

Descrição

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

public ReflectionProperty::setValue(mixed $value): void

Define (altera) o valor da propriedade.

Nota: A partir do PHP 8.3.0, chamar este método com um único argumento está descontinuado, use ReflectionClass::setStaticPropertyValue() em seu lugar.

Parâmetros

object: Se a propriedade não for estática, um objeto deverá ser fornecido para alterar a propriedade. Se a propriedade for estática, um valor null deve ser fornecido.
value: O novo valor.

Valor Retornado

Nenhum valor é retornado.

Registro de Alterações

Versão	Descrição
8.3.0	Chamar este método com um único argumento está descontinuado, ReflectionClass::setStaticPropertyValue() deve ser usado para modificar propriedades estáticas.
8.1.0	Propriedades privadas e protegidas podem ser acessadas por ReflectionProperty::setValue() imediatamente. Anteriormente, eles precisavam ser acessíveis chamando ReflectionProperty::setAccessible(); caso contrário, uma ReflectionException era lançada.

Exemplos

Exemplo #1 Exemplo de ReflectionProperty::setValue()

<?php
class Foo {
    public static $staticProperty;

    public $property;
    protected $privateProperty;
}

$reflectionClass = new ReflectionClass('Foo');

// A partir do PHP 8.3, setValue não deve mais ser usado para definir o valor de propriedade estática, use setStaticPropertyValue() no lugar
$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); // only required prior to PHP 8.1.0
$reflectionProperty->setValue($foo, 'foobar');
var_dump($reflectionProperty->getValue($foo));
?>

O exemplo acima produzirá:

string(3) "foo"
string(3) "bar"
string(6) "foobar"

Veja Também

ReflectionProperty::getValue() - Obtém o valor
ReflectionProperty::setAccessible() - Define acessibilidade da propriedade
ReflectionClass::setStaticPropertyValue() - Define o valor da propriedade estática

Improve This Page

Learn How To Improve This Page • Submit a Pull Request • Report a Bug

＋add a note

User Contributed Notes 3 notes

down

me at ircmaxell dot om ¶

12 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"
?>

down

p stewart imperial ac uk ¶

1 year 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.

down

-1

temirkhan.nasukhov ¶

1 year 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

＋add a note