Declaração de propriedades tipadas

A partir do PHP 7.4.0, definições de propriedades podem incluir uma Declarações de tipo, com exceção do tipo callable.

<?php

class User
{
    public int $id;
    public ?string $name;

    public function __construct(int $id, ?string $name)
    {
        $this->id = $id;
        $this->name = $name;
    }
}

$user = new User(1234, null);

var_dump($user->id);
var_dump($user->name);

?>

int(1234)
NULL

Propriedades tipadas precisam ser inicializadas antes de serem acessadas, senão um Error é lançado.

<?php

class Forma
{
    public int $numeroDeLados;
    public string $nome;

    public function setnumeroDeLados(int $numeroDeLados): void
    {
        $this->numeroDeLados = $numeroDeLados;
    }

    public function setNome(string $nome): void
    {
        $this->nome = $nome;
    }

    public function getnumeroDeLados(): int
    {
        return $this->numeroDeLados;
    }

    public function getNome(): string
    {
        return $this->nome;
    }
}

$triangle = new Forma();
$triangle->setNome("triângulo");
$triangle->setnumeroDeLados(3);
var_dump($triangle->getNome());
var_dump($triangle->getnumeroDeLados());

$circle = new Forma();
$circle->setNome("cículo");
var_dump($circle->getNome());
var_dump($circle->getnumeroDeLados());
?>

string(9) "triângulo"
int(3)
string(7) "círculo"

Fatal error: Uncaught Error: Typed property Forma::$numeroDeLados must not be accessed before initialization

Propriedades somente leitura

A partir do PHP 8.1.0, uma propriedade pode ser declarada com o modificador readonly, o que evita modificação da propriedade após a inicialização. Antes do PHP 8.4.0, uma propriedade readonly era implicitamente private-set e só poderia ser escrita na mesma classe. A partir do PHP 8.4.0, as propriedades readonly são implicitamente protected(set), por isso podem ser definidas a partir de classes filhas. Isso pode ser substituído explicitamente, se desejado.

<?php

class Test {
   public readonly string $prop;

   public function __construct(string $prop) {
       // Inicialização permitida.
       $this->prop = $prop;
   }
}

$test = new Test("foobar");
// Legal read.
var_dump($test->prop); // string(6) "foobar"

// Modificação ilegal. Não importa que o valor seja o mesmo.
$test->prop = "foobar";
// Error: Cannot modify readonly property Test::$prop
?>

Note:

O modificador readonly somente pode ser aplicado a propriedades tipadas. Uma propriedade somente leitura sem restrições de tipo pode ser declarada utilizando o tipo Mixed.

Note:

Propriedades estáticas não são suportadas.

Uma propriedade somente leitura somente pode ser inicializada uma única vez, e somente do escopo onde ela foi declarada. Quaisquer outras modificações da propriedade resultam em um Error.

<?php
class Test1 {
    public readonly string $prop;
}

$test1 = new Test1;
// Inicialização ilegal fora do escopo privado.
$test1->prop = "foobar";
// Error: Cannot initialize readonly property Test1::$prop from global scope
?>

Note:

Especificar um valor default para uma propriedade somente leitura não é permitido, porque uma propriedade com um valor default é essencialmente uma constante, e portanto não tem outro propósito.

<?php

class Test {
    // Fatal error: Readonly property Test::$prop cannot have default value
    public readonly int $prop = 42;
}
?>

Note:

Propriedades somente leitura não podem ser unset() depois de inicializadas. Entretanto é possível realizar essa operação antes da inicialização, dentro do escopo onde a variável foi declarada.

Nenhum tipo de modificação é permitido, e o seguintes casos resultarão em um Error:

<?php

class Test {
    public function __construct(
        public readonly int $i = 0,
        public readonly array $ary = [],
    ) {}
}

$test = new Test;
$test->i += 1;
$test->i++;
++$test->i;
$test->ary[] = 1;
$test->ary[0][] = 1;
$ref =& $test->i;
$test->i =& $ref;
byRef($test->i);
foreach ($test as &$prop);
?>

Entretanto, propriedades somente leitura não proíbem mutação. Objetos ou recursos armazenados em propriedades somente leitura ainda podem ser modificados internamente:

<?php

class Test {
    public function __construct(public readonly object $obj) {}
}

$test = new Test(new stdClass);
// Modificação interna permitida
$test->obj->foo = 1;
// Reinicialização proibida.
$test->obj = new stdClass;
?>

Propriedades dinâmicas

Ao tentar atribuir uma propriedade inexistente em um object, o PHP irá automaticamente criar a propriedade. Essa propriedade criada dinamicamente será disponível apenas naquela instância específica.