PHP 8.5.0 Alpha 1 available for testing

    ReflectionProperty::setValue

    (PHP 5, PHP 7, PHP 8)

    ReflectionProperty::setValue — Define el valor de la propiedad

    Descripción

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

    Define (modifica) el valor de la propiedad.

    Nota: Para definir los valores de las propiedades estáticas, utilice ReflectionProperty::setValue(null, $value).

    Parámetros

    object

    Para las propiedades estáticas, pase null. Para las propiedades no estáticas, pase el objeto.

    value

    El nuevo valor.

    Valores devueltos

    No devuelve ningún valor.

    Historial de cambios

    Versión Descripción
    8.3.0 La llamada a este método con un solo argumento está obsoleto, utilice en su lugar ReflectionProperty::setValue(null, $value) para las propiedades estáticas.
    8.1.0 Las propiedades privadas y protegidas son inmediatamente accesibles por ReflectionProperty::setValue(). Anteriormente, debían ser hechas accesibles llamando a ReflectionProperty::setAccessible(), de lo contrario se lanzaba una ReflectionException.

    Ejemplos

    Ejemplo #1 Ejemplo con ReflectionProperty::setValue()

    <?php
    class Foo {
    public static     $staticProperty;

    public     $property;
    protected     $privateProperty;
    }

    $reflectionClass = new ReflectionClass('Foo');

    // A partir de PHP 8.3, pasar null como primer argumento es requerido
    // para acceder a las propiedades 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); // Solo necesario antes de PHP 8.1.0.
    $reflectionProperty->setValue($foo, 'foobar');
    var_dump($reflectionProperty->getValue($foo));
    ?>

    El resultado del ejemplo sería:

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

    Ver también

    Found A Problem?

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

    User Contributed Notes 3 notes

    up
    1
    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
    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
    -1
    me at ircmaxell dot om
    14 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"
    ?>
    ＋add a note
    To Top