本文详解如何在 PHP 中通过 HTTP POST 正确传递 JSON 格式的嵌套对象参数（如 data 字段为关联数组），避免因错误使用 http_build_query 或冗余 JSON 编解码导致参数丢失。
本文详解如何在 php 中通过 http post 正确传递 json 格式的嵌套对象参数（如 `data` 字段为关联数组），避免因错误使用 `http_build_query` 或冗余 json 编解码导致参数丢失。
在调用第三方 API 时，若文档明确要求某个参数（例如 data）的值必须是 JSON 对象（而非 URL 编码字符串），则必须确保整个请求体以 application/json 格式发送，且该对象作为顶层 JSON 的一部分被序列化——而非拼入 x-www-form-urlencoded 表单数据中。
你原始代码的问题在于：
✅ 正确构建了 $myWORK 关联数组；
❌ 错误地将整个 $data 数组用 http_build_query() 编码为表单格式，导致嵌套数组（$myWORK）被扁平化或丢弃（PHP 默认将数组转为空字符串或 Array 字符串）；
❌ 多余调用 json_decode(json_encode($myWORK)) —— 这既无必要，又在 http_build_query 场景下完全无效（因为 http_build_query 不会递归序列化对象）。
✅ 正确做法是：
- 构建包含嵌套数组的 $data（无需额外转换）；
- 使用 json_encode($data) 将其整体转为 JSON 字符串；
- 设置请求头 Content-Type: application/json；
- 使用 file_get_contents() + stream_context_create() 发送原生 JSON 请求。
以下是修正后的完整示例：
<?php
$myWORK = [
'Email' => 'MY_EMAIL',
'URL' => 'REPOSITORY_URL',
];
$url = 'https://api.xxxxxxx.com/';
$data = [
'key' => 'MY_API_KEY',
'base' => 'MY_TOKEN',
'data' => $myWORK, // 直接嵌入关联数组，无需 json_decode/json_encode 转换
];
$options = [
'http' => [
'method' => 'POST',
'header' => "Content-Type: application/json\r\n",
'content' => json_encode($data), // 整体 JSON 编码
]
];
$context = stream_context_create($options);
$result = file_get_contents($url, false, $context);
if ($result === false) {
throw new RuntimeException('API request failed: ' . error_get_last()['message']);
}
$response = json_decode($result, true);
print_r($response);
?>⚠️ 关键注意事项：
- 不要混用编码方式：application/x-www-form-urlencoded 仅支持扁平键值对，无法保留嵌套结构；application/json 才能完整传递对象/数组层次；
- 避免冗余转换：json_decode(json_encode($arr)) 在此场景下既不必要，也不解决根本问题——它生成的是 PHP 对象，而 http_build_query 仍会将其转为无效字符串；
- 检查 API 文档：确认是否要求 data 字段为纯 JSON 字符串（需二次编码）还是直接作为 JSON 对象字段（推荐本方案）；少数接口可能要求 data 值本身是 JSON 字符串（即 'data' => json_encode($myWORK)），此时需按文档调整；
- 调试建议：用 echo json_encode($data, JSON_PRETTY_PRINT); 预览实际发送内容，确保结构符合预期。
总结：传递嵌套对象的核心在于 匹配 Content-Type 与序列化方式。选择 application/json + json_encode() 是现代 REST API 的标准实践，简洁、可靠且语义清晰。
