Implementación de Interfaces

Parte de la sección Programación Orientada a Objetos del Journey de PHP de Coddy — lección 28 de 91.

Ahora que entiendes qué son las interfaces, veamos cómo implementarlas realmente. Una clase implementa una interfaz utilizando la palabra clave implements, y debe proporcionar implementaciones concretas para todos los métodos declarados en esa interfaz.

<?php
interface Printable {
    public function print();
}

class Document implements Printable {
    private $content;
    
    public function __construct($content) {
        $this->content = $content;
    }
    
    public function print() {
        return "Printing: " . $this->content;
    }
}

$doc = new Document("Hello World");
echo $doc->print();

Salida:

Printing: Hello World

La clase Document implementa Printable proporcionando su propia versión del método print(). Si olvidas implementar un método requerido, PHP lanzará un error fatal.

Diferentes clases pueden implementar la misma interfaz a su propia manera:

<?php
class Invoice implements Printable {
    private $amount;
    
    public function __construct($amount) {
        $this->amount = $amount;
    }
    
    public function print() {
        return "Invoice Total: $" . $this->amount;
    }
}

$invoice = new Invoice(150);
echo $invoice->print();

Salida:

Invoice Total: $150

Tanto Document como Invoice cumplen con el contrato Printable, pero cada uno maneja la impresión de manera diferente según su propósito.

Punto clave: Usa implements para conectar una clase a una interfaz, luego define todos los métodos requeridos. Cada clase que implementa proporciona su propia lógica mientras garantiza que existan las mismas firmas de método.

Desafío

Fácil

Vamos a construir un sistema de mensajería que demuestre cómo diferentes clases pueden implementar la misma interfaz de sus propias maneras únicas.

Crearás tres archivos que trabajan juntos para manejar diferentes tipos de mensajes:

Messageable.php — Define la interfaz Messageable con dos firmas de método: compose($content) y deliver(). Esta interfaz establece el contrato que todos los tipos de mensajes deben seguir.
Email.php — Crea una clase Email que implemente Messageable. Incluye el archivo de la interfaz en la parte superior. La clase debe tener una propiedad privada $recipient y una propiedad privada $body. El constructor acepta la dirección del destinatario. Implementa compose($content) para almacenar el contenido en $body y devolver "Email composed". Implementa deliver() para devolver "Email to [recipient]: [body]".
SMS.php — Crea una clase SMS que también implemente Messageable. Incluye el archivo de la interfaz en la parte superior. La clase debe tener una propiedad privada $phoneNumber y una propiedad privada $text. El constructor acepta el número de teléfono. Implementa compose($content) para almacenar el contenido en $text y devolver "SMS composed". Implementa deliver() para devolver "SMS to [phoneNumber]: [text]".

En main.php, incluye tanto el archivo de Email como el de SMS. Recibirás tres entradas: una dirección de correo electrónico, un número de teléfono y el contenido de un mensaje. Crea un objeto Email con la dirección de correo electrónico y un objeto SMS con el número de teléfono. Llama a compose() con el contenido del mensaje en ambos objetos, imprimiendo cada resultado en su propia línea. Luego llama a deliver() en ambos objetos, imprimiendo cada resultado en su propia línea. El orden debe ser: email compose, SMS compose, email deliver, SMS deliver.

Ambas clases cumplen con el mismo contrato Messageable, pero cada una maneja la composición y entrega de mensajes de acuerdo con su propio propósito: los correos electrónicos muestran la dirección del destinatario mientras que los mensajes SMS muestran el número de teléfono.

Hoja de referencia

Una clase implementa una interfaz utilizando la palabra clave implements y debe proporcionar implementaciones concretas para todos los métodos declarados en esa interfaz:

<?php
interface Printable {
    public function print();
}

class Document implements Printable {
    private $content;
    
    public function __construct($content) {
        $this->content = $content;
    }
    
    public function print() {
        return "Printing: " . $this->content;
    }
}

Múltiples clases pueden implementar la misma interfaz, cada una proporcionando su propia implementación:

<?php
class Invoice implements Printable {
    private $amount;
    
    public function __construct($amount) {
        $this->amount = $amount;
    }
    
    public function print() {
        return "Invoice Total: $" . $this->amount;
    }
}

Si una clase no implementa todos los métodos requeridos de una interfaz, PHP lanzará un error fatal.

Pruébalo tú mismo

<?php
require_once 'Email.php';
require_once 'SMS.php';

// Leer entradas
$emailAddress = trim(fgets(STDIN));
$phoneNumber = trim(fgets(STDIN));
$messageContent = trim(fgets(STDIN));

// TODO: Crear un objeto Email con la dirección de correo electrónico

// TODO: Crear un objeto SMS con el número de teléfono

// TODO: Llamar a compose() en ambos objetos e imprimir los resultados
// Orden: compose de email, luego compose de SMS

// TODO: Llamar a deliver() en ambos objetos e imprimir los resultados
// Orden: deliver de email, luego deliver de SMS
?>