Propriedades Readonly (PHP 8.1)

Parte da seção Programação Orientada a Objetos do Journey de PHP da Coddy — lição 19 de 91.

O PHP 8.1 introduziu propriedades readonly, que só podem ser atribuídas uma vez e não podem ser modificadas posteriormente. Ao contrário das constantes, as propriedades readonly são definidas durante a inicialização do objeto, em vez de no momento da definição da classe.

Você declara uma propriedade readonly adicionando a palavra-chave readonly antes da declaração de tipo:

<?php
class User {
    public readonly string $id;
    public readonly string $name;
    
    public function __construct(string $id, string $name) {
        $this->id = $id;
        $this->name = $name;
    }
}

$user = new User("U001", "Alice");
echo $user->id . "\n";
echo $user->name;

Saída:

U001
Alice

Uma vez atribuída, tentar alterar uma propriedade readonly causará um erro. Isso as torna perfeitas para valores que devem permanecer constantes durante todo o tempo de vida de um objeto, como IDs ou timestamps de criação.

Propriedades readonly devem ter uma declaração de tipo e só podem ser atribuídas uma vez, de dentro da classe declarante (tipicamente no construtor). Ao contrário de propriedades normais, elas não podem receber um valor padrão na declaração. Elas funcionam com qualquer modificador de visibilidade:

<?php
class Product {
    public function __construct(
        public readonly string $sku,
        private readonly float $cost
    ) {}
    
    public function getCost(): float {
        return $this->cost;
    }
}

$product = new Product("ABC123", 29.99);
echo $product->sku;

Saída:

ABC123

Ponto Chave: Propriedades readonly fornecem imutabilidade no nível da propriedade. Elas são ideais para dados que identificam um objeto ou que não devem mudar após a criação, combinando a flexibilidade da inicialização em tempo de execução com a segurança de prevenir modificações acidentais.

Desafio

Fácil

Vamos construir um sistema de configuração imutável que utiliza propriedades readonly para garantir que as configurações críticas não possam ser alteradas acidentalmente após a inicialização.

Você criará dois arquivos que trabalham juntos para gerenciar a configuração da aplicação:

Config.php — Defina uma classe Config que represente a configuração da aplicação com definições imutáveis. A classe deve ter três propriedades readonly públicas: string $appName, string $version e int $maxConnections. Use a promoção de construtor (constructor promotion) para declarar e inicializar todas as três propriedades readonly em uma única e limpa definição de construtor. Adicione um método getInfo() que retorne uma string no formato "{$this->appName} v{$this->version} (max: {$this->maxConnections} connections)".
main.php — Inclua o arquivo da classe Config. Você receberá três entradas: o nome do app, a versão e o máximo de conexões (como uma string que precisa ser convertida para um inteiro). Crie um objeto Config usando esses valores. Imprima o resultado de getInfo() na primeira linha. Em seguida, imprima cada propriedade readonly em sua própria linha acessando-as diretamente: o nome do app, a versão e o máximo de conexões.

As propriedades readonly garantem que, uma vez criada uma configuração, seus valores fiquem travados — perfeito para configurações que devem permanecer constantes durante a execução da sua aplicação. Observe como a promoção de construtor combinada com readonly cria uma maneira muito concisa de definir objetos de valor imutáveis.

Sua saída deve exibir a string de informações formatada seguida por cada valor de propriedade individual, demonstrando que as propriedades readonly ainda podem ser lidas de fora da classe.

Experimente você mesmo

<?php

require_once 'Config.php';

// Ler as entradas
$appName = trim(fgets(STDIN));
$version = trim(fgets(STDIN));
$maxConnections = intval(trim(fgets(STDIN)));

// TODO: Criar um objeto Config usando os valores de entrada

// TODO: Imprimir o resultado de getInfo()

// TODO: Imprimir cada propriedade readonly em sua própria linha:
// - app name
// - version
// - max connections

?>