解决PHP中MySQLi查询结果写入JSON文件失败的字符集问题

本文探讨PHP中将MySQLi查询结果导出为JSON文件时遇到的常见问题，特别是fwrite无法写入或写入空文件的情况。核心解决方案在于通过$mysqli-youjiankuohaophpcnset_charset(“utf8”);正确设置数据库连接的字符集，以确保数据编码兼容json_encode，从而实现数据顺利导出。

概述

在web开发中，将数据库查询结果导出为json格式是一种常见需求，常用于api接口响应、数据缓存或文件导出。php结合mysqli扩展提供了强大的功能来实现这一目标。然而，开发者有时会遇到一个看似矛盾的问题：从数据库中获取的数据在php脚本中通过print_r等方式查看是正常的，但当尝试使用json_encode将其转换为json字符串并写入文件时，文件却为空、内容不完整或根本没有变化。这通常与字符编码问题有关。

问题描述与根源分析

设想以下场景：你正在尝试从MySQL数据库中查询数据，并将所有行转换为JSON格式，最终写入一个.json文件。你的代码可能如下所示：

<?php
// 假设 $mysqli 已经是一个有效的数据库连接对象
// $mysqli = new mysqli("localhost", "user", "password", "database");
// if ($mysqli->connect_error) {
//     die("连接失败: " . $mysqli->connect_error);
// }
$sth = mysqli_query($mysqli, "SELECT * FROM table");
$rows = array();
while($r = mysqli_fetch_assoc($sth)) {
$rows[] = $r;
}
// 打印 $rows 数组，显示数据是正确的
print_r($rows);
// 尝试将数据编码为JSON并写入文件
$fileobj = fopen("takeOutItems.json", 'w');
fwrite($fileobj, json_encode($rows));
fclose($fileobj);
$mysqli->close();
?>

在执行上述代码后，你可能会发现print_r($rows)能够正确地显示所有从数据库中取出的数据。然而，takeOutItems.json文件却没有任何内容更新，或者即使文件存在，其内容也是空的[]或包含非预期的乱码。

这个问题的核心根源在于字符编码不匹配。json_encode()函数在处理非UTF-8编码的数据时，如果遇到无效的UTF-8序列，它将无法正确编码，甚至会返回null或空字符串。当MySQL数据库中的数据（尤其是包含中文、特殊符号或其他非ASCII字符时）以某种编码存储，而PHP脚本与MySQLi连接时使用的字符集与数据实际编码不一致，或者与json_encode期望的UTF-8编码不一致时，就会出现这种问题。

解决方案：设置数据库连接字符集

解决此问题的关键在于确保PHP脚本与MySQL数据库之间的通信使用统一且兼容json_encode的字符集，即UTF-8。在执行任何查询之前，通过$mysqli->set_charset(“utf8”);方法明确设置数据库连接的字符集，可以有效解决这个问题。

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

小文AI论文

轻松解决论文写作难题，AI论文助您一键完成，仅需一杯咖啡时间，即可轻松问鼎学术高峰！

69

查看详情

$mysqli->set_charset(“utf8”); 的作用是告诉MySQLi驱动，后续与数据库的交互都将使用UTF-8编码进行。这样，从数据库中读取的数据将被正确地解码为UTF-8，json_encode就能顺利地处理这些数据。

修正后的代码示例

<?php
// 假设 $mysqli 已经是一个有效的数据库连接对象
// $mysqli = new mysqli("localhost", "user", "password", "database");
// if ($mysqli->connect_error) {
//     die("连接失败: " . $mysqli->connect_error);
// }
// 关键步骤：设置数据库连接的字符集为UTF-8
$mysqli->set_charset("utf8");
$sth = mysqli_query($mysqli, "SELECT * FROM table");
$rows = array();
while($r = mysqli_fetch_assoc($sth)) {
$rows[] = $r;
}
// 打印 $rows 数组，验证数据是否正确（此时应已是UTF-8编码）
print_r($rows);
// 将数据编码为JSON并写入文件
$json_output = json_encode($rows, JSON_UNESCAPED_UNICODE | JSON_PRETTY_PRINT); // 添加选项使中文不转码，并美化输出
if ($json_output === false) {
echo "JSON编码失败: " . json_last_error_msg();
} else {
$fileobj = fopen("takeOutItems.json", 'w');
if ($fileobj) {
fwrite($fileobj, $json_output);
fclose($fileobj);
echo "数据已成功写入 takeOutItems.json\n";
} else {
echo "无法打开文件 takeOutItems.json 进行写入，请检查文件权限。\n";
}
}
$mysqli->close();
?>

代码解释：

1. $mysqli->set_charset(“utf8”);: 这是解决问题的核心。它确保了从数据库获取的数据以UTF-8编码传输到PHP，为json_encode提供了有效输入。
2. json_encode($rows, JSON_UNESCAPED_UNICODE | JSON_PRETTY_PRINT);:
   • JSON_UNESCAPED_UNICODE：这个选项非常有用，它会阻止json_encode将多字节Unicode字符（如中文）转义为\uXXXX形式，使JSON文件更具可读性。
   • JSON_PRETTY_PRINT：这个选项会格式化输出的JSON字符串，使其带有缩进和换行，便于人工阅读。
3. 错误检查: 在写入文件之前，增加了对json_encode返回值的检查。如果json_encode返回false，意味着编码失败，json_last_error_msg()可以提供具体的错误信息，这对于调试非常关键。同时，也增加了文件打开失败的检查。

注意事项与最佳实践

1. 数据库和表字符集: 确保你的MySQL数据库、表以及字段本身的字符集也设置为UTF-8（例如utf8mb4是更好的选择，因为它支持更广泛的Unicode字符，包括Emoji）。虽然set_charset(“utf8”)可以处理连接层面的编码转换，但如果底层数据存储编码不一致，仍可能出现问题。
   • 创建数据库时：CREATE DATABASE mydb CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
   • 创建表时：CREATE TABLE mytable (id INT, name VARCHAR(255)) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
2. json_last_error() 和 json_last_error_msg(): 在使用json_encode()之后，始终检查其返回值。如果返回false或null，使用这两个函数可以获取详细的错误信息，帮助定位问题。
3. 文件写入权限: 确保PHP脚本对目标文件takeOutItems.json所在的目录具有写入权限。如果文件不存在，fopen(‘…’, ‘w’)会尝试创建它，这同样需要目录写入权限。
4. file_put_contents() 简化写入: 对于简单的文件写入操作，file_put_contents()函数可以替代fopen()、fwrite()和fclose()的组合，使代码更简洁：

   // ...
   $json_output = json_encode($rows, JSON_UNESCAPED_UNICODE | JSON_PRETTY_PRINT);
   if ($json_output !== false) {
   if (file_put_contents("takeOutItems.json", $json_output) !== false) {
   echo "数据已成功写入 takeOutItems.json\n";
   } else {
   echo "无法写入文件 takeOutItems.json，请检查文件权限。\n";
   }
   } else {
   echo "JSON编码失败: " . json_last_error_msg();
   }
   // ...

5. 大型数据集处理: 对于非常大的数据集，一次性将所有数据加载到内存并编码为JSON可能会消耗大量内存。在这种情况下，可以考虑分批处理数据，或者使用流式JSON库，将数据逐行写入文件，而不是一次性写入整个JSON字符串。

总结

当PHP中mysqli查询结果无法正确写入JSON文件时，最常见且隐蔽的原因是字符编码不匹配。通过在数据库连接建立后立即调用$mysqli->set_charset(“utf8”);，可以有效地解决这个问题，确保数据在PHP和MySQL之间以UTF-8编码正确传输，从而使json_encode能够顺利工作。结合适当的错误处理和文件写入权限检查，可以构建健壮的数据导出功能。