本文详解如何使用 json_encode() 将带键名的 PHP 多维数组（如数据库查询结果）无缝转为 JavaScript 可用的原生对象数组，避免手动拼接字符串导致的语法错误与 XSS 风险。
本文详解如何使用 json_encode() 将带键名的 php 多维数组（如数据库查询结果）无缝转为 javascript 可用的原生对象数组，避免手动拼接字符串导致的语法错误与 xss 风险。
在 PHP 与前端 JavaScript 协同开发中，常需将服务端数据（尤其是从数据库获取的关联数组）传递给前端进行动态渲染或交互处理。初学者易尝试用 implode() 拼接多维数组——但这是根本性误区：implode() 仅适用于一维索引数组，对关联数组或嵌套结构完全无效，强行使用会导致 PHP 输出非法 JSON 格式，进而引发 JavaScript 解析失败、控制台报错（如 Uncaught SyntaxError: Unexpected token {）或页面脚本中断。
正确且推荐的方式是使用 PHP 内置函数 json_encode()。它能递归序列化任意深度的关联/索引数组（包括含中文、特殊字符、null 值等），生成符合 ECMAScript 标准的 JSON 字符串，并自动处理引号转义、编码安全等问题。例如，修正你原始代码中的语法错误（注意：原问题代码中存在括号不匹配：),'name'=>... 应为 ,'name'=>$row["name"]）后，可这样安全导出：
<?php
$template = [];
foreach ($results as $row) {
$template[] = [
'Id' => $row['Id'],
'Address' => $row['Addr'],
'name' => $row['name']
];
}
?>
<script>
var theJSTemplateArray = <?php echo json_encode($template, JSON_UNESCAPED_UNICODE | JSON_HEX_TAG); ?>;
</script>✅ 关键说明：
-
JSON_UNESCAPED_UNICODE确保中文等 Unicode 字符不被编码为\uXXXX，提升可读性与调试便利性； -
JSON_HEX_TAG（可选）对、<code>>等 HTML 敏感字符进行十六进制转义，增强 XSS 防护（尤其当数据可能被 innerHTML 渲染时）； -
务必省略外层引号：
<?php echo json_encode(...) ?>直接输出 JS 字面量（如[{"Id":1,"Address":"Beijing","name":"Alice"}]），而非字符串，否则 JS 会将其识别为字符串而非数组。
在 JavaScript 中，该变量即为原生数组对象，可直接遍历访问：
立即学习“PHP免费学习笔记（深入）”；
theJSTemplateArray.forEach((item, index) => {
console.log(`Item ${index + 1}: ID=${item.Id}, Address=${item.Address}, Name=${item.name}`);
});
// 或传统 for 循环（兼容性更广）
for (let i = 0; i < theJSTemplateArray.length; i++) {
const { Id, Address, name } = theJSTemplateArray[i]; // 解构赋值
console.log(`ID: ${Id}, 地址: ${Address}, 姓名: ${name}`);
}⚠️ 注意事项：
- 确保
$results数据已正确初始化且非null；若为空数组，json_encode([])会输出[]，JS 中仍为合法空数组，无需额外判空； - 若 PHP 数组含资源（resource）、闭包（Closure）或循环引用，
json_encode()会返回false，建议添加容错：$jsData = json_encode($template); if ($jsData === false) { error_log('JSON encode failed: ' . json_last_error_msg()); $jsData = '[]'; } echo "<script>var theJSTemplateArray = {$jsData};</script>"; - 不要将
json_encode()输出直接插入 HTML 属性或内联事件中（如<div data-json="<?php echo json_encode($arr); ?>">），应优先使用 <code>data-*属性配合JSON.parse()，或改用datasetAPI。综上，
json_encode()是 PHP → JavaScript 多维数据传递的黄金标准——它简洁、安全、标准兼容，并天然支持键名保留与复杂类型映射。摒弃字符串拼接思维，拥抱 JSON 标准，是构建健壮前后端数据通道的第一步。
