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 aux objets en les enveloppant dans des objets enveloppes spéciaux appelés décorateurs. Contrairement à l’héritage, qui ajoute un comportement au moment de la compilation, les décorateurs ajoutent un comportement au moment de l’exécution.

Imagine un café. Vous commencez avec un café de base, puis vous ajoutez des extras comme du lait, du sucre ou de la crème fouettée.

Chaque ajout enveloppe le café original et enrichit sa description et son coût. L’idée essentielle 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 modèle vous permet de combiner les comportements dans n’importe quel ordre et en n’importe quelle 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 pizzas à l'aide du patron Decorator. Tu commenceras avec une pizza de base et ajouteras dynamiquement des garnitures : chaque garniture enveloppe la pizza et ajoute des informations à sa description et à son prix, comme dans l'exemple du café de la leçon.

Tu organiseras ton code sur quatre fichiers :

Pizza.php : définis une interface Pizza qui établit le contrat pour toutes les pizzas et garnitures. Elle doit comporter deux méthodes : getDescription(): string et getPrice(): float.
BasePizza.php : inclus l'interface Pizza et crée une classe MargheritaPizza qui l'implémente. Il s'agit de ta pizza de base, avec une description "Margherita" et un prix de 8.00.
Toppings.php : inclus l'interface Pizza et crée trois classes décoratrices qui l'implémentent. Chaque décorateur enveloppe un objet Pizza (reçu dans le constructeur) et enrichit à 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 : inclus les fichiers BasePizza et Toppings. Tu recevras une entrée : une liste de garnitures séparées par des virgules à ajouter (par exemple, "cheese,pepperoni" ou "mushroom,cheese,cheese").
Commence avec une MargheritaPizza. Pour chaque garniture de l'entrée, enveloppe ta 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, affiche la description et le prix finaux de la pizza dans ce format :

[description] = $[price]

Formate le prix avec deux décimales.

Remarque qu'une même garniture peut être appliquée plusieurs fois : commander une double portion de fromage signifie simplement envelopper la pizza deux fois avec CheeseTopping. C'est toute la puissance du patron Decorator !

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 base MargheritaPizza
$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()

?>