本文详解如何使用 php pdo 正确将 mysql 查询结果转换为符合预期结构的 json 数据，重点解决数组嵌套错误、重复键名及混合索引等问题，并提供两种简洁可靠的实现方式。
本文详解如何使用 php pdo 正确将 mysql 查询结果转换为符合预期结构的 json 数据，重点解决数组嵌套错误、重复键名及混合索引等问题，并提供两种简洁可靠的实现方式。
在 Web API 开发或前后端分离场景中，常需将 MySQL 查询结果以标准 JSON 格式返回（例如 {"movies": [{"name":"5"}, {"name":"The Matrix"}]}）。但初学者常因 PHP 数组操作不当或 PDO 取值模式配置缺失，导致输出结构混乱——如出现冗余数字键、null 值或对象/关联数组混杂，最终 JSON 不可被前端正常解析。
? 问题根源分析
原始代码存在三处关键错误：
Python v2.4 中文手册 chm
下载
Python v2.4版chm格式的中文手册，内容丰富全面，不但是一本手册，你完全可以把她作为一本Python的入门教程，教你如何使用Python解释器、流程控制、数据结构、模板、输入和输出、错误和异常、类和标准库详解等方面的知识技巧。同时后附的手册可以方便你的查询。
- array_push($data, $isonformat)：变量 $isonformat 未定义，且误将单条记录反复推入顶层数组；
- $data['movies'] = $result 每次覆盖而非追加，最终只保留最后一条记录；
- 缺少 PDO 取值模式设置，导致 foreach ($row as $result) 返回同时含数字索引和关联键的混合数组（如 ["name"=>"5", 0=>"5"]），JSON 化后产生冗余字段。
✅ 正确实现方案
方案一：循环追加（推荐用于大数据量或需逐条处理）
// 设置默认取值模式：仅返回关联数组（更直观）或对象（更面向对象）
$dbconnection->setAttribute(PDO::ATTR_DEFAULT_FETCH_MODE, PDO::FETCH_ASSOC);
$stmt = $dbconnection->prepare("SELECT name FROM fa");
$stmt->execute();
$data = ['movies' => []]; // 预定义空数组，语义清晰
foreach ($stmt as $row) {
$data['movies'][] = $row; // 使用 [] 自动追加，避免覆盖
}
echo json_encode($data, JSON_UNESCAPED_UNICODE | JSON_PRETTY_PRINT);✅ 输出示例：
{
"movies": [
{"name": "5"},
{"name": "Inception"},
{"name": "Interstellar"}
]
}方案二：一次性获取（简洁高效，适用于中小数据集）
$dbconnection->setAttribute(PDO::ATTR_DEFAULT_FETCH_MODE, PDO::FETCH_ASSOC);
$stmt = $dbconnection->prepare("SELECT name FROM fa");
$stmt->execute();
$data = [
'movies' => $stmt->fetchAll() // 直接获取全部结果集
];
echo json_encode($data, JSON_UNESCAPED_UNICODE | JSON_PRETTY_PRINT);⚠️ 关键注意事项
- 务必设置 PDO::ATTR_DEFAULT_FETCH_MODE：建议在数据库连接初始化时统一配置（如 $pdo->setAttribute(PDO::ATTR_DEFAULT_FETCH_MODE, PDO::FETCH_ASSOC);），避免后续每处查询重复设置；
- 避免 JSON_NUMERIC_CHECK 的误用：若字段含数字字符串（如 "007"），默认 JSON 编码会转为整数 7，需确保业务允许；
-
安全增强：生产环境应捕获异常并禁止直接输出敏感错误信息：
try { $stmt->execute(); echo json_encode(['success' => true, 'data' => $data]); } catch (PDOException $e) { http_response_code(500); echo json_encode(['success' => false, 'error' => 'Database error']); } - 字符编码一致性：确保 MySQL 连接、表、PHP 文件均为 UTF-8，防止中文乱码（可在 PDO DSN 中添加 charset=utf8mb4）。
? 总结
生成规范 JSON 的核心在于：明确数据结构层级 + 统一取值模式 + 合理使用数组语法。优先采用 FETCH_ASSOC 获取关联数组，并通过 $array['key'][] = $value 实现自然追加；对简单场景，fetchAll() 可极大简化代码。遵循这些实践，即可稳定输出前端可信赖的 JSON 接口数据。
