在处理 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提供了一个简单直接的工厂类，旨在帮助你轻松地在 Symfony HttpFoundation 的
Request/
Response对象和 PSR-7 的
ServerRequestInterface/
ResponseInterface对象之间进行转换。这意味着你可以继续享受 Symfony HttpFoundation 带来的便利，同时也能无缝地与任何 PSR-7 兼容的库进行交互。
安装与使用
使用 Composer 安装
eonx-com/easy-psr7-factory非常简单：
composer require eonx/psr7-factory
安装完成后，你就可以在代码中使用了。它的核心思想是提供一个工厂类
EasyPsr7Factory，通过调用其方法来执行转换。
将 Symfony Request 转换为 PSR-7 ServerRequestInterface：
假设你有一个来自 Symfony HttpFoundation 的
$symfonyRequest对象，现在需要一个 PSR-7 格式的请求来传递给某个中间件或服务：
use EonX\EasyPsr7Factory\EasyPsr7Factory;
use Symfony\Component\HttpFoundation\Request; // 假设这是你的 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对象以便在你的应用中返回：
use EonX\EasyPsr7Factory\EasyPsr7Factory;
use GuzzleHttp\Psr7\Response; // 假设你使用 Guzzle PSR-7 实现
// 模拟一个 PSR-7 Response
$psr7Response = (new Response())
->withStatus(200)
->withHeader('Content-Type', 'application/json')
->withBody(\GuzzleHttp\Psr7\Utils::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：
// config/app.php
'providers' => [
// Other Service Providers...
\EonX\EasyPsr7Factory\Bridge\Laravel\EasyPsr7FactoryServiceProvider::class,
],Lumen:
在
bootstrap/app.php中注册 Service Provider：
// bootstrap/app.php $app->register(\EonX\EasyPsr7Factory\Bridge\Laravel\EasyPsr7FactoryServiceProvider::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 应用开发更加顺畅，专注于业务逻辑而非格式转换的烦恼吧！
