Implémentation d'Interfaces

Fait partie de la section Programmation Orientée Objet du Journey PHP de Coddy — leçon 28 sur 91.

Maintenant que vous comprenez ce que sont les interfaces, voyons comment les implémenter concrètement. Une classe implémente une interface en utilisant le mot-clé implements, et doit fournir des implémentations concrètes pour toutes les méthodes déclarées dans cette interface.

<?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();

Sortie :

Printing: Hello World

La classe Document implémente Printable en fournissant sa propre version de la méthode print(). Si vous oubliez d'implémenter une méthode requise, PHP générera une erreur fatale.

Différentes classes peuvent implémenter la même interface à leur manière :

<?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();

Sortie :

Invoice Total: $150

À la fois Document et Invoice remplissent le contrat Printable, mais chacun gère l'impression différemment selon son objectif.

Point clé : Utilisez implements pour connecter une classe à une interface, puis définissez toutes les méthodes requises. Chaque classe d'implémentation fournit sa propre logique tout en garantissant que les mêmes signatures de méthode existent.

Défi

Facile

Construisons un système de messagerie qui démontre comment différentes classes peuvent implémenter la même interface de leurs propres manières uniques.

Vous allez créer trois fichiers qui travaillent ensemble pour gérer différents types de messages :

Messageable.php — Définissez l'interface Messageable avec deux signatures de méthode : compose($content) et deliver(). Cette interface établit le contrat que tous les types de messages doivent suivre.
Email.php — Créez une classe Email qui implémente Messageable. Incluez le fichier de l'interface en haut. La classe doit avoir une propriété privée $recipient et une propriété privée $body. Le constructeur accepte l'adresse du destinataire. Implémentez compose($content) pour stocker le contenu dans $body et retourner "Email composed". Implémentez deliver() pour retourner "Email to [recipient]: [body]".
SMS.php — Créez une classe SMS qui implémente également Messageable. Incluez le fichier de l'interface en haut. La classe doit avoir une propriété privée $phoneNumber et une propriété privée $text. Le constructeur accepte le numéro de téléphone. Implémentez compose($content) pour stocker le contenu dans $text et retourner "SMS composed". Implémentez deliver() pour retourner "SMS to [phoneNumber]: [text]".

Dans main.php, incluez les fichiers Email et SMS. Vous recevrez trois entrées : une adresse e-mail, un numéro de téléphone et un contenu de message. Créez un objet Email avec l'adresse e-mail et un objet SMS avec le numéro de téléphone. Appelez compose() avec le contenu du message sur les deux objets, en affichant chaque résultat sur sa propre ligne. Ensuite, appelez deliver() sur les deux objets, en affichant chaque résultat sur sa propre ligne. L'ordre doit être : email compose, SMS compose, email deliver, SMS deliver.

Les deux classes remplissent le même contrat Messageable, mais chacune gère la composition et la distribution des messages selon son propre objectif — les e-mails affichent l'adresse du destinataire tandis que les messages SMS affichent le numéro de téléphone.

Aide-mémoire

Une classe implémente une interface en utilisant le mot-clé implements et doit fournir des implémentations concrètes pour toutes les méthodes déclarées dans cette interface :

<?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;
    }
}

Plusieurs classes peuvent implémenter la même interface, chacune fournissant sa propre implémentation :

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

Si une classe ne parvient pas à implémenter toutes les méthodes requises d'une interface, PHP générera une erreur fatale.

Essayez vous-même

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

// Lire les entrées
$emailAddress = trim(fgets(STDIN));
$phoneNumber = trim(fgets(STDIN));
$messageContent = trim(fgets(STDIN));

// TODO: Créer un objet Email avec l'adresse e-mail

// TODO: Créer un objet SMS avec le numéro de téléphone

// TODO: Appeler compose() sur les deux objets et afficher les résultats
// Ordre : compose de l'e-mail, puis compose du SMS

// TODO: Appeler deliver() sur les deux objets et afficher les résultats
// Ordre : deliver de l'e-mail, puis deliver du SMS
?>