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 boilerplate ao definir classes. Em vez de declarar propriedades separadamente e depois atribuí-las 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 Chave: A promoção de construtor elimina declarações e atribuições de propriedades repetitivas, tornando suas classes mais limpas e fáceis de ler, enquanto mantém o controle total de encapsulamento.

Desafio

Fácil

Vamos construir um sistema de gerenciamento de contatos que demonstra a elegância da promoção de construtor (constructor promotion). Você criará uma classe PHP limpa e moderna que elimina o código repetitivo (boilerplate) enquanto mantém 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 retorna "[name] | [email] | [phone]". Adicione também um método getSummary() que retorna "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 todos os três valores (nome, e-mail e telefone)
- O segundo contato deve usar apenas o nome e o e-mail (contando com o valor padrão de telefone)
Imprima quatro linhas:
- Os detalhes completos (full details) do primeiro contato
- O resumo (summary) do primeiro contato
- Os detalhes completos (full details) do segundo contato
- O resumo (summary) 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 regulares.

Folha de consulta

O PHP 8.0 introduziu a promoção de propriedades no construtor (constructor promotion), que permite declarar e inicializar propriedades de classe diretamente nos parâmetros do construtor, adicionando um modificador de acesso.

Abordagem tradicional:

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

Com a promoção de propriedades no construtor:

<?php
class Product {
    public function __construct(
        private string $name,
        private float $price
    ) {}
}

$product = new Product("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 usar valores padrão com parâmetros promovidos:

<?php
class Contact {
    public function __construct(
        private string $name,
        private string $email,
        private string $phone = "Not provided"
    ) {}
}

A promoção de propriedades no construtor pode ser mesclada com parâmetros regulares, e você ainda pode adicionar lógica dentro do corpo do construtor, se necessário.

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 (nome, e-mail, telefone)

// TODO: Criar o segundo contato apenas com nome e e-mail (usar telefone padrão)

// TODO: Imprimir detalhes completos do primeiro contato

// TODO: Imprimir resumo do primeiro contato

// TODO: Imprimir detalhes completos do segundo contato

// TODO: Imprimir resumo do segundo contato

?>