在Web开发中，前后端数据交互是非常常见的需求，PHP作为后端语言处理完业务逻辑后，往往需要把数据传递给前端的JavaScript使用，json_encode就是实现这种跨端传值的核心工具之一。
一、json_encode的基本作用
json_encode是PHP的内置函数，主要功能是将PHP的变量（比如数组、对象、字符串、数值等）转换为JSON格式的字符串。JSON是一种轻量级的数据交换格式，前端JavaScript原生支持解析，因此非常适合作为前后端数据传递的中间格式。
比如PHP中有一个关联数组，使用json_encode处理后就会变成符合JSON规范的字符串，方便后续传递到前端。
二、PHP端使用json_encode编码数据
首先我们需要在PHP端准备好要传递的数据，然后调用json_encode进行编码。下面是一个简单的示例，假设我们要传递一个包含用户信息的数组：
<?php
// 准备要传递的PHP数组数据
$userInfo = [
'name' => '张三',
'age' => 25,
'hobby' => ['读书', '跑步', '编程']
];
// 使用json_encode编码为JSON字符串
$jsonStr = json_encode($userInfo, JSON_UNESCAPED_UNICODE);
// 输出JSON字符串，前端可以通过脚本接收
echo $jsonStr;
?>
这里需要注意，json_encode的第二个参数JSON_UNESCAPED_UNICODE的作用是让中文不被转义为Unicode编码，保证前端拿到的是可读的中文内容，如果没有这个参数，中文会变成类似u5f20u4e09的格式。
三、前端JS接收并解析JSON数据
PHP端输出JSON字符串后，前端可以通过多种方式接收，常见的方式有两种：一种是通过PHP直接把JSON字符串赋值给JS变量，另一种是通过AJAX请求获取PHP返回的JSON数据。
方式1：PHP直接赋值给JS变量
如果是页面加载时就需要的数据，可以直接在PHP模板中把编码后的JSON字符串赋值给JS变量：
<!DOCTYPE html>
<html lang="zh-CN">
<head>
<meta charset="UTF-8">
<title>跨端传值示例</title>
</head>
<body>
<script type="text/javascript">
// 直接接收PHP输出的JSON字符串并解析
var jsonStr = '<?php echo $jsonStr; ?>';
var userInfo = JSON.parse(jsonStr);
console.log(userInfo.name); // 输出：张三
console.log(userInfo.hobby); // 输出：["读书", "跑步", "编程"]
</script>
</body>
</html>
方式2：通过AJAX请求获取
如果是需要动态获取的数据，可以通过AJAX请求PHP接口拿到JSON数据：
// 使用fetch发起AJAX请求
fetch('get_user.php')
.then(response => response.json())
.then(data => {
console.log('用户年龄：', data.age); // 输出：25
console.log('用户爱好：', data.hobby);
})
.catch(error => {
console.error('请求出错：', error);
});
这里PHP端的get_user.php只需要输出json_encode后的结果即可，不需要额外输出其他内容，否则会导致JSON解析失败。
四、注意事项
- PHP端输出JSON数据时，不要输出任何其他内容，比如HTML标签、空格、换行等，否则前端解析JSON会报错。
- 如果传递的数据中包含特殊字符，比如引号、斜杠等，json_encode会自动进行转义，前端解析时不需要额外处理。
- 当传递的数据量较大时，建议对JSON字符串进行压缩，减少传输带宽，不过一般情况下json_encode的性能已经足够满足需求。
- 如果PHP端返回的是JSON格式数据，也可以在响应头中设置
Content-Type: application/json，这样前端使用fetch等工具时可以直接通过response.json()解析，不需要手动调用JSON.parse。
通过上述步骤，就可以轻松实现PHP数据通过json_encode传递到JS中，完成跨端传值的需求，这种方式简单高效，是前后端数据交互的常用方案。
PHPJavaScriptjson_encode跨端传值修改时间：2026-07-06 06:51:19