Webman中间件中获取并修改响应数据的实践指南

在Webman框架开发过程中，中间件是实现各种横切关注点的强大工具。本文将详细介绍如何在Webman中间件中获取并修改响应数据，特别是添加请求耗时统计功能。

中间件处理流程

Webman中间件的核心处理流程通常包含三个关键步骤：

1. 前置处理（请求到达控制器前的逻辑）
2. 调用后续中间件和控制器（$handler($request)）
3. 后置处理（响应返回前的逻辑）

响应数据修改的实现

要实现响应数据的修改，关键在于正确处理Response对象。以下是实现步骤：

1. 获取原始响应：通过调用$handler($request)获取原始响应对象
2. 解析响应内容：使用rawBody()方法获取原始响应体
3. 修改数据：解码JSON数据，添加或修改所需字段
4. 重建响应：将修改后的数据重新编码并设置回响应对象

完整实现示例

public function process(Request $request, callable $handler): Response {
    // 记录请求开始时间
    $start = microtime(true);
    
    // 执行后续中间件和控制器逻辑
    /** @var \support\Response $response */
    $response = $handler($request);
    
    try {
        // 获取原始响应体
        $body = $response->rawBody();
        
        // 解码JSON数据
        $data = json_decode($body, true);
        
        // 计算请求耗时
        $data['cost'] = round(microtime(true) - $start, 4);
        
        // 重新编码并设置响应体
        $response->withBody(json_encode($data));
    } catch (\Exception $e) {
        // 异常处理逻辑
    }
    
    return $response;
}

注意事项

1. 性能考虑：JSON编解码操作有一定性能开销，在高并发场景下需谨慎使用
2. 错误处理：务必添加try-catch块处理可能的JSON解析异常
3. 响应类型判断：应先检查响应内容类型是否为application/json
4. 数据格式一致性：确保修改后的数据保持原有格式规范

进阶应用

这种技术不仅可用于添加耗时统计，还可实现：

• 统一响应格式标准化
• 敏感数据过滤
• 响应数据加密
• API版本兼容处理

通过合理使用中间件修改响应数据，可以大大提升API的规范性和可维护性。