Propriedades Somente para Leitura (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 receber um valor uma vez e não podem ser modificadas depois. Ao contrário das constantes, as propriedades readonly são definidas durante a inicialização do objeto, e não no momento da definição da classe.
Você declara uma propriedade somente leitura 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
AliceDepois de atribuída, qualquer tentativa de alterar uma propriedade somente para leitura causará um erro. Isso as torna perfeitas para valores que devem permanecer constantes durante toda a vida útil de um objeto, como IDs ou registros de data e hora de criação.
Propriedades somente leitura precisam ter uma declaração de tipo e só podem receber um valor uma vez, de dentro da classe que as declara (normalmente no construtor). Ao contrário das propriedades comuns, 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:
ABC123Ponto principal: As propriedades somente para leitura garantem imutabilidade no nível da propriedade. Elas são ideais para dados que identificam um objeto ou 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 evitar modificações acidentais.
Desafio
FácilVamos criar um sistema de configuração imutável que usa propriedades readonly para garantir que 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 classeConfigque representa a configuração da aplicação com configurações imutáveis. A classe deve ter três propriedades públicas readonly:string $appName,string $versioneint $maxConnections. Use a promoção de construtor para declarar e inicializar as três propriedades readonly em uma única definição de construtor clara. Adicione um métodogetInfo()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 da aplicação, a versão e o número máximo de conexões (como uma string que precisa ser convertida em um inteiro). Crie um objetoConfigusando esses valores. Imprima o resultado degetInfo()na primeira linha. Em seguida, imprima cada propriedade readonly em sua própria linha, acessando-as diretamente: o nome da aplicação, a versão e o número máximo de conexões.
As propriedades readonly garantem que, depois que uma configuração é criada, seus valores permanecem fixos — ideal 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 pelo valor de cada propriedade individual, demonstrando que as propriedades readonly ainda podem ser lidas de fora da classe.
Experimente você mesmo
<?php
require_once 'Config.php';
// Leia as entradas
$appName = trim(fgets(STDIN));
$version = trim(fgets(STDIN));
$maxConnections = intval(trim(fgets(STDIN)));
// TODO: Crie um objeto Config usando os valores de entrada
// TODO: Imprima o resultado de getInfo()
// TODO: Imprima cada propriedade readonly em uma linha separada:
// - nome do aplicativo
// - versão
// - número máximo de conexões
?>Esta lição inclui um quiz rápido. Comece a lição para respondê-lo e acompanhar seu progresso.
Todas as lições de Programação Orientada a Objetos
1Fundamentos de OOP
Arquivos externosIntrodução à OOPClasses vs. objetosA palavra-chave $thisMétodosPropriedadesConstrutor (__construct)Destrutor (__destruct)Recapitulação - Calculadora simples4Herança
Herança BásicaA Palavra-chave parent::Sobrescrita de MétodosA Palavra-chave finalClasses AbstratasRecapitulação - Hierarquia de Funcionários7Encapsulamento
Público, Protegido, PrivadoModificadores de Acesso em ProfundidadeGetters e SettersOcultação de InformaçõesPromoção de Construtor (8.0)Recapitulação - Sistema de Registros de Alunos10Conceitos Avançados de OOP
Composição vs. HerançaInjeção de DependênciaClasses AnônimasEnums (PHP 8.1)Fibras (PHP 8.1)Análise Profunda da Clonagem de ObjetosGeradores e Iteradores13Padrões de Projeto Parte 2
Padrão CommandPadrão AdapterPadrão DecoratorPadrão Template MethodPadrão StatePadrão CompositePadrão Repository2Namespaces e Autoloading
Introdução a NamespacesA palavra-chave usePadrão de Autoloading PSR-4Autoloader do ComposerRecapitulação - Projeto organizado5Interfaces e Contratos
Introdução às InterfacesImplementando InterfacesImplementação de Múltiplas InterfacesInterface vs Classe AbstrataTipagem com InterfacesRecapitulação - Calculadora de Formas8Métodos Mágicos
Introdução aos Métodos Mágicos__toString e __debugInfo__get, __set, __isset, __unset__call e __callStatic__clone e Clonagem de Objetos__serialize e __unserializeRecapitulação - Coleção Personalizada11Sistema de Tipos e Tratamento de Erros
Declarações de TiposTipos NulosTipos de União e InterseçãoClasses de ExceçãoHierarquia de Exceções PersonalizadaTry, Catch, FinallyRecapitulação - Validador de Formulário14Projeto: Gerenciamento de Biblioteca
Visão Geral do ProjetoClasses de Livros e Usuários3Propriedades de Classes
Propriedades de Instância vs. EstáticasConstantes em ClassesMétodos e Propriedades EstáticosPropriedades Privadas e ProtegidasPropriedades Somente para Leitura (PHP 8.1)Recapitulação - Gerenciador de Contas Bancárias6Polimorfismo
Revisão da Sobrescrita de MétodosPolimorfismo via InterfacesIndicação de Tipos e Tipos UnionVinculação Estática TardiaRecapitulação - Processador de Pagamentos9Traits
Introdução a TraitsUsando Múltiplos TraitsResolução de Conflitos entre TraitsMétodos Abstratos em TraitsTraits vs. Herança12Padrões de Projeto – Parte 1
Introdução aos Padrões de ProjetoPadrão SingletonPadrão FactoryPadrão ObserverPadrão StrategyPratique por conta própria: Compilador de PHP online