Swoole request对象怎么获取POST参数-Swoole-PHP中文网

swoole中$request->post仅支持application/x-www-form-urlencoded和手动解析的json；multipart/form-data需用$request->files或rawcontent自行解析，且不支持点号、中括号嵌套键名。

swoole request对象怎么获取post参数

直接用 `$request->post`，但注意它不解析 multipart/form-data

在 Swoole HTTP Server 的 onRequest 回调中，$request 是 Swoole\Http\Request 实例，它的 post 属性是 array 类型，**仅对 application/x-www-form-urlencoded 和 application/json（需手动解析）生效**。如果前端发的是 multipart/form-data（比如带文件上传的表单），$request->post 会为空——这不是 bug，是设计如此。

常见错误现象：var_dump($request->post) 输出 array(0) {}，但 Postman 明明填了 key-value；原因多半是 Content-Type 被设成了 multipart/form-data 却没处理文件逻辑。

确认请求头：curl -H "Content-Type: application/x-www-form-urlencoded" -d "name=foo" http://127.0.0.1:9501 → $request->post['name'] 可取到
若 Content-Type 是 application/json，Swoole 不自动解析，需手动：json_decode($request->rawContent(), true)
multipart/form-data 场景必须走 $request->files + 自行解析 $request->rawContent()，或改用前端发 JSON / urlencoded

`$request->rawContent()` 是万能兜底，但别滥用

当 $request->post 拿不到数据时，第一反应不是改框架配置，而是看原始体：$request->rawContent() 返回完整请求体字符串（不含 header）。它适用于所有 Content-Type，但你要自己判断格式并解析。

对 application/json：直接 json_decode($request->rawContent(), true)，注意检查返回值是否为 null（可能 JSON 格式错）
对 application/x-www-form-urlencoded：可用 parse_str($request->rawContent(), $data)，结果存入 $data
对 multipart/form-data：原始体含 boundary，不能直接 parse_str；此时应优先用 $request->files 配合临时文件，或引入 nyholm/psr7 等工具解析
性能注意：$request->rawContent() 会把整个 body 加载进内存，大文件上传时慎用

POST 参数名含点号、中括号？Swoole 默认不支持

PHP 原生 $_POST 支持 user[name]、config.host 这类键名，会自动转成嵌套数组；但 Swoole 的 $request->post 是简单 key-value 映射，user[name] 会被当做一个完整字符串 key，不会解析结构。

Swoole 6.1.1

Swoole 6.1.1 是一个专为 PHP 设计的高性能事件驱动并发网络引擎。作为稳定版，它修复了编译时对 zlib 依赖的缺失及 curl 模块的内存安全风险。该版本支持协程、多线程与多进程架构，内置 TCP/HTTP/WebSocket 服务器，能够显著提升 PHP 在微服务、实时通信等场景下的执行效率与并发能力。

下载

如果前端必须传嵌套字段，要么改用 JSON 格式（Content-Type: application/json），后端统一 json_decode
要么前端改传扁平 key，如 user_name、user_email，后端再按约定组装
自行实现解析逻辑成本高且易出错，不推荐重写 parse_str 行为

调试时怎么快速确认 POST 数据在哪

别猜，用这几行代码直接看：

var_dump([
    'content_type' => $request->header['content-type'] ?? 'missing',
    'post' => $request->post,
    'raw' => $request->rawContent(),
    'files' => $request->files,
]);

输出结果一眼就能定位问题：content-type 是什么、post 是否为空、rawContent 里有没有数据、files 是否有上传项。很多“获取不到 POST 参数”的问题，其实只是前端发错了格式，或者 curl 忘加 -d。

真正复杂的是混合场景：比如同时有 JSON body 和文件上传——HTTP 协议本身不允许这样，必须二选一。这种需求得拆成两个接口，或者用 base64 编码文件内容塞进 JSON 字段里。