应通过PSR-17工厂接口创建PSR-7消息，而非硬编码new Laminas\Diactoros\Request()；需显式实例化Laminas\Diactoros\RequestFactory等工厂类，实现解耦、可测试与框架可迁移。
直接用 Laminas Diactoros 创建 PSR-7 消息，别 new Request() 硬编码
你不需要自己写一个 Request 类，也不该直接 new Laminas\Diactoros\Request() —— 这会把你锁死在具体实现上，破坏可测试性和框架迁移能力。Laminas Diactoros 同时实现了 PSR-7 和 PSR-17，意味着它既提供消息对象，也提供工厂接口，这才是合规用法。
- 硬编码
new Request()会导致单元测试必须 mock 具体类，而不是依赖Psr\Http\Message\RequestInterface - 如果将来切换到
nyholm/psr7或guzzlehttp/psr7，所有new调用都得重写 - 正确姿势是：通过 PSR-17 工厂接口创建实例，再由容器注入（或手动实例化）对应工厂实现
怎么实例化 Laminas Diactoros 的 PSR-17 工厂？
Laminas Diactoros 自带全套工厂类，但它们不是自动注册的——你得显式 new 它们，或者配 DI 容器。它不强制绑定工厂到容器，这点和 neos/http-factories 不同，但更轻量、无额外依赖。
-
new Laminas\Diactoros\RequestFactory()→ 实现Psr\Http\Message\RequestFactoryInterface -
new Laminas\Diactoros\ResponseFactory()→ 实现Psr\Http\Message\ResponseFactoryInterface -
new Laminas\Diactoros\UriFactory()→ 实现Psr\Http\Message\UriFactoryInterface -
new Laminas\Diactoros\StreamFactory()→ 实现Psr\Http\Message\StreamFactoryInterface
示例：
<?php use Laminas\Diactoros\RequestFactory;
use Laminas\Diactoros\UriFactory;
use Laminas\Diactoros\StreamFactory;
$requestFactory = new RequestFactory();
$uriFactory = new UriFactory();
$streamFactory = new StreamFactory();
$uri = $uriFactory->createUri('https://api.example.com');
$body = $streamFactory->createStream('{"id":123}');
$request = $requestFactory->createRequest('POST', $uri)
->withHeader('Content-Type', 'application/json')
->withBody($body);
?>
为什么不用 neos/http-factories？它和 Laminas Diactoros 工厂有啥区别？
两者都满足 PSR-17，但设计哲学不同：neos/http-factories 是「一站式工厂包」，开箱即用；而 Laminas\Diactoros 的工厂是「随核心包附带的可选组件」，更贴近“按需加载”原则。
-
neos/http-factories把所有工厂封装在一个包里，适合快速启动、不想深究实现细节的项目 -
Laminas\Diactoros工厂与消息类共用同一命名空间和版本周期，升级时行为一致性更高，适合对依赖收敛敏感的企业项目 - 性能几乎无差别，但
Laminas\Diactoros在 ServerRequest 构建上更成熟（比如原生支持php://input解析和上传文件元数据） - 如果你已在用
laminas/diactoros处理响应/请求，再引入neos/http-factories属于冗余依赖
常见错误：调用 withXxx() 后忘记赋值，导致状态丢失
PSR-7 对象全部不可变，withHeader()、withBody()、withStatus() 等方法返回的是新实例，原变量不会被修改 —— 这是最容易漏掉的坑，尤其从 Laravel 或 Symfony 的可变 Response 习惯转过来的人。
- 错误写法：
$request->withHeader('X-Trace', 'abc');→ 返回值没接住，header 没生效 - 正确写法：
$request = $request->withHeader('X-Trace', 'abc'); - PHPStan 或 Psalm 可以检测这类未使用返回值的问题，建议开启
checkUnusedReturnValue - 别试图继承
Laminas\Diactoros\Request并改成可变 —— 违反 PSR-7 合规性，下游中间件（如 PSR-15）可能出错
Laminas Diactoros 的工厂不是“语法糖”，它是解耦的关键一环；而不可变性也不是限制，是让 HTTP 消息流转更可预测的约束。这两点，稍不注意就会在调试时多花半小时。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
