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: Para definir valores de propriedades estáticas, use ReflectionProperty::setValue(null, $value).

    Parâmetros

    object

    Para propriedades estáticas, informe null. Para propriedades não estáticas, informe o objeto.

    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, use ReflectionProperty::setValue(null, $value) para 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, passar null como primeiro argumento é necessário
    // para acessar propriedades estáticas.
    $reflectionProperty = $reflectionClass->getProperty('staticProperty');
    $reflectionProperty->setValue(null, '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); // requerido apenas antes do 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

    Melhore Esta Página

    Aprenda Como Melhorar Esta Página • Envie uma Solicitação de Modificação • Reporte um Problema
    ＋adicione uma nota

    Notas Enviadas por Usuários (em inglês) 3 notes

    up
    2
    me at ircmaxell dot om
    13 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"
    ?>
    up
    1
    p stewart imperial ac uk
    2 years 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.
    up
    0
    temirkhan.nasukhov
    2 years 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
    ＋adicione uma nota
    To Top