Introdução a Traits

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

O PHP suporta apenas herança única - uma classe pode estender apenas uma classe pai. Mas e se você precisar compartilhar funcionalidades entre várias classes não relacionadas? É aqui que as traits entram.

Um trait é um mecanismo de reutilização de código que permite definir métodos e propriedades que podem ser inseridos em várias classes. Pense nos traits como um copiar e colar ao nível da linguagem - o código de um trait torna-se parte da classe que o utiliza.

<?php
trait Timestampable {
    private string $createdAt;
    
    public function setCreatedAt(): void {
        $this->createdAt = date('Y-m-d H:i:s');
    }
    
    public function getCreatedAt(): string {
        return $this->createdAt;
    }
}

class Article {
    use Timestampable;
    
    public function __construct(public string $title) {
        $this->setCreatedAt();
    }
}

$article = new Article("PHP Traits");
echo $article->getCreatedAt();

A palavra-chave use dentro de uma classe importa os membros da trait. Agora Article tem acesso a setCreatedAt() e getCreatedAt() como se tivessem sido definidos diretamente na classe.

A mesma trait pode ser usada em classes completamente não relacionadas - uma classe Comment, uma classe User ou qualquer outra classe que precise de funcionalidade de timestamp. Isso resolve a limitação da herança única, permitindo o compartilhamento horizontal de código em toda a sua hierarquia de classes.

Desafio

Fácil

Vamos construir um sistema de saudação simples que demonstra como as traits permitem compartilhar funcionalidades entre classes não relacionadas. Você criará uma trait que fornece uma capacidade de saudação e, em seguida, a usará em duas classes completamente diferentes.

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

Greetable.php — Crie uma trait chamada Greetable que fornece funcionalidade de saudação. A trait deve ter:
- Uma propriedade privada $greeting (string)
- Um método setGreeting(string $greeting) que armazena a mensagem de saudação
- Um método greet() que retorna a mensagem de saudação
Person.php — Crie uma classe Person que utiliza a trait Greetable. Inclua o arquivo da trait e use a promoção de construtor para definir uma propriedade pública $name. No construtor, chame setGreeting() para definir a saudação como "Hello, I'm [name]".
Robot.php — Crie uma classe Robot que também utiliza a trait Greetable. Inclua o arquivo da trait e use a promoção de construtor para definir uma propriedade pública $model. No construtor, chame setGreeting() para definir a saudação como "Beep boop, I am model [model]".

Em main.php, inclua ambos os arquivos de classe. Você receberá duas entradas: o nome de uma pessoa e o número do modelo de um robô. Crie instâncias de ambas as classes e imprima suas saudações em linhas separadas.

Isso demonstra o poder das traits — Person e Robot são classes completamente não relacionadas, sem um pai compartilhado, mas ambas ganham a mesma funcionalidade de saudação por meio da trait. Cada classe personaliza como usa essa funcionalidade à sua maneira.

Folha de consulta

Uma trait é um mecanismo para reutilização de código que permite compartilhar métodos e propriedades entre várias classes não relacionadas, resolvendo a limitação de herança única do PHP.

Defina uma trait usando a palavra-chave trait:

<?php
trait Timestampable {
    private string $createdAt;
    
    public function setCreatedAt(): void {
        $this->createdAt = date('Y-m-d H:i:s');
    }
    
    public function getCreatedAt(): string {
        return $this->createdAt;
    }
}

Use uma trait em uma classe com a palavra-chave use:

class Article {
    use Timestampable;
    
    public function __construct(public string $title) {
        $this->setCreatedAt();
    }
}

Os métodos e propriedades da trait tornam-se parte da classe como se tivessem sido definidos diretamente nela. Múltiplas classes não relacionadas podem usar a mesma trait para compartilhar funcionalidades horizontalmente em sua hierarquia de classes.

Experimente você mesmo

<?php

require_once 'Person.php';
require_once 'Robot.php';

// Ler a entrada
$name = trim(fgets(STDIN));
$model = trim(fgets(STDIN));

// TODO: Criar uma instância de Person com o nome fornecido
// TODO: Criar uma instância de Robot com o modelo fornecido
// TODO: Imprimir a saudação da Person
// TODO: Imprimir a saudação do Robot (em uma nova linha)

?>