Exploring the Decorator Pattern in PHP

Welcome back! Having explored the Adapter and Composite Patterns, you are advancing in mastering structural design patterns in PHP. Today, we'll delve into the Decorator Pattern, a key structural design pattern that allows us to attach additional responsibilities to objects dynamically and transparently. This pattern is particularly useful when you want to extend the behavior of objects without altering the original code structure.

The Decorator Pattern enables you to wrap an object with additional behavior in a flexible and reusable manner. We'll guide you through using this pattern to extend the functionality of objects in a clean and maintainable way. Consider a basic coffee ordering system. By the end of this lesson, you'll be able to:

• Create a basic Coffee class.
• Implement decorators like MilkDecorator and SugarDecorator to enhance the features of the basic coffee.

Here's a glimpse of the PHP code you'll be working with:

We begin by defining a basic Coffee interface with a getDescription method for the retrieval of the coffee's name and a cost method for its price:

interface Coffee {
    public function getDescription(): string;
    public function cost(): float;
}

class SimpleCoffee implements Coffee {
    public function getDescription(): string {
        return "Coffee";
    }
    
    public function cost(): float {
        return 2.0;
    }
}

Next, we define a CoffeeDecorator class implementing the Coffee interface. This class holds a reference to a coffee object and serves as the base class for all decorators:

class CoffeeDecorator implements Coffee {
    protected $decoratedCoffee;
    
    public function __construct(Coffee $coffee) {
        $this->decoratedCoffee = $coffee;
    }
    
    public function getDescription(): string {
        return $this->decoratedCoffee->getDescription();
    }
    
    public function cost(): float {
        return $this->decoratedCoffee->cost();
    }
}

Finally, we implement concrete decorators like MilkDecorator and SugarDecorator that add milk and sugar to the coffee, respectively. These decorators enrich the decorated coffee object with new features:

class MilkDecorator extends CoffeeDecorator {
    public function getDescription(): string {
        return parent::getDescription() . ", Milk";
    }
    
    public function cost(): float {
        return parent::cost() + 0.5;
    }
}

class SugarDecorator extends CoffeeDecorator {
    public function getDescription(): string {
        return parent::getDescription() . ", Sugar";
    }
    
    public function cost(): float {
        return parent::cost() + 0.2;
    }
}

Here's how you can use these classes to create and customize coffee orders using the Decorator Pattern:

$coffee = new SimpleCoffee();
echo "Description: " . $coffee->getDescription() . ", Cost: " . $coffee->cost() . "\n"; 
// Output: Description: Coffee, Cost: 2

$coffeeWithMilk = new MilkDecorator($coffee);
echo "Description: " . $coffeeWithMilk->getDescription() . ", Cost: " . $coffeeWithMilk->cost() . "\n"; 
// Output: Description: Coffee, Milk, Cost: 2.5

$coffeeWithMilkAndSugar = new SugarDecorator($coffeeWithMilk);
echo "Description: " . $coffeeWithMilkAndSugar->getDescription() . ", Cost: " . $coffeeWithMilkAndSugar->cost() . "\n"; 
// Output: Description: Coffee, Milk, Sugar, Cost: 2.7

Observe how decorators like MilkDecorator and SugarDecorator can be combined to create customized coffee orders. This enables adding new features to the coffee object at runtime without altering its inherent code.