尧图网站建设 
后端Web框架【免费下载链接】symfonyThe Symfony PHP framework项目地址https://gitcode.com/GitHub_Trending/sy/symfony点击查看免费下载Symfony 的 PSR-7 Bridgesymfony/psr-http-message-bridge是连接 Symfony 自身 HTTP 消息模型HttpFoundation的Request/Response与 PSR-7/PSR-17 标准消息模型ServerRequestInterface/ResponseInterface等的官方桥接组件。本文以该组件的 CHANGELOG.md 为主线结合仓库内源码、接口定义与功能测试完整梳理它的核心转换能力、控制器集成方式、安装要求与版本演进脉络帮助你理解这套双向转换机制并直接用于实战。一、桥接层全景四个核心角色从源码结构看该 Bridge 由四个可独立使用的构件组成全部位于src/Symfony/Bridge/PsrHttpMessage/目录下构件源码位置职责PsrHttpFactoryFactory/PsrHttpFactory.php将 Symfony 的Request/Response转换为 PSR-7 消息Symfony → PSR-7HttpFoundationFactoryFactory/HttpFoundationFactory.php将 PSR-7 的ServerRequestInterface/ResponseInterface转换为 Symfony 消息PSR-7 → SymfonyPsrServerRequestResolverArgumentValueResolver/PsrServerRequestResolver.php控制器参数注入把 PSR-7 请求对象直接作为控制器方法参数PsrResponseListenerEventListener/PsrResponseListener.php控制器返回值转换自动把控制器返回的 PSR-7 响应转回 Symfony 响应两个工厂分别实现 HttpMessageFactoryInterfacecreateRequest()/createResponse()与 HttpFoundationFactoryInterface同样是一对createRequest()/createResponse()方向相反。CHANGELOG 中多次出现的工厂演进DiactorosFactory→PsrHttpFactory、流式请求/响应支持、上传文件桥接等都落实在这两个工厂及其配套的 Factory/UploadedFile.php 上。二、安装与环境要求以当前仓库为准根据该 Bridge 的 composer.jsonPHP 版本 8.4.1运行时依赖psr/http-message^1.0|^2.0即同时兼容 PSR-7 契约 v1 与 v2对应 CHANGELOG 2.2.0 中 Support version 2 of the psr/http-message contractssymfony/http-foundation^7.4|^8.0开发依赖nyholm/psr7 ^1.1PSR-7/PSR-17 的参考实现、php-http/discovery ^1.15PSR-17 工厂自动发现、symfony/framework-bundle、symfony/http-kernel、symfony/event-dispatcher、symfony/runtime等冲突声明php-http/discovery低于1.15会冲突对应 CHANGELOG 6.4 中引入的php-http/discovery自动发现能力。由于创建 PSR-7 消息必须依赖 PSR-17 工厂接口ServerRequestFactoryInterface、StreamFactoryInterface、UploadedFileFactoryInterface、ResponseFactoryInterface典型安装命令为源码中LogicException提示原文composer require php-http/discovery psr/http-factory-implementation:*安装php-http/discovery后即使不显式传入工厂实例PsrHttpFactory也会自动探测可用的 PSR-17 实现详见下一节。三、Symfony → PSR-7PsrHttpFactory的转换细节PsrHttpFactory的构造函数接收四个可选的 PSR-17 工厂new PsrHttpFactory( ?ServerRequestFactoryInterface $serverRequestFactory, ?StreamFactoryInterface $streamFactory, ?UploadedFileFactoryInterface $uploadedFileFactory, ?ResponseFactoryInterface $responseFactory, );3.1 工厂自动探测6.4 新能力当任意一个工厂参数为null时源码会按以下顺序自动选择 PSR-17 实现若Http\Discovery\Psr17Factory存在安装了php-http/discovery使用DiscoveryPsr17Factory否则若Nyholm\Psr7\Factory\Psr17Factory存在使用NyholmPsr17Factory两者都不存在则抛出LogicException并提示执行composer require php-http/discovery psr/http-factory-implementation:*。这正是 CHANGELOG 6.4 中 Supportphp-http/discoveryfor auto-detecting PSR-17 factories 的源码落地四个工厂参数缺一即可触发探测探测成功后四个接口共用同一个 PSR-17 工厂实例。3.2createRequest()完整映射表核心方法createRequest(Request $symfonyRequest): ServerRequestInterface的转换逻辑对应 PsrHttpFactory.phpSymfony 输入PSR-7 输出实现要点方法 URI 服务器参数createServerRequest(method, uri, serverParams)URI 由getSchemeAndHttpHost() getBaseUrl() getPathInfo()拼接并按需追加?QUERY_STRING请求头withHeader()逐个头设置捕获InvalidArgumentException后静默忽略非法头对应 2.1.3 修复请求体withBody()用createStreamFromResource($symfonyRequest-getContent(true))包装原始资源解析后请求体withParsedBody()若 Content-Type 为 JSONjson_decode(..., JSON_BIGINT_AS_STRING)解析且仅接受数组结果否则回退为$request-request-all()表单参数。这一分支正是 2.3.0 LeverageRequest::getPayload() 与 2.3.1 Dont rely onRequest::getPayload() 反复打磨的位置上传文件withUploadedFiles()递归处理$files数组null值转为UPLOAD_ERR_NO_FILE的空上传UploadedFile实例用流、大小、错误码、原始文件名与 MIME 类型构建 PSR-7 上传文件Cookies / 查询参数 / 属性withCookieParams()/withQueryParams()/withAttribute()属性逐个写入保持路由等附加数据不丢失3.3createResponse()响应转换createResponse(Response $symfonyResponse): ResponseInterface的处理逻辑PsrHttpFactory.php状态码与状态文本来自Response::$statusTexts二进制文件响应BinaryFileResponse且响应头中没有Content-Range直接createStreamFromFile()文件路径避免整文件读入内存其余情况写入php://temp临时流StreamedResponse与BinaryFileResponse通过ob_start()输出缓冲逐段捕获sendContent()的内容普通响应则直接$stream-write($response-getContent())响应头逐一写入同样忽略非法头Cookies 被序列化为多个Set-Cookie头最后withProtocolVersion()保留 HTTP 协议版本。其中 BinaryFileResponse with Content-Range 走临时流分支正是 CHANGELOG 2.0.2 中修复内容的源码体现。四、PSR-7 → SymfonyHttpFoundationFactory的转换细节方向相反的 HttpFoundationFactory.php 提供两个方法均可选bool $streamed false参数对应 CHANGELOG 1.2.0 Added support for streamed responses 与 1.3.0 Added support for streamed requests。4.1createRequest()组装 Symfony 请求服务器参数从 PSR-7 URI 推导SERVER_NAME、SERVER_PORThttps默认 443否则 80、REQUEST_URI路径 查询串、QUERY_STRINGhttps时置HTTPSon方法写入REQUEST_METHOD最终array_replace($psrRequest-getServerParams(), $server)以 URI 推导值为准覆盖原始参数——这正是 2.0.1 Fix populating default port and headers 与 2.0.2 Fix populating server params from URI 修复的领域请求体streamedtrue时通过detach()移交流资源不整体读入内存否则__toString()一次性读取表单参数getParsedBody()仅当结果为数组时才作为请求体参数is_array($parsedBody) ? $parsedBody : []避免非数组解析结果污染$_POST语义上传文件递归把 PSR-7 上传文件转成 Symfony 的UploadedFile详见下方属性 / Cookies / 查询参数分别来自getAttributes()、getCookieParams()、getQueryParams()请求头通过$request-headers-add($psrRequest-getHeaders())整体注入。4.2 上传文件桥接Factory/UploadedFile.php仓库在 Factory/UploadedFile.php 中提供了一个继承自Symfony\Component\HttpFoundation\File\UploadedFile的桥接类对应 CHANGELOG 1.3.0 Fixed bridging UploadedFile objects构造函数接收 PSR-7 的UploadedFileInterface与一个临时路径回调HttpFoundationFactory默认用tempnam(sys_get_temp_dir(), symfony)生成若上传错误为UPLOAD_ERR_NO_FILE则路径留空若流的元数据 URI 不是字符串或并非真实上传文件is_uploaded_file()为假常见于测试环境则判定为 test 模式并先moveTo()到临时路径重写的move()方法在有效且非 test 模式时直接委托给$psrUploadedFile-moveTo()把移动文件的最终动作交还 PSR-7 实现并设置chmod(0o666 ~umask())。4.3createResponse()PSR-7 响应转回 Symfony先把Set-Cookie头从 PSR-7 响应中剥离随后通过Cookie::fromString()逐一还原为 Symfony 的Cookie对象并setCookie()对应 2.0.2 Create cookies as rawstreamedtrue时构造StreamedResponse回调内先rewind()若可 seek再按responseBufferMaxLength默认 16372 字节构造函数可配置分块echo $body-read()直到eof()实现流式输出非流式则用getBody()-__toString()构造普通Response最后setProtocolVersion()同步 HTTP 协议版本。五、控制器集成请求注入 响应自动转换CHANGELOG 2.1.0 一次性引入了两个关键集成点PsrResponseListener自动转换控制器返回的 PSR-7 响应与PsrServerRequestResolver允许向控制器注入 PSR-7 请求对象。它们让桥接从手动调用工厂升级为控制器零样板代码。5.1PsrServerRequestResolver参数注入该类实现的是 Symfony 6.2 引入的ValueResolverInterfaceCHANGELOG 2.3.0 记录并在 6.4 中移除了旧的ArgumentValueResolverInterface实现RemoveArgumentValueResolverInterfacefromPsrServerRequestResolver。源码中维护一张受支持类型表private const SUPPORTED_TYPES [ ServerRequestInterface::class true, RequestInterface::class true, MessageInterface::class true, ];resolve()方法在参数类型命中上述三者之一时yield $this-httpMessageFactory-createRequest($request)——即自动把当前 Symfony 请求交给HttpMessageFactoryInterface转换后注入控制器。仓库功能测试夹具 PsrRequestController.php 展示了三种典型用法// 注入最具体的 ServerRequestInterface public function serverRequestAction(ServerRequestInterface $request): ResponseInterface { return $this-responseFactory-createResponse() -withBody($this-streamFactory-createStream( sprintf(htmlbody%s/body/html, $request-getMethod()) )); } // 注入 RequestInterface读取方法与请求体 public function requestAction(RequestInterface $request): ResponseInterface { return $this-responseFactory-createResponse()-withStatus(403) -withBody($this-streamFactory-createStream( sprintf(htmlbody%s %s/body/html, $request-getMethod(), $request-getBody()-getContents()) )); } // 注入更宽泛的 MessageInterface读取请求头 public function messageAction(MessageInterface $request): ResponseInterface { return $this-responseFactory-createResponse()-withStatus(422) -withBody($this-streamFactory-createStream( sprintf(htmlbody%s/body/html, $request-getHeader(X-My-Header)[0]) )); }5.2PsrResponseListener响应自动转换PsrResponseListener订阅KernelEvents::VIEWPsrResponseListener.php当控制器返回值instanceof ResponseInterface时通过HttpFoundationFactoryInterface未注入时默认new HttpFoundationFactory()将其转为 Symfony 响应并setResponse()返回值不是 PSR-7 响应则直接放行。5.3 功能测试佐证仓库 ControllerTest.php 通过 WebTestCase 验证了完整链路GET /server-request→ 200响应体为GET注入ServerRequestInterfacePOST /request带some content请求体→ 403响应体为POST some content注入RequestInterface并读取流PUT /message带X-My-Header: some content→ 422响应体为some content注入MessageInterface并读取头。PsrResponseListenerTest.php 则单独验证控制器返回 PSR-7Response时事件被置入响应返回数组或null时不产生响应。六、版本演进时间线从 1.0.0 到 6.4CHANGELOG 完整记录了三个主要阶段的演进逐条展开如下6.1 1.x奠基与工厂化1.0.0 / 1.0.1 / 1.0.2初始发布支持 Symfony 4由 dunglas 贡献修复 PSR-7 Request 的 request target。1.1.0新增基于PSR-17 工厂创建 PSR-7 消息的能力——即PsrHttpFactory的核心思路不再依赖某个具体 PSR-7 实现类而是通过四个标准工厂接口构建消息。1.1.1弃用DiactorosFactory建议改用PsrHttpFactory此时尚不触发弃用告警。1.1.2修复createResponse。1.2.0最低 PHP 升至 7.1新增流式响应支持即HttpFoundationFactory::createResponse(..., true)的StreamedResponse分支补充文档链接。1.3.0最低 Symfony 升至 4.4、支持 Symfony 5.0新增流式请求支持createRequest(..., true)的detach()分支修复UploadedFile对象的桥接见上文 4.2。6.2 2.x契约升级与控制器集成2.0.0正式移除DiactorosFactoryPsrHttpFactory成为唯一入口。2.0.1不再规范化查询字符串PsrHttpFactory修复 HTTPS 请求的转换修复默认端口与请求头的填充HttpFoundationFactory。2.0.2修复HttpFoundationFactory从 URI 填充服务器参数Cookies 以 raw 形式创建修复带Content-Range的BinaryFileResponsePsrHttpFactory。2.1.0新增PsrResponseListener自动转换控制器返回的 PSR-7 响应与PsrServerRequestResolver向控制器注入 PSR-7 请求对象——详见本文第五节。2.1.2允许 Symfony 6。2.1.3创建 PSR-7 对象时忽略非法 HTTP 头修复传入moveTo()的错误类型。2.2.0放弃 Symfony 4最低 PHP 升至 7.2支持psr/http-message契约 v2。2.3.0利用Request::getPayload()填充 PSR-7 请求的解析后请求体实现 Symfony 6.2 引入的ValueResolverInterface。2.3.1不再依赖Request::getPayload()填充解析后请求体回归到基于 Content-Type 分支的解析策略见 3.2 的说明。6.3 6.4并入 monorepo 与生态化6.4Bridge 被导入 Symfony 官方 monorepo 并同步发布节奏从PsrServerRequestResolver移除ArgumentValueResolverInterface完全转向ValueResolverInterface支持php-http/discovery自动探测 PSR-17 工厂见 3.1并在 composer.json 中声明与php-http/discovery 1.15冲突。七、边界修复清单值得在集成时注意的细节把 CHANGELOG 中的修复条目整理为一张避坑清单每一条都能在源码或测试中找到对应实现修复条目版本涉及模块实战含义忽略非法 HTTP 头2.1.3两个工厂的withHeader()转换时遇到非法头名不会抛异常中断而是静默跳过不规范化查询字符串2.0.1PsrHttpFactory查询串原样保留避免被意外重写HTTPS 请求转换2.0.1HttpFoundationFactory从 URI scheme 推导SERVER_PORT与HTTPS标记默认端口与请求头填充2.0.1HttpFoundationFactoryhttps默认端口 443否则 80与请求头一起补全从 URI 填充服务器参数2.0.2HttpFoundationFactoryURI 推导值通过array_replace覆盖 PSR-7 原始 serverParamsCookies 以 raw 创建2.0.2HttpFoundationFactorySet-Cookie头通过Cookie::fromString()原样还原Content-Range的BinaryFileResponse2.0.2PsrHttpFactory带Content-Range时不再直接映射文件流改走临时流逐段发送修复传入moveTo()的类型2.1.3上传文件桥接moveTo()参数类型修正避免把目录当文件目标解析后请求体的两次调整2.3.0 / 2.3.1PsrHttpFactory::createRequest()JSON 请求用JSON_BIGINT_AS_STRING解码且仅接受数组其余回退表单参数八、升级路径与使用建议结合 CHANGELOG 与 composer.json 的约束给出几条可直接落地的实践建议老代码迁移若仍引用DiactorosFactory需要按 1.1.1 的弃用提示与 2.0.0 的移除动作统一迁移到PsrHttpFactory依赖 PSR-17 工厂接口不绑定具体实现。控制器风格统一在基于该 Bridge 的控制器中统一注入 PSR-7 请求 返回 PSR-7 响应由PsrServerRequestResolver与PsrResponseListener自动完成双向转换注意参数类型可以是ServerRequestInterface、RequestInterface或更宽的MessageInterface按需选择。流式场景大文件上传/下载优先开启streamed选项HttpFoundationFactory的流式请求用detach()、流式响应按 16372 字节分块输出避免整体载入内存。版本匹配当前仓库要求 PHP 8.4.1、psr/http-message ^1.0|^2.0、symfony/http-foundation ^7.4|^8.0若要使用 PSR-17 工厂自动发现需安装php-http/discovery且版本不低于 1.15。更详细的运行约束可查看仓库内的 composer.json 与 phpunit.xml.dist测试套件配置。总体而言该 Bridge 的价值在于它让 Symfony 应用既能在内部保留HttpFoundation的成熟生态又能与遵循 PSR-7/PSR-17 的中间件、客户端与框架自由互操作——双向工厂负责数据映射参数解析器与视图监听器负责把桥接能力无缝接入控制器层而 CHANGELOG 中每一次版本迭代都在收敛边界行为、升级契约并降低接入成本。赞分享后端Web框架【免费下载链接】symfonyThe Symfony PHP framework项目地址https://gitcode.com/GitHub_Trending/sy/symfony点击查看免费下载相关推荐ShowDoc 中的 PSR-7 HTTP 消息实战psr/http-message 消息头与流式消息体操作指南ShowDoc 中的 PSR 7 HTTP 消息实战psr/http message 消息头与流式消息体操作指南 导读 本文基于 ShowDoc 仓库内 ps文档知识库后端前端OpenCart 中的 PSR-7 接口契约psr/http-message 版本演进与 HTTP 消息接口体系解析OpenCart 中的 PSR 7 接口契约psr/http message 版本演进与 HTTP 消息接口体系解析 导读 本文围绕 OpenCart 仓库电商后端OpenCart 中的 PSR-7 标准psr/http-message 接口包全解与 HTTP 消息编程实战OpenCart 中的 PSR 7 标准psr/http message 接口包全解与 HTTP 消息编程实战 本篇技术指南围绕 OpenCart 仓库中随电商后端上一篇DeepSeek Harness 跨工作区会话恢复统一存储、工作区作用域与目录交接的完整实现解析下一篇PUBG罗技鼠标宏终极配置指南简单三步实现完美压枪创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 Symfony PSR-7 Bridge（PsrHttpMessage Bridge）演进与实战：HttpFoundation 与 PSR-7 消息模型的双向转换
后端Web框架【免费下载链接】symfonyThe Symfony PHP framework项目地址https://gitcode.com/GitHub_Trending/sy/symfony点击查看免费下载Symfony 的 PSR-7 Bridgesymfony/psr-http-message-bridge是连接 Symfony 自身 HTTP 消息模型HttpFoundation的Request/Response与 PSR-7/PSR-17 标准消息模型ServerRequestInterface/ResponseInterface等的官方桥接组件。本文以该组件的 CHANGELOG.md 为主线结合仓库内源码、接口定义与功能测试完整梳理它的核心转换能力、控制器集成方式、安装要求与版本演进脉络帮助你理解这套双向转换机制并直接用于实战。一、桥接层全景四个核心角色从源码结构看该 Bridge 由四个可独立使用的构件组成全部位于src/Symfony/Bridge/PsrHttpMessage/目录下构件源码位置职责PsrHttpFactoryFactory/PsrHttpFactory.php将 Symfony 的Request/Response转换为 PSR-7 消息Symfony → PSR-7HttpFoundationFactoryFactory/HttpFoundationFactory.php将 PSR-7 的ServerRequestInterface/ResponseInterface转换为 Symfony 消息PSR-7 → SymfonyPsrServerRequestResolverArgumentValueResolver/PsrServerRequestResolver.php控制器参数注入把 PSR-7 请求对象直接作为控制器方法参数PsrResponseListenerEventListener/PsrResponseListener.php控制器返回值转换自动把控制器返回的 PSR-7 响应转回 Symfony 响应两个工厂分别实现 HttpMessageFactoryInterfacecreateRequest()/createResponse()与 HttpFoundationFactoryInterface同样是一对createRequest()/createResponse()方向相反。CHANGELOG 中多次出现的工厂演进DiactorosFactory→PsrHttpFactory、流式请求/响应支持、上传文件桥接等都落实在这两个工厂及其配套的 Factory/UploadedFile.php 上。二、安装与环境要求以当前仓库为准根据该 Bridge 的 composer.jsonPHP 版本 8.4.1运行时依赖psr/http-message^1.0|^2.0即同时兼容 PSR-7 契约 v1 与 v2对应 CHANGELOG 2.2.0 中 Support version 2 of the psr/http-message contractssymfony/http-foundation^7.4|^8.0开发依赖nyholm/psr7 ^1.1PSR-7/PSR-17 的参考实现、php-http/discovery ^1.15PSR-17 工厂自动发现、symfony/framework-bundle、symfony/http-kernel、symfony/event-dispatcher、symfony/runtime等冲突声明php-http/discovery低于1.15会冲突对应 CHANGELOG 6.4 中引入的php-http/discovery自动发现能力。由于创建 PSR-7 消息必须依赖 PSR-17 工厂接口ServerRequestFactoryInterface、StreamFactoryInterface、UploadedFileFactoryInterface、ResponseFactoryInterface典型安装命令为源码中LogicException提示原文composer require php-http/discovery psr/http-factory-implementation:*安装php-http/discovery后即使不显式传入工厂实例PsrHttpFactory也会自动探测可用的 PSR-17 实现详见下一节。三、Symfony → PSR-7PsrHttpFactory的转换细节PsrHttpFactory的构造函数接收四个可选的 PSR-17 工厂new PsrHttpFactory( ?ServerRequestFactoryInterface $serverRequestFactory, ?StreamFactoryInterface $streamFactory, ?UploadedFileFactoryInterface $uploadedFileFactory, ?ResponseFactoryInterface $responseFactory, );3.1 工厂自动探测6.4 新能力当任意一个工厂参数为null时源码会按以下顺序自动选择 PSR-17 实现若Http\Discovery\Psr17Factory存在安装了php-http/discovery使用DiscoveryPsr17Factory否则若Nyholm\Psr7\Factory\Psr17Factory存在使用NyholmPsr17Factory两者都不存在则抛出LogicException并提示执行composer require php-http/discovery psr/http-factory-implementation:*。这正是 CHANGELOG 6.4 中 Supportphp-http/discoveryfor auto-detecting PSR-17 factories 的源码落地四个工厂参数缺一即可触发探测探测成功后四个接口共用同一个 PSR-17 工厂实例。3.2createRequest()完整映射表核心方法createRequest(Request $symfonyRequest): ServerRequestInterface的转换逻辑对应 PsrHttpFactory.phpSymfony 输入PSR-7 输出实现要点方法 URI 服务器参数createServerRequest(method, uri, serverParams)URI 由getSchemeAndHttpHost() getBaseUrl() getPathInfo()拼接并按需追加?QUERY_STRING请求头withHeader()逐个头设置捕获InvalidArgumentException后静默忽略非法头对应 2.1.3 修复请求体withBody()用createStreamFromResource($symfonyRequest-getContent(true))包装原始资源解析后请求体withParsedBody()若 Content-Type 为 JSONjson_decode(..., JSON_BIGINT_AS_STRING)解析且仅接受数组结果否则回退为$request-request-all()表单参数。这一分支正是 2.3.0 LeverageRequest::getPayload() 与 2.3.1 Dont rely onRequest::getPayload() 反复打磨的位置上传文件withUploadedFiles()递归处理$files数组null值转为UPLOAD_ERR_NO_FILE的空上传UploadedFile实例用流、大小、错误码、原始文件名与 MIME 类型构建 PSR-7 上传文件Cookies / 查询参数 / 属性withCookieParams()/withQueryParams()/withAttribute()属性逐个写入保持路由等附加数据不丢失3.3createResponse()响应转换createResponse(Response $symfonyResponse): ResponseInterface的处理逻辑PsrHttpFactory.php状态码与状态文本来自Response::$statusTexts二进制文件响应BinaryFileResponse且响应头中没有Content-Range直接createStreamFromFile()文件路径避免整文件读入内存其余情况写入php://temp临时流StreamedResponse与BinaryFileResponse通过ob_start()输出缓冲逐段捕获sendContent()的内容普通响应则直接$stream-write($response-getContent())响应头逐一写入同样忽略非法头Cookies 被序列化为多个Set-Cookie头最后withProtocolVersion()保留 HTTP 协议版本。其中 BinaryFileResponse with Content-Range 走临时流分支正是 CHANGELOG 2.0.2 中修复内容的源码体现。四、PSR-7 → SymfonyHttpFoundationFactory的转换细节方向相反的 HttpFoundationFactory.php 提供两个方法均可选bool $streamed false参数对应 CHANGELOG 1.2.0 Added support for streamed responses 与 1.3.0 Added support for streamed requests。4.1createRequest()组装 Symfony 请求服务器参数从 PSR-7 URI 推导SERVER_NAME、SERVER_PORThttps默认 443否则 80、REQUEST_URI路径 查询串、QUERY_STRINGhttps时置HTTPSon方法写入REQUEST_METHOD最终array_replace($psrRequest-getServerParams(), $server)以 URI 推导值为准覆盖原始参数——这正是 2.0.1 Fix populating default port and headers 与 2.0.2 Fix populating server params from URI 修复的领域请求体streamedtrue时通过detach()移交流资源不整体读入内存否则__toString()一次性读取表单参数getParsedBody()仅当结果为数组时才作为请求体参数is_array($parsedBody) ? $parsedBody : []避免非数组解析结果污染$_POST语义上传文件递归把 PSR-7 上传文件转成 Symfony 的UploadedFile详见下方属性 / Cookies / 查询参数分别来自getAttributes()、getCookieParams()、getQueryParams()请求头通过$request-headers-add($psrRequest-getHeaders())整体注入。4.2 上传文件桥接Factory/UploadedFile.php仓库在 Factory/UploadedFile.php 中提供了一个继承自Symfony\Component\HttpFoundation\File\UploadedFile的桥接类对应 CHANGELOG 1.3.0 Fixed bridging UploadedFile objects构造函数接收 PSR-7 的UploadedFileInterface与一个临时路径回调HttpFoundationFactory默认用tempnam(sys_get_temp_dir(), symfony)生成若上传错误为UPLOAD_ERR_NO_FILE则路径留空若流的元数据 URI 不是字符串或并非真实上传文件is_uploaded_file()为假常见于测试环境则判定为 test 模式并先moveTo()到临时路径重写的move()方法在有效且非 test 模式时直接委托给$psrUploadedFile-moveTo()把移动文件的最终动作交还 PSR-7 实现并设置chmod(0o666 ~umask())。4.3createResponse()PSR-7 响应转回 Symfony先把Set-Cookie头从 PSR-7 响应中剥离随后通过Cookie::fromString()逐一还原为 Symfony 的Cookie对象并setCookie()对应 2.0.2 Create cookies as rawstreamedtrue时构造StreamedResponse回调内先rewind()若可 seek再按responseBufferMaxLength默认 16372 字节构造函数可配置分块echo $body-read()直到eof()实现流式输出非流式则用getBody()-__toString()构造普通Response最后setProtocolVersion()同步 HTTP 协议版本。五、控制器集成请求注入 响应自动转换CHANGELOG 2.1.0 一次性引入了两个关键集成点PsrResponseListener自动转换控制器返回的 PSR-7 响应与PsrServerRequestResolver允许向控制器注入 PSR-7 请求对象。它们让桥接从手动调用工厂升级为控制器零样板代码。5.1PsrServerRequestResolver参数注入该类实现的是 Symfony 6.2 引入的ValueResolverInterfaceCHANGELOG 2.3.0 记录并在 6.4 中移除了旧的ArgumentValueResolverInterface实现RemoveArgumentValueResolverInterfacefromPsrServerRequestResolver。源码中维护一张受支持类型表private const SUPPORTED_TYPES [ ServerRequestInterface::class true, RequestInterface::class true, MessageInterface::class true, ];resolve()方法在参数类型命中上述三者之一时yield $this-httpMessageFactory-createRequest($request)——即自动把当前 Symfony 请求交给HttpMessageFactoryInterface转换后注入控制器。仓库功能测试夹具 PsrRequestController.php 展示了三种典型用法// 注入最具体的 ServerRequestInterface public function serverRequestAction(ServerRequestInterface $request): ResponseInterface { return $this-responseFactory-createResponse() -withBody($this-streamFactory-createStream( sprintf(htmlbody%s/body/html, $request-getMethod()) )); } // 注入 RequestInterface读取方法与请求体 public function requestAction(RequestInterface $request): ResponseInterface { return $this-responseFactory-createResponse()-withStatus(403) -withBody($this-streamFactory-createStream( sprintf(htmlbody%s %s/body/html, $request-getMethod(), $request-getBody()-getContents()) )); } // 注入更宽泛的 MessageInterface读取请求头 public function messageAction(MessageInterface $request): ResponseInterface { return $this-responseFactory-createResponse()-withStatus(422) -withBody($this-streamFactory-createStream( sprintf(htmlbody%s/body/html, $request-getHeader(X-My-Header)[0]) )); }5.2PsrResponseListener响应自动转换PsrResponseListener订阅KernelEvents::VIEWPsrResponseListener.php当控制器返回值instanceof ResponseInterface时通过HttpFoundationFactoryInterface未注入时默认new HttpFoundationFactory()将其转为 Symfony 响应并setResponse()返回值不是 PSR-7 响应则直接放行。5.3 功能测试佐证仓库 ControllerTest.php 通过 WebTestCase 验证了完整链路GET /server-request→ 200响应体为GET注入ServerRequestInterfacePOST /request带some content请求体→ 403响应体为POST some content注入RequestInterface并读取流PUT /message带X-My-Header: some content→ 422响应体为some content注入MessageInterface并读取头。PsrResponseListenerTest.php 则单独验证控制器返回 PSR-7Response时事件被置入响应返回数组或null时不产生响应。六、版本演进时间线从 1.0.0 到 6.4CHANGELOG 完整记录了三个主要阶段的演进逐条展开如下6.1 1.x奠基与工厂化1.0.0 / 1.0.1 / 1.0.2初始发布支持 Symfony 4由 dunglas 贡献修复 PSR-7 Request 的 request target。1.1.0新增基于PSR-17 工厂创建 PSR-7 消息的能力——即PsrHttpFactory的核心思路不再依赖某个具体 PSR-7 实现类而是通过四个标准工厂接口构建消息。1.1.1弃用DiactorosFactory建议改用PsrHttpFactory此时尚不触发弃用告警。1.1.2修复createResponse。1.2.0最低 PHP 升至 7.1新增流式响应支持即HttpFoundationFactory::createResponse(..., true)的StreamedResponse分支补充文档链接。1.3.0最低 Symfony 升至 4.4、支持 Symfony 5.0新增流式请求支持createRequest(..., true)的detach()分支修复UploadedFile对象的桥接见上文 4.2。6.2 2.x契约升级与控制器集成2.0.0正式移除DiactorosFactoryPsrHttpFactory成为唯一入口。2.0.1不再规范化查询字符串PsrHttpFactory修复 HTTPS 请求的转换修复默认端口与请求头的填充HttpFoundationFactory。2.0.2修复HttpFoundationFactory从 URI 填充服务器参数Cookies 以 raw 形式创建修复带Content-Range的BinaryFileResponsePsrHttpFactory。2.1.0新增PsrResponseListener自动转换控制器返回的 PSR-7 响应与PsrServerRequestResolver向控制器注入 PSR-7 请求对象——详见本文第五节。2.1.2允许 Symfony 6。2.1.3创建 PSR-7 对象时忽略非法 HTTP 头修复传入moveTo()的错误类型。2.2.0放弃 Symfony 4最低 PHP 升至 7.2支持psr/http-message契约 v2。2.3.0利用Request::getPayload()填充 PSR-7 请求的解析后请求体实现 Symfony 6.2 引入的ValueResolverInterface。2.3.1不再依赖Request::getPayload()填充解析后请求体回归到基于 Content-Type 分支的解析策略见 3.2 的说明。6.3 6.4并入 monorepo 与生态化6.4Bridge 被导入 Symfony 官方 monorepo 并同步发布节奏从PsrServerRequestResolver移除ArgumentValueResolverInterface完全转向ValueResolverInterface支持php-http/discovery自动探测 PSR-17 工厂见 3.1并在 composer.json 中声明与php-http/discovery 1.15冲突。七、边界修复清单值得在集成时注意的细节把 CHANGELOG 中的修复条目整理为一张避坑清单每一条都能在源码或测试中找到对应实现修复条目版本涉及模块实战含义忽略非法 HTTP 头2.1.3两个工厂的withHeader()转换时遇到非法头名不会抛异常中断而是静默跳过不规范化查询字符串2.0.1PsrHttpFactory查询串原样保留避免被意外重写HTTPS 请求转换2.0.1HttpFoundationFactory从 URI scheme 推导SERVER_PORT与HTTPS标记默认端口与请求头填充2.0.1HttpFoundationFactoryhttps默认端口 443否则 80与请求头一起补全从 URI 填充服务器参数2.0.2HttpFoundationFactoryURI 推导值通过array_replace覆盖 PSR-7 原始 serverParamsCookies 以 raw 创建2.0.2HttpFoundationFactorySet-Cookie头通过Cookie::fromString()原样还原Content-Range的BinaryFileResponse2.0.2PsrHttpFactory带Content-Range时不再直接映射文件流改走临时流逐段发送修复传入moveTo()的类型2.1.3上传文件桥接moveTo()参数类型修正避免把目录当文件目标解析后请求体的两次调整2.3.0 / 2.3.1PsrHttpFactory::createRequest()JSON 请求用JSON_BIGINT_AS_STRING解码且仅接受数组其余回退表单参数八、升级路径与使用建议结合 CHANGELOG 与 composer.json 的约束给出几条可直接落地的实践建议老代码迁移若仍引用DiactorosFactory需要按 1.1.1 的弃用提示与 2.0.0 的移除动作统一迁移到PsrHttpFactory依赖 PSR-17 工厂接口不绑定具体实现。控制器风格统一在基于该 Bridge 的控制器中统一注入 PSR-7 请求 返回 PSR-7 响应由PsrServerRequestResolver与PsrResponseListener自动完成双向转换注意参数类型可以是ServerRequestInterface、RequestInterface或更宽的MessageInterface按需选择。流式场景大文件上传/下载优先开启streamed选项HttpFoundationFactory的流式请求用detach()、流式响应按 16372 字节分块输出避免整体载入内存。版本匹配当前仓库要求 PHP 8.4.1、psr/http-message ^1.0|^2.0、symfony/http-foundation ^7.4|^8.0若要使用 PSR-17 工厂自动发现需安装php-http/discovery且版本不低于 1.15。更详细的运行约束可查看仓库内的 composer.json 与 phpunit.xml.dist测试套件配置。总体而言该 Bridge 的价值在于它让 Symfony 应用既能在内部保留HttpFoundation的成熟生态又能与遵循 PSR-7/PSR-17 的中间件、客户端与框架自由互操作——双向工厂负责数据映射参数解析器与视图监听器负责把桥接能力无缝接入控制器层而 CHANGELOG 中每一次版本迭代都在收敛边界行为、升级契约并降低接入成本。赞分享后端Web框架【免费下载链接】symfonyThe Symfony PHP framework项目地址https://gitcode.com/GitHub_Trending/sy/symfony点击查看免费下载相关推荐ShowDoc 中的 PSR-7 HTTP 消息实战psr/http-message 消息头与流式消息体操作指南ShowDoc 中的 PSR 7 HTTP 消息实战psr/http message 消息头与流式消息体操作指南 导读 本文基于 ShowDoc 仓库内 ps文档知识库后端前端OpenCart 中的 PSR-7 接口契约psr/http-message 版本演进与 HTTP 消息接口体系解析OpenCart 中的 PSR 7 接口契约psr/http message 版本演进与 HTTP 消息接口体系解析 导读 本文围绕 OpenCart 仓库电商后端OpenCart 中的 PSR-7 标准psr/http-message 接口包全解与 HTTP 消息编程实战OpenCart 中的 PSR 7 标准psr/http message 接口包全解与 HTTP 消息编程实战 本篇技术指南围绕 OpenCart 仓库中随电商后端上一篇DeepSeek Harness 跨工作区会话恢复统一存储、工作区作用域与目录交接的完整实现解析下一篇PUBG罗技鼠标宏终极配置指南简单三步实现完美压枪创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考