最近在 Code Review 的时候，看到某同事写代码，那叫一个“继承满天飞”。为了给一个核心类增加不同的功能，他硬生生造出了十几个子类。看着那像族谱一样庞大的类继承树，我手里的咖啡瞬间就不香了。
很多初学者（甚至老手）在面对 “如何在不修改原有类代码的情况下，动态地给对象增加功能” 这个问题时，第一反应往往是继承。
但是，朋友们，继承是把双刃剑。当你需要排列组合各种功能时，继承就会引发“类爆炸”。
今天，咱们不用枯燥的理论，用一杯奶茶为例，带大家由浅入深，彻底搞懂在 PHP 中如何使用：**装饰器模式 (Decorator Pattern)**。
1. 痛点：当需求开始“套娃”
假设我们在开发一个奶茶店的收银系统。
最开始，需求很简单：只卖原味奶茶，一杯 10 块钱。
你可能会写一个 MilkTea 类，里面有个 cost() 方法返回 10。
老板的需求总是猝不及防：
“我们要加料！加珍珠（+2元）、加椰果（+3元）、加布丁（+4元）…”
如果你用继承，你可能会写出：
PearlMilkTea(珍珠奶茶)CoconutMilkTea(椰果奶茶)PuddingMilkTea(布丁奶茶)
这时候，顾客说：“我要一杯加珍珠、加椰果、半糖、去冰的奶茶。”
完了，难道你要写一个 PearlAndCoconutAndHalfSugarAndNoIceMilkTea 类吗？
如果配料有 10 种，排列组合下来的子类数量简直是天文数字。这就是传说中的“类爆炸”。
2. 破局：像“洋葱”一样包裹
装饰器模式的核心思想，就是组合优于继承。
想象一下，我们不再通过生产新的奶茶品种来满足需求，而是把奶茶当作一个核心。
- 加珍珠？就是在奶茶外面包一层“珍珠装饰器”。
- 再加椰果？就在刚才的整体外面再包一层“椰果装饰器”。
这一层层包起来，就像俄罗斯套娃，或者像洋葱。每一层装饰器都只关心加上自己的价格，然后把任务交给里面的那一层。
3. 实战：用 PHP 一步一步撸代码
Talk is cheap, show me the code. 我们用 PHP 8 的语法来优雅地实现它。
第一步：定义统一的接口 (Contract)
首先，无论是原始的奶茶，还是加了料的奶茶，它们在本质上都是“饮品”。我们需要一个接口来规范它们。
<?php
// 饮品接口
interface Beverage
{
// 获取描述
public function getDescription(): string;
// 获取价格
public function cost(): int;
}第二步：实现最纯粹的原始对象 (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() . "\n";
// 2. 顾客说要加珍珠
// 把原味奶茶塞进珍珠装饰器里
$myDrink = new PearlDecorator($myDrink);
// 3. 顾客又说要加布丁
// 把刚才加了珍珠的奶茶，再塞进布丁装饰器里
$myDrink = new PuddingDecorator($myDrink);
echo "最终成品： " . $myDrink->getDescription() . "\n";
echo "最终价格： " . $myDrink->cost() . " 元\n";运行结果：
刚开始： 原味奶茶 价格：10
最终成品： 原味奶茶 + 珍珠 + 布丁
最终价格： 16 元看到了吗？我们可以无限地 new Decorator(new Decorator(...)) 套下去，完全不需要修改 SimpleMilkTea 的代码，也不需要创建复杂的继承树。
5. 什么时候使用？
不要手里拿着锤子，看什么都是钉子。只有在以下场景，强烈建议使用装饰器模式：
- 动态增强功能： 你需要在运行时给一个对象增加额外的职责（如：给文本加粗、给 HTTP 请求加 Token）。
- 避免继承爆炸： 当类变体过多，或者功能需要排列组合时。
- 遵循开闭原则 (OCP)： 对扩展开放，对修改关闭。
在 PHP 著名的 Laravel 框架中，中间件 (Middleware) 的实现机制在本质上就是一种变种的装饰器模式（洋葱模型），请求穿过层层中间件，最后到达控制器。
恭喜你，现在知道了中间件的实现方式……
