概述

装饰器模式（Decorator Pattern）是一种结构型设计模式，其核心思想是在不改变原有类结构和逻辑的前提下，通过动态添加额外的职责（功能）来扩展对象的行为。装饰器模式采用“组合优于继承”的设计原则，将核心功能与扩展功能分离，通过嵌套包装的方式灵活组合多种扩展功能，实现功能的动态增减和复用。

在装饰器模式中，所有装饰器类与被装饰的核心类遵循统一的接口规范，客户端可透明地使用被装饰后的对象，无需区分核心对象与装饰器对象，既保证了代码的灵活性和扩展性，又避免了继承带来的类爆炸问题。

核心价值

适用场景

注意事项

完整代码

以“商品订单价格计算”为业务场景，构建装饰器模式实现：核心功能为计算商品原价，通过装饰器动态添加“满减优惠”“折扣优惠”“优惠券抵扣”等扩展功能，支持多种优惠组合使用。

<?php
declare(strict_types = 1);

/**
 * 抽象组件接口：定义订单价格计算的统一规范
 */
interface OrderPrice
{
    /**
     * 计算最终价格
     * @return float
     */
    public function calculate(): float;

    /**
     * 获取价格描述（含优惠明细）
     * @return string
     */
    public function getDescription(): string;
}

/**
 * 具体组件：原始订单（核心功能：计算商品原价）
 */
class OriginalOrder implements OrderPrice
{
    /**
     * 商品原价
     * @var float
     */
    private float $originalPrice;

    public function __construct(float $originalPrice)
    {
        $this->originalPrice = $originalPrice;
    }

    public function calculate(): float
    {
        return $this->originalPrice;
    }

    public function getDescription(): string
    {
        return sprintf("商品原价：%.2f元", $this->originalPrice);
    }
}

/**
 * 抽象装饰器：实现组件接口，持有被装饰对象引用
 */
abstract class OrderDecorator implements OrderPrice
{
    /**
     * 被装饰的订单对象（可能是原始订单或其他装饰器）
     * @var OrderPrice
     */
    protected OrderPrice $order;

    public function __construct(OrderPrice $order)
    {
        $this->order = $order;
    }

    // 子类需实现具体的计算逻辑和描述逻辑
    abstract public function calculate(): float;
    abstract public function getDescription(): string;
}

/**
 * 具体装饰器1：满减优惠（满300减50）
 */
class FullReductionDecorator extends OrderDecorator
{
    private const MIN_AMOUNT = 300.0; // 满减门槛
    private const REDUCTION_AMOUNT = 50.0; // 减免金额

    public function calculate(): float
    {
        // 先计算被装饰对象的价格，再叠加当前装饰器的优惠
        $price = $this->order->calculate();
        return $price >= self::MIN_AMOUNT ? $price - self::REDUCTION_AMOUNT : $price;
    }

    public function getDescription(): string
    {
        // 拼接被装饰对象的描述和当前装饰器的优惠信息
        $baseDesc = $this->order->getDescription();
        $price = $this->order->calculate();
        $reductionDesc = $price >= self::MIN_AMOUNT 
            ? sprintf(" + 满%.2f减%.2f", self::MIN_AMOUNT, self::REDUCTION_AMOUNT)
            : "（未满足满减条件）";
        return $baseDesc . $reductionDesc;
    }
}

/**
 * 具体装饰器2：折扣优惠（9折）
 */
class DiscountDecorator extends OrderDecorator
{
    private const DISCOUNT_RATE = 0.9; // 折扣率

    public function calculate(): float
    {
        return $this->order->calculate() * self::DISCOUNT_RATE;
    }

    public function getDescription(): string
    {
        $baseDesc = $this->order->getDescription();
        return $baseDesc . sprintf(" + %.1f折优惠", self::DISCOUNT_RATE * 10);
    }
}

/**
 * 具体装饰器3：优惠券抵扣（固定抵扣20元）
 */
class CouponDecorator extends OrderDecorator
{
    private const COUPON_AMOUNT = 20.0; // 优惠券金额

    public function calculate(): float
    {
        $price = $this->order->calculate();
        return $price > self::COUPON_AMOUNT ? $price - self::COUPON_AMOUNT : 0.0;
    }

    public function getDescription(): string
    {
        $baseDesc = $this->order->getDescription();
        return $baseDesc . sprintf(" + 优惠券抵扣%.2f元", self::COUPON_AMOUNT);
    }
}

// 测试代码
try {
    // 1. 创建原始订单（商品原价400元）
    $order = new OriginalOrder(400.0);
    echo "原始订单：" . $order->getDescription() . " → 最终价格：" . $order->calculate() . "元<br/><br/>";

    // 2. 仅添加满减优惠
    $orderWithReduction = new FullReductionDecorator($order);
    echo "满减优惠订单：" . $orderWithReduction->getDescription() . " → 最终价格：" . $orderWithReduction->calculate() . "元<br/><br/>";

    // 3. 满减 + 折扣 组合优惠
    $orderWithReductionAndDiscount = new DiscountDecorator($orderWithReduction);
    echo "满减+折扣订单：" . $orderWithReductionAndDiscount->getDescription() . " → 最终价格：" . $orderWithReductionAndDiscount->calculate() . "元<br/><br/>";

    // 4. 满减 + 折扣 + 优惠券 组合优惠
    $orderWithAll = new CouponDecorator($orderWithReductionAndDiscount);
    echo "全套优惠订单：" . $orderWithAll->getDescription() . " → 最终价格：" . $orderWithAll->calculate() . "元<br/>";
} catch (\Exception $e) {
    echo "订单价格计算异常：" . $e->getMessage();
}

核心结构拆解

装饰器模式的核心由“抽象组件接口”“具体组件”“抽象装饰器”和“具体装饰器”四部分组成，结构层次清晰：

关键优化点

常见错误规避

扩展场景示例（新增装饰器无需修改原有代码）

若业务新增“会员积分抵扣”功能（每100积分抵扣10元），仅需新增具体装饰器类，无需修改原有组件和装饰器，符合“开放-封闭原则”：

// 新增具体装饰器：会员积分抵扣
class PointDeductionDecorator extends OrderDecorator
{
    private int $points; // 会员积分

    public function __construct(OrderPrice $order, int $points)
    {
        parent::__construct($order);
        $this->points = $points;
    }

    public function calculate(): float
    {
        $maxDeduction = floor($this->points / 100) * 10; // 每100积分抵扣10元
        $price = $this->order->calculate();
        return $price > $maxDeduction ? $price - $maxDeduction : 0.0;
    }

    public function getDescription(): string
    {
        $maxDeduction = floor($this->points / 100) * 10;
        $baseDesc = $this->order->getDescription();
        return $baseDesc . sprintf(" + 会员积分抵扣%.2f元（当前积分：%d）", $maxDeduction, $this->points);
    }
}

// 测试新增装饰器（满减+折扣+优惠券+积分抵扣）
$orderWithPoints = new PointDeductionDecorator($orderWithAll, 500); // 500积分可抵扣50元
echo "<br/>全套优惠+积分抵扣：" . $orderWithPoints->getDescription() . " → 最终价格：" . $orderWithPoints->calculate() . "元<br/>";
// 输出结果：
// 全套优惠+积分抵扣：商品原价：400.00元 + 满300.00减50.00 + 9.0折优惠 + 优惠券抵扣20.00元 + 会员积分抵扣50.00元（当前积分：500） → 最终价格：242.00元

实际应用场景

装饰器模式与其他模式对比