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 do 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 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 inicializadas uma vez, seja no construtor ou no momento da 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 representa 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 retorna uma string no formato "[appName] v[version] (max: [maxConnections] connections)".
main.php — Inclua o arquivo da classe Config. Você receberá três entradas: o nome do app, a versão e o número 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 o tempo de 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.

Folha de consulta

O PHP 8.1 introduziu as propriedades readonly, que só podem ser atribuídas uma única vez e não podem ser modificadas posteriormente:

<?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; // U001

Propriedades readonly devem ter uma declaração de tipo e só podem ser inicializadas uma vez. Elas funcionam com qualquer modificador de visibilidade e podem ser combinadas com a promoção de construtor (constructor promotion):

<?php
class Product {
    public function __construct(
        public readonly string $sku,
        private readonly float $cost
    ) {}
}

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

Propriedades readonly são ideais para valores que devem permanecer constantes durante todo o tempo de vida de um objeto, como IDs, carimbos de data/hora (timestamps) ou configurações.

Experimente você mesmo

<?php

require_once 'Config.php';

// Ler 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

?>