Promoção de Construtor (8.0)

Parte da seção Programação Orientada a Objetos do Journey de PHP da Coddy. Lição 42 de 91.

O PHP 8.0 introduziu a promoção de construtor, um recurso que reduz drasticamente o código repetitivo ao definir classes. Em vez de declarar as propriedades separadamente e depois atribuir valores a elas no construtor, você pode fazer as duas coisas em uma única etapa.

Aqui está a abordagem tradicional que você tem usado:

<?php
class Product {
    private string $name;
    private float $price;
    
    public function __construct(string $name, float $price) {
        $this->name = $name;
        $this->price = $price;
    }
    
    public function getInfo(): string {
        return $this->name . ": $" . $this->price;
    }
}

Com a promoção de construtor, você adiciona o modificador de acesso diretamente aos parâmetros do construtor:

<?php
class Product {
    public function __construct(
        private string $name,
        private float $price
    ) {}
    
    public function getInfo(): string {
        return $this->name . ": $" . $this->price;
    }
}

$product = new Product("Laptop", 999.99);
echo $product->getInfo();

Saída:

Laptop: $999.99

Ao adicionar private, protected ou public antes de um parâmetro do construtor, o PHP cria automaticamente a propriedade e atribui o valor. Você pode misturar parâmetros promovidos e regulares no mesmo construtor e ainda pode adicionar lógica dentro do corpo do construtor, se necessário.

Ponto principal: A promoção de constructor elimina declarações e atribuições repetitivas de propriedades, tornando suas classes mais limpas e fáceis de ler, enquanto mantém controle total sobre o encapsulamento.

Desafio

Fácil

Vamos criar um sistema de gerenciamento de contatos que demonstra a elegância da promoção de construtor. Você criará uma classe PHP limpa e moderna que elimina código repetitivo, mantendo o encapsulamento adequado.

Você organizará seu código em dois arquivos:

Contact.php: crie uma classe Contact usando a promoção de construtor para definir todas as propriedades diretamente na assinatura do construtor. Seu contato deve ter:
- Uma propriedade privada $name (string)
- Uma propriedade privada $email (string)
- Uma propriedade privada $phone (string) com um valor padrão de "Not provided"
Use a sintaxe de promoção de construtor: não são necessárias declarações de propriedades separadas! Adicione um método público getFullDetails() que retorne "[name] | [email] | [phone]". Adicione também um método getSummary() que retorne "Contact: [name]".
main.php: inclua o arquivo Contact. Você receberá três entradas: um nome, um e-mail e um número de telefone. Crie duas instâncias de Contact:
- O primeiro contato deve usar os três valores (nome, e-mail e telefone)
- O segundo contato deve usar apenas o nome e o e-mail (dependendo do valor padrão do telefone)
Imprima quatro linhas:
- Os detalhes completos do primeiro contato
- O resumo do primeiro contato
- Os detalhes completos do segundo contato
- O resumo do segundo contato

Observe como a promoção de construtor permite definir propriedades, configurar sua visibilidade, declarar seus tipos e atribuir valores: tudo em uma única assinatura de construtor legível. O parâmetro opcional de telefone com um valor padrão demonstra que os parâmetros promovidos funcionam perfeitamente com valores padrão, assim como os parâmetros comuns.

Experimente você mesmo

<?php

require_once 'Contact.php';

// Ler entrada
$name = trim(fgets(STDIN));
$email = trim(fgets(STDIN));
$phone = trim(fgets(STDIN));

// TODO: Criar o primeiro contato com todos os três valores (name, email, phone)

// TODO: Criar o segundo contato apenas com name e email (usar phone padrão)

// TODO: Imprimir os detalhes completos do primeiro contato

// TODO: Imprimir o resumo do primeiro contato

// TODO: Imprimir os detalhes completos do segundo contato

// TODO: Imprimir o resumo do segundo contato

?>