Patron Décorateur

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

Le Decorator Pattern est un patron de conception structurel qui vous permet d'ajouter dynamiquement de nouveaux comportements à des objets en les enveloppant dans des objets wrappers spéciaux appelés décorateurs. Contrairement à l'héritage, qui ajoute du comportement au moment de la compilation, les décorateurs ajoutent du comportement au moment de l'exécution.

Imaginez un café. Vous commencez par un café de base, puis vous ajoutez des suppléments comme du lait, du sucre ou de la crème fouettée.

Chaque ajout enveloppe le café d'origine et s'ajoute à sa description et à son coût. L'idée clé est que le café de base et les décorateurs partagent la même interface.

<?php
interface Coffee {
    public function getDescription(): string;
    public function getCost(): float;
}

class SimpleCoffee implements Coffee {
    public function getDescription(): string {
        return "Simple Coffee";
    }
    
    public function getCost(): float {
        return 2.00;
    }
}

Les décorateurs implémentent la même interface et enveloppent un autre objet Coffee :

<?php
class MilkDecorator implements Coffee {
    public function __construct(private Coffee $coffee) {}
    
    public function getDescription(): string {
        return $this->coffee->getDescription() . ", Milk";
    }
    
    public function getCost(): float {
        return $this->coffee->getCost() + 0.50;
    }
}

class SugarDecorator implements Coffee {
    public function __construct(private Coffee $coffee) {}
    
    public function getDescription(): string {
        return $this->coffee->getDescription() . ", Sugar";
    }
    
    public function getCost(): float {
        return $this->coffee->getCost() + 0.25;
    }
}

$coffee = new SimpleCoffee();
$coffee = new MilkDecorator($coffee);
$coffee = new SugarDecorator($coffee);

echo $coffee->getDescription() . " = $" . $coffee->getCost();

Sortie :

Simple Coffee, Milk, Sugar = $2.75

Chaque décorateur enveloppe l'objet précédent, formant une chaîne. Le patron permet de combiner des comportements dans n'importe quel ordre et quantité sans créer une classe pour chaque combinaison possible. Besoin d'une double dose de lait ? Enveloppez-le simplement deux fois.

Défi

Facile

Construisons un système de commande de pizza en utilisant le Patron de Conception Décorateur (Decorator Pattern). Vous commencerez par une pizza de base et ajouterez dynamiquement des garnitures — chaque garniture enveloppe la pizza et s'ajoute à sa description et à son prix, tout comme l'exemple du café de la leçon.

Vous organiserez votre code sur quatre fichiers :

Pizza.php — Définissez une interface Pizza qui établit le contrat pour toutes les pizzas et garnitures. Elle doit avoir deux méthodes : getDescription(): string et getPrice(): float.
BasePizza.php — Incluez l'interface Pizza et créez une classe MargheritaPizza qui l'implémente. C'est votre pizza de base avec une description de "Margherita" et un prix de 8.00.
Toppings.php — Incluez l'interface Pizza et créez trois classes de décorateurs qui l'implémentent. Chaque décorateur enveloppe un objet Pizza (acceptez-le dans le constructeur) et améliore à la fois la description et le prix :
- CheeseTopping — Ajoute ", Extra Cheese" à la description et 1.50 au prix
- PepperoniTopping — Ajoute ", Pepperoni" à la description et 2.00 au prix
- MushroomTopping — Ajoute ", Mushrooms" à la description et 1.25 au prix
main.php — Incluez les fichiers BasePizza et Toppings. Vous recevrez une entrée : une liste de garnitures séparées par des virgules à ajouter (par exemple, "cheese,pepperoni" ou "mushroom,cheese,cheese").
Commencez par une MargheritaPizza. Pour chaque garniture dans l'entrée, enveloppez votre pizza avec le décorateur approprié :
- "cheese" enveloppe avec CheeseTopping
- "pepperoni" enveloppe avec PepperoniTopping
- "mushroom" enveloppe avec MushroomTopping
Après avoir appliqué toutes les garnitures, affichez la description et le prix de la pizza finale dans ce format :

[description] = $[price]

Formatez le prix avec deux décimales.

Remarquez comment la même garniture peut être appliquée plusieurs fois — commander un double fromage signifie simplement envelopper avec CheeseTopping deux fois. Cette flexibilité est la force du Patron de Conception Décorateur !

Aide-mémoire

Le Pattern Décorateur est un patron de conception structurel qui ajoute dynamiquement des comportements aux objets en les enveloppant dans des objets décorateurs au moment de l'exécution.

L'objet de base et les décorateurs implémentent tous deux la même interface :

<?php
interface Coffee {
    public function getDescription(): string;
    public function getCost(): float;
}

class SimpleCoffee implements Coffee {
    public function getDescription(): string {
        return "Simple Coffee";
    }
    
    public function getCost(): float {
        return 2.00;
    }
}

Les décorateurs enveloppent un autre objet du même type d'interface :

<?php
class MilkDecorator implements Coffee {
    public function __construct(private Coffee $coffee) {}
    
    public function getDescription(): string {
        return $this->coffee->getDescription() . ", Milk";
    }
    
    public function getCost(): float {
        return $this->coffee->getCost() + 0.50;
    }
}

class SugarDecorator implements Coffee {
    public function __construct(private Coffee $coffee) {}
    
    public function getDescription(): string {
        return $this->coffee->getDescription() . ", Sugar";
    }
    
    public function getCost(): float {
        return $this->coffee->getCost() + 0.25;
    }
}

Enchaînez les décorateurs pour combiner les comportements :

$coffee = new SimpleCoffee();
$coffee = new MilkDecorator($coffee);
$coffee = new SugarDecorator($coffee);

echo $coffee->getDescription() . " = $" . $coffee->getCost();
// Sortie : Simple Coffee, Milk, Sugar = $2.75

Les décorateurs peuvent être appliqués plusieurs fois et dans n'importe quel ordre sans avoir à créer de classes pour chaque combinaison.

Essayez vous-même

<?php
require_once 'BasePizza.php';
require_once 'Toppings.php';

// Lire l'entrée - liste de garnitures séparées par des virgules
$input = trim(fgets(STDIN));
$toppings = explode(',', $input);

// Commencer avec une MargheritaPizza de base
$pizza = new MargheritaPizza();

// TODO: Parcourir chaque garniture et envelopper la pizza avec le décorateur approprié
// - "cheese" -> envelopper avec CheeseTopping
// - "pepperoni" -> envelopper avec PepperoniTopping
// - "mushroom" -> envelopper avec MushroomTopping

// TODO: Afficher le résultat au format : [description] = $[price]
// Formater le prix à 2 décimales en utilisant number_format()

?>