如何在 PHP 中正确生成嵌套数组格式的 JSON 响应

本文讲解如何将逗号分隔的字符串（如 “tag1,tag2,tag3”）转换为 JSON 数组格式（如 “tgas”: [“tag1”, “tag2”, “tag3”]），并通过 json_encode() 输出符合预期结构的响应。

如何在 PHP 中正确生成嵌套数组格式的 JSON 响应

在 PHP 开发中，尤其是构建 API 接口时，确保 JSON 响应结构准确至关重要。你当前的代码将 $tagsoutput（例如值为 “tag1,tag2,tag3”）直接赋给 ‘tgas’ 键，导致 JSON 输出为 “tgas”: “tag1,tag2,tag3” —— 这是一个字符串，而非所需数组。

要得到 {“tgas”: [“tag1”, “tag2”, “tag3”]}，关键在于：将原始字符串解析为 PHP 索引数组，再交由 json_encode() 序列化。PHP 提供了内置函数 explode() 完成这一转换：

 $title,
    ‘plot’      => strip_tags($description),
    ‘storline’  => strip_tags($storyline),
    ‘tgas’      => explode(‘,’, $tagsoutput) // ✅ 将字符串转为数组
);
$rt = json_encode($response, JSON_UNESCAPED_UNICODE); // 推荐使用 JSON_UNESCAPED_UNICODE 而非 true（后者非标准参数）

需要警惕的几个细节

代码写起来简单，但有几个坑很容易踩到。先说说最常见的：

• 关于 json_encode 的参数：代码里 `json_encode($response, true)` 中的 `true` 其实是个无效选项。json_encode() 的第二个参数应该是一个位掩码常量，比如 `JSON_UNESCAPED_UNICODE`。传入 `true` 在 PHP 8 之前会被静默忽略，之后则可能引发警告。所以，务必使用标准的标志常量。
• 处理脏数据：实际场景中，`$tagsoutput` 可能并不“干净”。比如它可能是空字符串，或者标签之间夹杂着空格（像 “tag1, tag2 , tag3”）。直接 `explode` 可能会生成 `[“tag1”, “”, “ tag2”]` 这样的结果，这显然不是我们想要的。这时候，就需要一点增强健壮性的处理：

  ‘tgas’ => array_map(‘trim’, array_filter(explode(‘,’, $tagsoutput), ‘strlen’))

  这行代码的作用是：先按逗号分割，然后过滤掉长度为0的空项，最后对每一项执行 `trim` 去除首尾空格。这样一来，输出就规整多了。

  立即学习“PHP免费学习笔记（深入）”；

• 别忘了错误处理：json_encode 并非总能成功。如果数据里包含了非法的 UTF-8 字符，它就会失败。所以，一个健壮的做法是始终检查编码结果：

  $rt = json_encode($response, JSON_UNESCAPED_UNICODE);
  if ($rt === false) {
      error_log(‘JSON encode error: ’ . json_last_error_msg());
      http_response_code(500);
      exit(json_encode([‘error’ => ‘Invalid data’]));
  }

  这样一来，一旦编码出错，服务端能记录日志，并给客户端返回一个明确的错误信息，而不是一个空白或者截断的响应。

最终的成果

经过上述修正，你的代码将输出严格符合要求的、结构清晰的 JSON：

{
  “title”: “Post Title”,
  “plot”: “Cleaned description”,
  “storline”: “Cleaned storyline”,
  “tgas”: [“tag1”, “tag2”, “tag3”]
}

这样的响应，类型准确无误，前端 Ja vaScript 拿到后，就可以放心地使用 `response.tgas.forEach(…)` 进行遍历操作了。说到底，处理好这些细节，才是保证前后端顺畅协作的关键。