Patron Observateur

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

Le Patron Observateur (Observer Pattern) est un patron de conception comportemental qui établit une relation de un à plusieurs entre des objets. Lorsqu'un objet (le sujet) change d'état, tous ses dépendants (les observateurs) sont automatiquement notifiés et mis à jour.

Pensez à un abonnement à une newsletter. La newsletter est le sujet, et les abonnés sont les observateurs. Lorsqu'une nouvelle édition est publiée, tous les abonnés la reçoivent automatiquement sans que la newsletter n'ait besoin de connaître les détails de chaque abonné.

Voici une implémentation de base en PHP :

<?php
interface Observer {
    public function update(string $message): void;
}

class Newsletter {
    private array $subscribers = [];
    
    public function subscribe(Observer $observer): void {
        $this->subscribers[] = $observer;
    }
    
    public function publish(string $content): void {
        foreach ($this->subscribers as $subscriber) {
            $subscriber->update($content);
        }
    }
}

class EmailSubscriber implements Observer {
    public function __construct(private string $email) {}
    
    public function update(string $message): void {
        echo "Sending to {$this->email}: $message\n";
    }
}

$newsletter = new Newsletter();
$newsletter->subscribe(new EmailSubscriber("alice@example.com"));
$newsletter->subscribe(new EmailSubscriber("bob@example.com"));
$newsletter->publish("New article released!");

Sortie :

Sending to alice@example.com: New article released!
Sending to bob@example.com: New article released!

Le patron découple le sujet de ses observateurs. La classe Newsletter n'a pas besoin de savoir si elle notifie des abonnés par e-mail, des abonnés par SMS ou des services de notification push. Elle appelle simplement update() sur tout ce qui implémente l'interface Observer. Cela rend l'ajout de nouveaux types d'observateurs sans effort, sans modifier le code existant.

Défi

Facile

Construisons un système d'alerte de prix d'actions en utilisant le modèle Observer (Observateur). Lorsqu'un prix d'action change, tous les investisseurs enregistrés doivent être informés automatiquement — une application concrète parfaite de ce modèle.

Vous organiserez votre code sur quatre fichiers :

Observer.php — Définissez une interface Observer avec une seule méthode update(string $stockName, float $price): void. C'est le contrat que tous les observateurs doivent suivre pour recevoir des notifications.
Investors.php — Incluez le fichier Observer et créez deux classes qui implémentent l'interface :
- EmailInvestor — Prend une adresse e-mail dans son constructeur (utilisez la promotion de constructeur). Sa méthode update() affiche "Email to {$this->email}: {$stockName} is now \${$price}\n"
- SmsInvestor — Prend un numéro de téléphone dans son constructeur. Sa méthode update() affiche "SMS to {$this->phone}: {$stockName} is now \${$price}\n"
Stock.php — Incluez le fichier Observer et créez une classe Stock qui agit comme le sujet. Votre action doit :
- Stocker le nom de l'action et le prix actuel (utilisez la promotion de constructeur pour le nom, initialisez le prix à 0.0)
- Maintenir un tableau privé d'observateurs
- Avoir une méthode subscribe(Observer $observer): void pour ajouter des observateurs
- Avoir une méthode setPrice(float $price): void qui met à jour le prix et notifie tous les observateurs
Lors de la notification des observateurs, appelez la méthode update() de chaque observateur avec le nom de l'action et le nouveau prix.
main.php — Incluez les fichiers Investors et Stock. Vous recevrez trois entrées : un nom d'action, une adresse e-mail et un numéro de téléphone.
Créez un Stock avec le nom donné. Abonnez un EmailInvestor avec l'adresse e-mail et un SmsInvestor avec le numéro de téléphone.

Fixez le prix de l'action à 150.50 pour déclencher les notifications à tous les abonnés.

Le modèle Observer permet de garder votre classe Stock découplée des méthodes de notification spécifiques. Vous pourriez facilement ajouter un PushInvestor ou un SlackInvestor plus tard sans modifier la classe Stock du tout.

Aide-mémoire

Le Patron de conception Observateur (Observer Pattern) établit une relation de un à plusieurs où un sujet notifie automatiquement tous les observateurs lorsque son état change.

Composants clés :

Interface Observateur — Définit le contrat pour les observateurs avec une méthode update()
Sujet — Maintient une liste d'observateurs et les informe des changements d'état
Observateurs concrets — Implémentent l'interface Observateur pour recevoir les notifications

Implémentation de base :

<?php
interface Observer {
    public function update(string $message): void;
}

class Subject {
    private array $observers = [];
    
    public function subscribe(Observer $observer): void {
        $this->observers[] = $observer;
    }
    
    public function notify(string $data): void {
        foreach ($this->observers as $observer) {
            $observer->update($data);
        }
    }
}

class ConcreteObserver implements Observer {
    public function __construct(private string $name) {}
    
    public function update(string $message): void {
        echo "Notifying {$this->name}: $message\n";
    }
}

$subject = new Subject();
$subject->subscribe(new ConcreteObserver("Observer1"));
$subject->subscribe(new ConcreteObserver("Observer2"));
$subject->notify("State changed!");

Avantages :

Découple le sujet de ses observateurs
Facile d'ajouter de nouveaux types d'observateurs sans modifier le code existant
Prend en charge l'abonnement/désabonnement dynamique

Essayez vous-même

<?php
require_once 'Investors.php';
require_once 'Stock.php';

// Lire les entrées
$stockName = trim(fgets(STDIN));
$email = trim(fgets(STDIN));
$phone = trim(fgets(STDIN));

// TODO: Créer une action (Stock) avec le nom donné

// TODO: Abonner un EmailInvestor avec l'adresse e-mail

// TODO: Abonner un SmsInvestor avec le numéro de téléphone

// TODO: Définir le prix de l'action à 150.50 pour déclencher les notifications
?>