如何自定义实现PSR-7 ResponseInterface以减少响应样板代码？

你设计的装饰器模式自定义响应类的方案是完全合理的，不违反PSR-7标准的设计初衷。PSR-7只规定了HTTP响应的公共接口契约，只要你完整实现了ResponseInterface的所有方法，保证对外的行为符合标准，和其他基于PSR-7的组件就不会有兼容问题。

不过你的伪代码有个需要修正的点：PSR-7响应是*不可变（immutable）*对象，调用withHeader、withStatus这类方法会返回新的响应实例，你现在的写法没有将新实例赋值给$this->actualResponse，修改会丢失，需要调整为：

public function success($data)
{
    $body = $this->actualResponse->getBody();
    $body->write($this->serializer->serialize([
        'status' => 'success',
        'data' => $data,
        'messages' => [],
    ]));

    // 把修改后的新实例赋值给内部属性
    $this->actualResponse = $this->actualResponse
        ->withHeader('Content-Type', 'application/json')
        ->withStatus(200)
        ->withBody($body);

    return $this;
}

结合Slim 4的设计，有两个比自定义响应类更省心、维护成本更低的方案：

方案1：独立响应工厂（无需传$response参数） #

你之前想到的APIResponseFactory方案可以进一步优化，不需要每次传递控制器里的$response参数：

• 工厂内部直接注入Slim原生的ResponseFactoryInterface来创建空响应实例，不需要依赖外部传入的响应对象
• 序列化器等全局依赖直接在工厂构造函数注入，由DI容器统一管理

示例实现：

class APIResponseFactory
{
    public function __construct(
        private ResponseFactoryInterface $responseFactory,
        private Serializer $serializer
    ) {}

    public function success(array $data, int $statusCode = 200, array $messages = []): ResponseInterface
    {
        $response = $this->responseFactory->createResponse($statusCode);
        $response->getBody()->write($this->serializer->serialize([
            'status' => 'success',
            'data' => $data,
            'messages' => $messages
        ]));
        return $response->withHeader('Content-Type', 'application/json');
    }

    // 可以扩展fail、error等其他响应类型
}

控制器里的调用非常简洁，不需要传递响应参数：

public function __invoke(ServerRequestInterface $request): ResponseInterface
{
    $data = ['foo' => 'bar'];
    return $this->responseFactory->success($data);
}

方案2：自动转换中间件（零样板代码） #

如果想进一步简化控制器代码，可以使用中间件做全局输出转换：

• 控制器直接返回数组或者自定义的业务DTO，不需要手动创建响应
• 中间件在路由执行完成后，自动将返回的数组/DTO转换为统一结构的JSON响应

示例中间件逻辑：

class JsonResponseTransformMiddleware
{
    public function __construct(
        private Serializer $serializer,
        private ResponseFactoryInterface $responseFactory
    ) {}

    public function __invoke(ServerRequestInterface $request, RequestHandlerInterface $handler): ResponseInterface
    {
        $result = $handler->handle($request);
        
        // 如果返回的不是响应实例，自动转换为统一JSON结构
        if (!$result instanceof ResponseInterface) {
            $response = $this->responseFactory->createResponse(200);
            $response->getBody()->write($this->serializer->serialize([
                'status' => 'success',
                'data' => $result,
                'messages' => []
            ]));
            return $response->withHeader('Content-Type', 'application/json');
        }

        return $result;
    }
}

控制器可以直接返回业务数据，完全没有响应相关的样板代码：

public function __invoke(ServerRequestInterface $request): array
{
    return ['foo' => 'bar'];
}

• 封装响应辅助方法是完全合理的实践：PSR-7是底层的HTTP消息规范，本身就设计为给上层业务做封装的，只要最终对外输出的是符合ResponseInterface契约的实例，就完全符合标准的设计初衷，没有任何问题。
• 优先选择独立工厂/中间件方案的原因：不需要手动实现ResponseInterface的二十多个接口方法，维护成本更低，也不会出现因为装饰器实现不全导致的兼容问题。

内容的提问来源于stack exchange，提问作者404 Not Found