Slim 4 默认不自动解析请求体，需显式启用 addBodyParsingMiddleware() 才能通过 getParsedBody() 正确获取 JSON、x-www-form-urlencoded 或表单数据。
slim 4 默认不自动解析请求体，需显式启用 `addbodyparsingmiddleware()` 才能通过 `getparsedbody()` 正确获取 json、x-www-form-urlencoded 或表单数据。
在 Slim 4 中，$request->getParsedBody() 返回 null 是一个常见但容易被误解的问题。其根本原因在于：Slim 4 不再像 Slim 3 那样默认注册请求体解析中间件。这意味着即使你发送了合法的 Content-Type: application/json 请求，框架也不会自动将原始请求体（raw body）解析为 PHP 数组或对象——除非你主动启用对应中间件。
✅ 正确做法：启用 Body Parsing 中间件
只需在创建应用后、定义路由前调用 $app->addBodyParsingMiddleware()：
<?php
use Psr\Http\Message\ResponseInterface as Response;
use Psr\Http\Message\ServerRequestInterface as Request;
use Slim\Factory\AppFactory;
require __DIR__ . '/../vendor/autoload.php';
$app = AppFactory::create();
$app->addErrorMiddleware(true, false, false);
// ? 关键一步：启用请求体自动解析
$app->addBodyParsingMiddleware();
$app->post('/add', function (Request $request, Response $response, array $args) {
$data = $request->getParsedBody(); // ✅ 现在可正确获取 ['name' => 'test', 'email' => '...']
if ($data === null) {
$response->getBody()->write(json_encode(['error' => 'Invalid or missing request body']));
return $response->withStatus(400)->withHeader('Content-Type', 'application/json');
}
// 示例：返回解析后的数据
$response->getBody()->write(json_encode(['received' => $data]));
return $response->withHeader('Content-Type', 'application/json');
});
$app->run();? 支持的 Content-Type 类型
该中间件默认支持以下三种常见格式：
- application/json → 解析为关联数组（json_decode($body, true)）
- application/x-www-form-urlencoded → 解析为 $_POST 类似结构
- multipart/form-data → 不支持（需自行处理文件上传等场景）
⚠️ 注意：multipart/form-data 不会被 addBodyParsingMiddleware() 解析（因涉及文件流），如需处理表单上传，请使用 $_FILES 或专用上传库（如 slim/php-view + 自定义解析逻辑）。
? 调试建议
若仍返回 null，请依次检查：
- 请求头中 Content-Type 是否拼写正确（如 application/json，而非 text/json）；
- 请求体是否为合法 JSON（无语法错误、编码为 UTF-8）；
- 是否在 addBodyParsingMiddleware() 之后才注册路由（顺序不可颠倒）；
- 使用 file_get_contents('php://input') 手动读取原始体，确认数据已送达服务器。
✅ 总结
| 问题现象 | 根本原因 | 解决方案 |
|---|---|---|
| $request->getParsedBody() 恒为 null | Slim 4 默认禁用自动解析 | 在 $app 实例上显式调用 $app->addBodyParsingMiddleware() |
启用该中间件是 Slim 4 处理标准 POST 数据的必要且最小代价配置，无需额外依赖或复杂封装。掌握这一机制，可确保 API 接口稳定兼容前端各类请求方式。
