Modello Decorator

Fa parte della sezione Programmazione orientata agli oggetti del percorso PHP di Coddy. Lezione 77 di 91.

Il Decorator Pattern è un pattern strutturale che ti permette di aggiungere dinamicamente nuovi comportamenti agli oggetti avvolgendoli in speciali oggetti wrapper chiamati decorator. A differenza dell'ereditarietà, che aggiunge comportamenti in fase di compilazione, i decorator aggiungono comportamenti in fase di esecuzione.

Immagina una caffetteria. Parti da un caffè base, poi aggiungi extra come latte, zucchero o panna montata.

Ogni aggiunta avvolge il caffè originale e ne arricchisce la descrizione e il costo. L’intuizione fondamentale è che sia il caffè di base sia i decoratori condividono la stessa interfaccia.

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

I decoratori implementano la stessa interfaccia e avvolgono un altro oggetto 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();

Output:

Simple Coffee, Milk, Sugar = $2.75

Ogni decoratore avvolge l'oggetto precedente, formando una catena. Il pattern ti permette di combinare i comportamenti in qualsiasi ordine e quantità senza creare una classe per ogni possibile combinazione. Vuoi il doppio del latte? Basta avvolgerlo due volte.

Sfida

Facile

Creiamo un sistema per ordinare pizze usando il pattern Decorator. Inizierai con una pizza base e aggiungerai i condimenti dinamicamente: ogni condimento avvolge la pizza e ne arricchisce la descrizione e il prezzo, proprio come nell'esempio del caffè della lezione.

Organizzerai il codice in quattro file:

Pizza.php: definisci un'interfaccia Pizza che stabilisce il contratto per tutte le pizze e i condimenti. Dovrebbe avere due metodi: getDescription(): string e getPrice(): float.
BasePizza.php: includi l'interfaccia Pizza e crea una classe MargheritaPizza che la implementa. Questa è la tua pizza base, con una descrizione "Margherita" e un prezzo di 8.00.
Toppings.php: includi l'interfaccia Pizza e crea tre classi decorator che la implementano. Ogni decorator avvolge un oggetto Pizza (accettalo nel costruttore) e ne arricchisce sia la descrizione sia il prezzo:
- CheeseTopping: aggiunge ", Extra Cheese" alla descrizione e 1.50 al prezzo
- PepperoniTopping: aggiunge ", Pepperoni" alla descrizione e 2.00 al prezzo
- MushroomTopping: aggiunge ", Mushrooms" alla descrizione e 1.25 al prezzo
main.php: includi i file BasePizza e Toppings. Riceverai un input: un elenco di condimenti separati da virgole da aggiungere (ad es. "cheese,pepperoni" o "mushroom,cheese,cheese").
Inizia con una MargheritaPizza. Per ogni condimento nell'input, avvolgi la pizza con il decorator appropriato:
- "cheese" avvolge con CheeseTopping
- "pepperoni" avvolge con PepperoniTopping
- "mushroom" avvolge con MushroomTopping
Dopo aver applicato tutti i condimenti, stampa la descrizione e il prezzo finali della pizza in questo formato:

[description] = $[price]

Formatta il prezzo con due cifre decimali.

Nota che lo stesso condimento può essere applicato più volte: ordinare doppio formaggio significa semplicemente avvolgere due volte con CheeseTopping. Questa flessibilità è il punto di forza del pattern Decorator!

Provalo tu

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

// Leggi l'input: un elenco di condimenti separati da virgole
$input = trim(fgets(STDIN));
$toppings = explode(',', $input);

// Inizia con una MargheritaPizza di base
$pizza = new MargheritaPizza();

// TODO: Scorri ogni condimento e avvolgi la pizza con il decoratore appropriato
// - "cheese" -> avvolgi con CheeseTopping
// - "pepperoni" -> avvolgi con PepperoniTopping
// - "mushroom" -> avvolgi con MushroomTopping

// TODO: Stampa il risultato nel formato: [description] = $[price]
// Formatta il prezzo con 2 cifre decimali usando number_format()

?>