在处理 php 项目时，你是否曾面临这样的两难境地：你的应用程序（比如基于 symfony、laravel 或 Lumen）深度依赖 Symfony httpFoundation 组件来管理 HTTP 请求和响应，但你又想利用或集成那些遵循 PSR-7 标准的强大库？PSR-7 带来了 HTTP 消息的标准化，使得许多中间件、API 客户端和通用组件可以跨框架使用。然而，将 Symfony 的
Request
/
Response
对象手动转换为 PSR-7 的
ServerRequestInterface
/
ResponseInterface
，或者反过来，却是一项重复且容易出错的工作。每次都需要手动复制头部、请求体、查询参数等，这不仅浪费时间，还可能引入不必要的 bug。
幸好，composer 生态系统为我们提供了优雅的解决方案。今天，我们要介绍的英雄就是
eonx-com/easy-psr7-factory
。这个小巧而强大的 Composer 包，正是为了解决 Symfony HttpFoundation 与 PSR-7 之间的“语言不通”问题而生。
eonx-com/easy-psr7-factory
eonx-com/easy-psr7-factory
是什么？
eonx-com/easy-psr7-factory
提供了一个简单直接的工厂类，旨在帮助你轻松地在 Symfony HttpFoundation 的
Request
/
Response
对象和 PSR-7 的
ServerRequestInterface
/
ResponseInterface
对象之间进行转换。这意味着你可以继续享受 Symfony HttpFoundation 带来的便利，同时也能无缝地与任何 PSR-7 兼容的库进行交互。
安装与使用
使用 Composer 安装
eonx-com/easy-psr7-factory
非常简单：
<pre class="brush:php;toolbar:false;">composer require eonx/psr7-factory
安装完成后，你就可以在代码中使用了。它的核心思想是提供一个工厂类
EasyPsr7Factory
，通过调用其方法来执行转换。
将 Symfony Request 转换为 PSR-7 ServerRequestInterface：
假设你有一个来自 Symfony HttpFoundation 的
$symfonyRequest
对象，现在需要一个 PSR-7 格式的请求来传递给某个中间件或服务：
<pre class="brush:php;toolbar:false;">use EonXEasyPsr7FactoryEasyPsr7Factory; use SymfonyComponentHttpFoundationRequest; // 假设这是你的 Symfony Request 对象 // 模拟一个 Symfony Request $symfonyRequest = Request::create('/api/data?id=123', 'GET', ['param' => 'value'], [], [], ['HTTP_ACCEPT' => 'application/JSon']); // 使用 EasyPsr7Factory 创建 PSR-7 ServerRequestInterface $psr7Factory = new EasyPsr7Factory(); $serverRequest = $psr7Factory->createRequest($symfonyRequest); echo "PSR-7 Request Method: " . $serverRequest->getMethod() . PHP_EOL; // 输出 GET echo "PSR-7 Request URI: " . $serverRequest->getUri() . PHP_EOL; // 输出 /api/data?id=123 echo "PSR-7 Header Accept: " . implode(', ', $serverRequest->getHeader('Accept')) . PHP_EOL; // 输出 application/json // 你现在可以将 $serverRequest 传递给任何需要 PSR-7 请求的库了
将 PSR-7 ResponseInterface 转换为 Symfony Response：
反之，如果你从一个 PSR-7 兼容的库中得到了一个
$psr7Response
对象，需要将其转换回 Symfony 的
Response
对象以便在你的应用中返回：
<pre class="brush:php;toolbar:false;">use EonXEasyPsr7FactoryEasyPsr7Factory; use GuzzleHttpPsr7Response; // 假设你使用 Guzzle PSR-7 实现 // 模拟一个 PSR-7 Response $psr7Response = (new Response()) ->withStatus(200) ->withHeader('Content-Type', 'application/json') ->withBody(GuzzleHttpPsr7Utils::streamFor('{"message": "Hello from PSR-7!"}')); // 使用 EasyPsr7Factory 创建 Symfony Response $psr7Factory = new EasyPsr7Factory(); $symfonyResponse = $psr7Factory->createResponse($psr7Response); echo "Symfony Response Status Code: " . $symfonyResponse->getStatusCode() . PHP_EOL; // 输出 200 echo "Symfony Response Content: " . $symfonyResponse->getContent() . PHP_EOL; // 输出 {"message": "Hello from PSR-7!"} // 你现在可以将 $symfonyResponse 返回给浏览器了
Laravel / Lumen 用户的福音
如果你使用的是 Laravel 或 Lumen 框架，这个库同样适用！因为 Laravel/Lumen 的
Request
和
Response
类都扩展自 Symfony 的
HttpFoundation
组件，所以
eonx-com/easy-psr7-factory
可以直接与它们配合使用。
更棒的是，它还提供了一个开箱即用的 Service Provider，让你在 Laravel/Lumen 应用中可以更优雅地集成：
Laravel:
在
config/app.php
中添加 Service Provider：
<pre class="brush:php;toolbar:false;">// config/app.php 'providers' => [ // Other Service Providers... EonXEasyPsr7FactoryBridgeLaravelEasyPsr7FactoryServiceProvider::class, ],
Lumen:
在
bootstrap/app.php
中注册 Service Provider：
<pre class="brush:php;toolbar:false;">// bootstrap/app.php $app->register(EonXEasyPsr7FactoryBridgeLaravelEasyPsr7FactoryServiceProvider::class);
注册后，你就可以通过依赖注入来获取
EasyPsr7Factory
实例，无需手动创建。
优势与实际应用效果
- 简化开发流程： 告别手动映射请求头、请求体、查询参数的繁琐工作，大大减少了编写样板代码的时间。
- 提高兼容性： 你的应用程序可以轻松集成任何遵循 PSR-7 标准的第三方库，例如 Guzzle、Nyholm/psr7 等，而无需担心底层 HTTP 消息格式不兼容。
- 增强代码复用性： 允许你编写独立于框架的 HTTP 逻辑（使用 PSR-7），然后在需要时通过
EasyPsr7Factory
将其桥接到你的 Symfony、Laravel 或 Lumen 应用中。
- 降低错误率： 标准化的转换过程减少了人为错误的可能性，使代码更加健壮。
- 提升可维护性： 清晰的分离了框架特定的 HTTP 处理与通用 PSR-7 逻辑，使代码结构更清晰，更易于维护和理解。
总结
eonx-com/easy-psr7-factory
是一款非常实用的工具，它解决了 PHP 开发者在 Symfony HttpFoundation 和 PSR-7 之间进行 HTTP 消息转换的痛点。无论是为了集成第三方库，还是为了构建更具可移植性的应用组件，它都能提供一个高效、优雅的解决方案。如果你正在寻找一个可靠的方式来桥接这两个重要的 HTTP 标准，那么
eonx-com/easy-psr7-factory
绝对值得你尝试。让你的 PHP 应用开发更加顺畅，专注于业务逻辑而非格式转换的烦恼吧！
以上就是如何轻松实现Symfony与PSR-7请求响应的互转？eonx-com/easy-psr7-factory助你无缝集成的详细内容，更多请关注
评论（已关闭）
评论已关闭