使用json_encode()可将PHP数组或对象转为JSON，支持多维数组、对象及复杂结构，通过JSON_PRETTY_PRINT和JSON_UNESCAPED_UNICODE等参数优化输出格式与中文显示；写入文件时需确保目录有写权限，避免因权限不足导致失败；编码前应检查数据合法性，利用json_last_error_msg()捕获错误，推荐封装safe_json_encode()函数处理异常并记录日志，提升程序健壮性。
PHP生成JSON文件，简单来说，就是先把数据处理成PHP数组或对象，然后用
json_encode()函数转换成JSON字符串，最后写入文件。
将PHP数组或对象转换为JSON格式并保存到文件中。
如何使用json_encode()
处理复杂数据结构？
json_encode()可以处理多维数组、包含对象的数组、以及对象本身。关键在于理解
json_encode()的flags参数。例如，
JSON_PRETTY_PRINT可以使JSON输出更易读，
JSON_UNESCAPED_UNICODE可以避免中文乱码。
举个例子，假设你有一个包含用户信息的数组：
立即学习“PHP免费学习笔记（深入）”；
$users = [
[
'id' => 1,
'name' => '张三',
'email' => 'zhangsan@example.com'
],
[
'id' => 2,
'name' => '李四',
'email' => 'lisi@example.com'
]
];
$json_data = json_encode($users, JSON_PRETTY_PRINT | JSON_UNESCAPED_UNICODE);
if (file_put_contents('users.json', $json_data)) {
echo "JSON文件创建成功！";
} else {
echo "JSON文件创建失败！";
}这里，
JSON_PRETTY_PRINT让JSON输出有缩进，
JSON_UNESCAPED_UNICODE确保中文正常显示。如果你的数据包含特殊字符，可能还需要考虑
JSON_UNESCAPED_SLASHES。
如何处理JSON文件写入权限问题？
文件写入权限是个常见问题。首先，确认PHP进程（通常是web服务器的用户，如
www-data或
apache）对目标文件夹有写入权限。
你可以通过以下步骤排查：
-
检查目录权限： 使用
ls -l
命令查看目录权限。确保web服务器用户有写入权限（w
）。 -
修改目录权限： 如果没有写入权限，可以使用
chmod
命令修改。例如，chmod 777 /path/to/your/directory
（注意：777权限过于开放，生产环境不推荐，应根据实际情况设置）。 -
检查文件所有者： 确保目标文件夹的所有者是web服务器用户。可以使用
chown
命令修改。例如，chown www-data:www-data /path/to/your/directory
。
此外，如果你的程序运行在受限环境中（如Docker容器），可能需要检查容器的文件系统挂载配置，确保容器内的PHP进程有权访问宿主机上的目标文件夹。
如何优雅地处理JSON编码错误？
json_encode()在遇到无法编码的数据时，会返回
false。为了避免程序崩溃，应该检查返回值，并使用
json_last_error()和
json_last_error_msg()获取错误信息。
例如：
$data = ['循环引用'];
$data[] = &$data; // 创建循环引用
$json_data = json_encode($data);
if ($json_data === false) {
echo "JSON编码错误： " . json_last_error_msg() . "\n";
} else {
file_put_contents('data.json', $json_data);
}在这个例子中，我们故意创建了一个循环引用，
json_encode()无法处理，会返回
false。通过
json_last_error_msg()，我们可以得知错误原因是
Malformed UTF-8 characters, possibly incorrectly encoded(实际上是循环引用导致的)。
对于复杂的错误处理，你可以自定义一个函数，专门用于JSON编码，并记录错误日志：
function safe_json_encode($data, $options = 0) {
$json = json_encode($data, $options);
if ($json === false) {
error_log('JSON encoding error: ' . json_last_error_msg());
return null; // 或者抛出异常
}
return $json;
}
$json_data = safe_json_encode($my_data, JSON_UNESCAPED_UNICODE);这样，即使JSON编码失败，也不会影响程序的正常运行，并且错误信息会被记录下来，方便排查问题。
