Usando Múltiplos Traits

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

Uma única trait é útil, mas o real poder surge quando você combina múltiplas traits em uma única classe. O PHP permite que você inclua quantas traits forem necessárias, fornecendo à sua classe capacidades de várias fontes ao mesmo tempo.

Para usar múltiplos traits, basta listá-los separados por vírgulas após a palavra-chave use:

<?php
trait Timestampable {
    public function getTimestamp(): string {
        return date('Y-m-d H:i:s');
    }
}

trait Identifiable {
    private string $id;
    
    public function generateId(): void {
        $this->id = uniqid('id_');
    }
    
    public function getId(): string {
        return $this->id;
    }
}

class Post {
    use Timestampable, Identifiable;
    
    public function __construct(public string $title) {
        $this->generateId();
    }
}

$post = new Post("Hello World");
echo $post->getId() . " - " . $post->getTimestamp();

Saída:

id_6789abc123 - 2024-01-15 10:30:00

A classe Post agora possui métodos de ambos os traits. Cada trait contribui com sua própria funcionalidade - Timestampable fornece métodos relacionados ao tempo, enquanto Identifiable lida com IDs únicos. Essa abordagem mantém cada trait focado em uma única responsabilidade, tornando seu código mais modular e reutilizável.

O que acontece quando duas traits têm métodos com o mesmo nome? Essa é uma situação de conflito que exploraremos na próxima aula.

Desafio

Fácil

Vamos construir um sistema de gerenciamento de produtos que combina múltiplos traits para dar aos produtos capacidades de precificação e de inventário. Cada trait lidará com uma única responsabilidade, e sua classe de produto ganhará funcionalidades de ambos.

Você organizará seu código em três arquivos:

Priceable.php — Crie um trait chamado Priceable que lida com a funcionalidade de precificação. O trait deve ter:
- Uma propriedade privada $price (float)
- Um método setPrice(float $price) que armazena o preço
- Um método getPrice() que retorna o preço
- Um método getFormattedPrice() que retorna o preço formatado como "$[price]" com 2 casas decimais
Stockable.php — Crie um trait chamado Stockable que gerencia o inventário. O trait deve ter:
- Uma propriedade privada $stock (integer)
- Um método setStock(int $quantity) que armazena a quantidade em estoque
- Um método getStock() que retorna o estoque atual
- Um método isInStock() que retorna true se o estoque for maior que 0, e false caso contrário
main.php — Inclua ambos os arquivos de trait e crie uma classe Product que utiliza os traits Priceable e Stockable. Use a promoção de construtor para definir uma propriedade pública $name. O construtor também deve aceitar um preço e uma quantidade em estoque, usando os métodos dos traits para defini-los.
Você receberá três entradas: um nome de produto, um preço e uma quantidade em estoque. Crie um produto com esses valores e imprima quatro linhas:
- O nome do produto
- O preço formatado (usando getFormattedPrice())
- A quantidade em estoque
- "Available" se estiver em estoque, ou "Out of stock" caso contrário

Isso demonstra como múltiplos traits trabalham juntos — sua classe Product ganha capacidades de precificação de um trait e gerenciamento de inventário de outro, mantendo cada preocupação devidamente separada enquanto as combina em um produto com todos os recursos.

Experimente você mesmo

<?php
require_once 'Priceable.php';
require_once 'Stockable.php';

// TODO: Crie uma classe Product que use as traits Priceable e Stockable
// Use a promoção de construtor para a propriedade pública $name
// O construtor deve aceitar name, price e stock, e usar os métodos das traits para definir o preço e o estoque

class Product {
    // TODO: Use as traits aqui

    // TODO: Implemente o construtor com promoção de construtor para $name
    // e defina o preço e o estoque usando os métodos das traits
}

// Ler entrada
$name = trim(fgets(STDIN));
$price = floatval(trim(fgets(STDIN)));
$stock = intval(trim(fgets(STDIN)));

// TODO: Crie uma instância de Product com os valores de entrada

// TODO: Imprima o nome do produto
// TODO: Imprima o preço formatado usando getFormattedPrice()
// TODO: Imprima a quantidade em estoque
// TODO: Imprima "Available" se estiver em estoque, ou "Out of stock" se não estiver
?>