Resolução de Conflitos de Traits

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

Quando duas traits definem métodos com o mesmo nome, o PHP lança um erro fatal. Você deve informar explicitamente ao PHP como lidar com esse conflito usando os operadores insteadof e as.

<?php
trait FileLogger {
    public function log(string $message): void {
        echo "File: $message";
    }
}

trait DatabaseLogger {
    public function log(string $message): void {
        echo "DB: $message";
    }
}

class Application {
    use FileLogger, DatabaseLogger {
        FileLogger::log insteadof DatabaseLogger;
        DatabaseLogger::log as logToDatabase;
    }
}

$app = new Application();
$app->log("Error occurred");
$app->logToDatabase("Error occurred");

Saída:

File: Error occurred
DB: Error occurred

O operador insteadof escolhe qual método da trait usar quando há um conflito. Neste exemplo, FileLogger::log vence e se torna o método log() padrão. O operador as cria um apelido (alias), permitindo que você acesse o método da outra trait sob um nome diferente.

Você também pode usar as para alterar a visibilidade de um método:

<?php
trait Greeting {
    public function sayHello(): void {
        echo "Hello!";
    }
}

class Person {
    use Greeting {
        sayHello as private;
    }
}

Isso torna sayHello() privado dentro da classe Person, embora seja público na trait. A resolução de conflitos oferece um controle refinado sobre como os métodos da trait se integram às suas classes.

Desafio

Fácil

Vamos construir um sistema de notificação onde diferentes canais podem enviar mensagens, mas precisamos resolver conflitos quando múltiplos traits fornecem o mesmo nome de método.

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

EmailNotifier.php — Crie um trait chamado EmailNotifier com um método notify(string $message) que retorna "Email: [message]".
SmsNotifier.php — Crie um trait chamado SmsNotifier com um método notify(string $message) que retorna "SMS: [message]".
AlertService.php — Crie uma classe AlertService que utiliza ambos os traits. Como ambos os traits possuem um método notify(), você precisará resolver este conflito:
- Use EmailNotifier::notify como o método notify() padrão
- Crie um alias notifyBySms para o método SmsNotifier::notify
Adicione também um método notifyAll(string $message) que chama ambos os métodos de notificação e os retorna combinados em linhas separadas.
main.php — Inclua todos os arquivos necessários e crie uma instância de AlertService. Você receberá uma entrada: uma string de mensagem. Imprima três linhas:
- O resultado da chamada de notify() com a mensagem
- O resultado da chamada de notifyBySms() com a mensagem
- O resultado da chamada de notifyAll() com a mensagem

Isso demonstra como o insteadof resolve qual método do trait vence quando há um conflito de nomes, enquanto o as permite manter o acesso ao método do outro trait sob um nome diferente.

Folha de consulta

Quando múltiplas traits definem métodos com o mesmo nome, o PHP exige uma resolução de conflito explícita usando os operadores insteadof e as.

O operador insteadof seleciona qual método da trait deve ser usado como padrão:

<?php
trait FileLogger {
    public function log(string $message): void {
        echo "File: $message";
    }
}

trait DatabaseLogger {
    public function log(string $message): void {
        echo "DB: $message";
    }
}

class Application {
    use FileLogger, DatabaseLogger {
        FileLogger::log insteadof DatabaseLogger;
        DatabaseLogger::log as logToDatabase;
    }
}

$app = new Application();
$app->log("Error occurred"); // File: Error occurred
$app->logToDatabase("Error occurred"); // DB: Error occurred

O operador as cria um apelido (alias) para um método de trait, permitindo o acesso sob um nome diferente.

Você também pode usar as para alterar a visibilidade do método:

<?php
trait Greeting {
    public function sayHello(): void {
        echo "Hello!";
    }
}

class Person {
    use Greeting {
        sayHello as private;
    }
}

Experimente você mesmo

<?php
require_once 'AlertService.php';

// Ler entrada
$message = trim(fgets(STDIN));

// TODO: Criar uma instância de AlertService

// TODO: Imprimir o resultado da chamada de notify() com a mensagem

// TODO: Imprimir o resultado da chamada de notifyBySms() com a mensagem

// TODO: Imprimir o resultado da chamada de notifyAll() com a mensagem
?>