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.

Note: 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

Example #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