第二步：实现原始对象 (Concrete Component)

这是最基础的组件——一杯纯粹的原味奶茶。

class SimpleMilkTea implements Beverage
{
    public function getDescription(): string
    {
        return "原味奶茶";
    }

    public function cost(): int
    {
        return 10; // 基础价 10 元
    }
}

第三步：构建装饰器基类 (Base Decorator)

这是装饰器模式的精髓。装饰器本身也实现了 Beverage 接口，但内部持有另一个 Beverage 对象。
注意：这里使用 abstract 关键字，子类只需实现具体的加料逻辑即可。

abstract class BeverageDecorator implements Beverage
{
    // PHP 8 构造函数属性提升，直接注入被装饰的对象
    public function __construct(protected Beverage $beverage) { }

    // 默认行为：直接调用里面那层的方法
    public function getDescription(): string
    {
        return $this->beverage->getDescription();
    }

    public function cost(): int
    {
        return $this->beverage->cost();
    }
}

第四步：编写具体的装饰器 (Concrete Decorators)

现在，想加什么配料，就创建对应的装饰器类，即写即用，互不干扰。

加珍珠（Pearl）：

class PearlDecorator extends BeverageDecorator
{
    public function getDescription(): string
    {
        // 先获取里面的描述，再追加自己的描述
        return $this->beverage->getDescription() . " + 珍珠";
    }

    public function cost(): int
    {
        // 核心价格 + 珍珠的价格(2元)
        return $this->beverage->cost() + 2;
    }
}

加布丁（Pudding）：

class PuddingDecorator extends BeverageDecorator
{
    public function getDescription(): string
    {
        return $this->beverage->getDescription() . " + 布丁";
    }

    public function cost(): int
    {
        return $this->beverage->cost() + 4; // 布丁贵一点
    }
}

4. 效果演示：见证组合的威力

代码编写完毕，接下来看看在业务逻辑中如何灵活运用。你会发现装饰器的组合方式极其灵活。

// 1. 点一杯原味奶茶
$myDrink = new SimpleMilkTea();
echo "刚开始： " . $myDrink->getDescription() . " 价格：" . $myDrink->cost() . "";

// 2. 顾客说要加珍珠
// 把原味奶茶塞进珍珠装饰器里
$myDrink = new PearlDecorator($myDrink);

// 3. 顾客又说要加布丁
// 把刚才加了珍珠的奶茶，再塞进布丁装饰器里
$myDrink = new PuddingDecorator($myDrink);

echo "最终成品： " . $myDrink->getDescription() . "";
echo "最终价格： " . $myDrink->cost() . " 元";

运行结果如下：

刚开始： 原味奶茶 价格：10
最终成品： 原味奶茶 + 珍珠 + 布丁
最终价格： 16 元

看到了吗？你可以无限嵌套 new Decorator(new Decorator(...))，完全不需要修改 SimpleMilkTea 的代码，也无需构建复杂的继承层级。

5. 何时应该使用装饰器模式？

切勿“手里拿着锤子，看什么都是钉子”。以下场景强烈推荐使用装饰器模式：

• 动态扩展功能：需要在运行时为对象动态添加额外职责，例如给文本添加加粗效果、为 HTTP 请求注入 Token 等。
• 规避类爆炸：当类的变体过多或功能需要多种排列组合时，装饰器可避免子类疯狂增长。
• 践行开闭原则 (OCP)：对扩展开放，对修改关闭。

在著名的 PHP 框架 Laravel 中，中间件 (Middleware) 的实现机制本质上就是装饰器模式的一种变体（洋葱模型），请求逐层穿过中间件，最后到达控制器。

恭喜你！现在你不仅掌握了装饰器模式，还理解了中间件的底层原理。