PHP装饰器模式怎么实现

wen PHP项目 2026-07-11 1

PHP装饰器模式深度解析：从原理到实战的完整指南

📖 目录导读

什么是装饰器模式？
为什么需要装饰器模式？
PHP装饰器模式的核心结构
实战案例：用户权限系统
装饰器模式 vs 继承 vs 其他模式
常见问题解答（FAQ）
性能与最佳实践

什么是装饰器模式？

装饰器模式（Decorator Pattern）是一种结构型设计模式，它允许你动态地给一个对象添加额外的职责（功能），而不改变其原有类结构，就像给手机套上保护壳——手机本身功能不变，但多了防摔、美观等新特性。

PHP装饰器模式怎么实现

在PHP开发中,装饰器模式常用于日志记录、权限校验、缓存处理、数据格式化等场景，它遵循开放-封闭原则（对扩展开放，对修改封闭）。

为什么需要装饰器模式？

传统继承的痛点

假设你有一个Logger类，需要支持：

日志写入文件
日志加密
日志压缩
日志发送邮件

使用继承：你需要创建FileLogger、EncryptedFileLogger、CompressedEncryptedFileLogger... 排列组合导致类爆炸（4个功能 → 16个类）。

装饰器模式方案：每个功能做成一个装饰器，可以任意组合：

$logger = new FileLogger();
$logger = new EncryptDecorator($logger);
$logger = new CompressDecorator($logger);
// 一条链式调用即可

核心优势对比

特性	继承	装饰器
扩展方式	静态编译	动态组合
组合爆炸	❌ 类数量指数增长	✅ 线性增长
运行时调整	❌ 不可	✅ 可
单一职责	❌ 父类臃肿	✅ 每个装饰器独立

PHP装饰器模式的核心结构

4个关键角色

Component（组件接口）：定义对象的核心操作
ConcreteComponent（具体组件）：实现核心业务逻辑
Decorator（装饰器基类）：持有Component引用，实现相同接口
ConcreteDecorator（具体装饰器）：添加额外功能

示例代码：基础框架

<?php
// ① 组件接口
interface Notifier {
    public function send(string $message): void;
}
// ② 具体组件
class EmailNotifier implements Notifier {
    public function send(string $message): void {
        echo "发送邮件: {$message}\n";
    }
}
// ③ 装饰器基类
abstract class NotifierDecorator implements Notifier {
    protected Notifier $notifier;
    public function __construct(Notifier $notifier) {
        $this->notifier = $notifier;
    }
    public function send(string $message): void {
        $this->notifier->send($message);
    }
}
// ④ 具体装饰器：添加短信通知
class SMSDecorator extends NotifierDecorator {
    public function send(string $message): void {
        parent::send($message); // 先执行原逻辑
        echo "发送短信: {$message}\n"; // 扩展功能
    }
}
// 使用示例
$notifier = new EmailNotifier();
$notifier = new SMSDecorator($notifier);
$notifier->send("系统维护通知");
// 输出：
// 发送邮件: 系统维护通知
// 发送短信: 系统维护通知
?>

实战案例：用户权限系统

假设我们需要一个HTTP请求处理系统,支持：

基础请求处理
认证检查（JWT Token）
日志记录
频率限制（Rate Limiting）

完整实现

<?php
// 组件接口
interface RequestHandler {
    public function handle(array $request): array;
}
// 核心处理器
class CoreHandler implements RequestHandler {
    public function handle(array $request): array {
        return ['status' => 'success', 'data' => $request['path']];
    }
}
// 装饰器基类
abstract class HandlerDecorator implements RequestHandler {
    protected RequestHandler $handler;
    public function __construct(RequestHandler $handler) {
        $this->handler = $handler;
    }
    public function handle(array $request): array {
        return $this->handler->handle($request);
    }
}
// 具体装饰器：认证
class AuthDecorator extends HandlerDecorator {
    public function handle(array $request): array {
        if (empty($request['token'])) {
            return ['status' => 'error', 'message' => 'Unauthorized'];
        }
        // 验证token...
        return parent::handle($request);
    }
}
// 具体装饰器：日志
class LoggingDecorator extends HandlerDecorator {
    public function handle(array $request): array {
        $start = microtime(true);
        $result = parent::handle($request);
        $duration = microtime(true) - $start;
        echo "[LOG] Request: {$request['path']} - {$duration}s\n";
        return $result;
    }
}
// 具体装饰器：频率限制
class RateLimitingDecorator extends HandlerDecorator {
    private array $ipCount = [];
    public function handle(array $request): array {
        $ip = $request['ip'] ?? 'unknown';
        $this->ipCount[$ip] = ($this->ipCount[$ip] ?? 0) + 1;
        if ($this->ipCount[$ip] > 100) {
            return ['status' => 'error', 'message' => 'Too Many Requests'];
        }
        return parent::handle($request);
    }
}
// 灵活组合
$handler = new CoreHandler();
$handler = new AuthDecorator($handler);
$handler = new LoggingDecorator($handler);
$handler = new RateLimitingDecorator($handler);
$result = $handler->handle([
    'path' => '/api/order',
    'token' => 'valid_jwt_token',
    'ip' => '192.168.1.1'
]);
print_r($result);
?>

装饰器模式 vs 继承 vs 其他模式

与策略模式的区别

对比项	装饰器模式	策略模式
目的	动态添加功能	动态切换算法
结构	包装关系	委托关系
典型场景	日志、权限	支付方式、排序算法

与代理模式的区别

对比项	装饰器模式	代理模式
控制点	增强功能	控制访问
创建时机	客户端决定	编译期决定
典型例子	加密包装	延迟加载代理

常见问题解答（FAQ）

Q1：装饰器模式会导致性能问题吗？

A：理论上每层装饰器增加一次调用开销，但现代PHP的微秒级性能消耗可忽略，注意：避免在装饰器中做耗时的IO操作。

Q2：如何解决多装饰器组合时的依赖问题？

A：使用依赖注入容器（如PHP-DI）管理装饰器链，示例如下：

// 使用Yii2的装饰器配置
$container->set('handler', function($container) {
    $handler = $container->get(CoreHandler::class);
    $handler = new AuthDecorator($handler);
    $handler = new LoggingDecorator($handler);
    return $handler;
});

Q3：什么时候不应该用装饰器模式？

当功能组合固定不变时（继承更简单）
当装饰器与组件有强耦合时（应使用策略模式）
当装饰器数量超过5层时（考虑组合可能优化）

性能与最佳实践

性能优化技巧

使用SplObjectStorage缓存装饰器实例
避免在装饰器中创建大对象（可用闭包延迟加载）
考虑使用PHP 8的Attributes实现声明式装饰

企业级最佳实践

// 推荐：使用Traits+接口替代纯继承
trait Loggable {
    public function log(string $message) {
        echo "[LOG] {$message} at " . date('Y-m-d H:i:s') . "\n";
    }
}
// 使用PHP 8匹配表达式优化装饰器链
$result = match($type) {
    'default' => $handler,
    'withAuth' => new AuthDecorator($handler),
    'withLogging' => new LoggingDecorator($handler),
    'premium' => new RateLimitingDecorator(new AuthDecorator(new LoggingDecorator($handler)))
};

学习资源推荐

官方文档：php.net手册 - 设计模式
经典书籍：《设计模式：可复用面向对象软件的基础》
实战框架：Laravel的中间件系统和Symfony的EventDispatcher都使用了装饰器思想

PHP装饰器模式通过灵活的对象包装,实现了功能的动态组合，它特别适合需要遵循开闭原则、避免类爆炸的现代PHP应用，掌握它，你的代码将更具扩展性和可维护性。