本文探讨PHP中将MySQLi查询结果导出为JSON文件时遇到的常见问题，特别是fwrite无法写入或写入空文件的情况。核心解决方案在于通过$mysqli->set_charset(“utf8”);正确设置数据库连接的字符集，以确保数据编码兼容json_encode，从而实现数据顺利导出。
概述
在web开发中，将数据库查询结果导出为json格式是一种常见需求，常用于api接口响应、数据缓存或文件导出。php结合mysqli扩展提供了强大的功能来实现这一目标。然而，开发者有时会遇到一个看似矛盾的问题：从数据库中获取的数据在php脚本中通过print_r等方式查看是正常的，但当尝试使用json_encode将其转换为json字符串并写入文件时，文件却为空、内容不完整或根本没有变化。这通常与字符编码问题有关。
问题描述与根源分析
设想以下场景：你正在尝试从MySQL数据库中查询数据，并将所有行转换为JSON格式，最终写入一个.json文件。你的代码可能如下所示：
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免费学习笔记（深入）”；
$mysqli->set_charset(“utf8”); 的作用是告诉MySQLi驱动，后续与数据库的交互都将使用UTF-8编码进行。这样，从数据库中读取的数据将被正确地解码为UTF-8，json_encode就能顺利地处理这些数据。
修正后的代码示例
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.jsonn"; } else { echo "无法打开文件 takeOutItems.json 进行写入，请检查文件权限。n"; }}$mysqli->close();?>
代码解释：
$mysqli->set_charset(“utf8”);: 这是解决问题的核心。它确保了从数据库获取的数据以UTF-8编码传输到PHP，为json_encode提供了有效输入。json_encode($rows, JSON_UNESCAPED_UNICODE | JSON_PRETTY_PRINT);:JSON_UNESCAPED_UNICODE：这个选项非常有用，它会阻止json_encode将多字节Unicode字符（如中文）转义为uXXXX形式，使JSON文件更具可读性。JSON_PRETTY_PRINT：这个选项会格式化输出的JSON字符串，使其带有缩进和换行，便于人工阅读。错误检查: 在写入文件之前，增加了对json_encode返回值的检查。如果json_encode返回false，意味着编码失败，json_last_error_msg()可以提供具体的错误信息，这对于调试非常关键。同时，也增加了文件打开失败的检查。
注意事项与最佳实践
数据库和表字符集: 确保你的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;json_last_error() 和 json_last_error_msg(): 在使用json_encode()之后，始终检查其返回值。如果返回false或null，使用这两个函数可以获取详细的错误信息，帮助定位问题。文件写入权限: 确保PHP脚本对目标文件takeOutItems.json所在的目录具有写入权限。如果文件不存在，fopen(‘…’, ‘w’)会尝试创建它，这同样需要目录写入权限。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.jsonn"; } else { echo "无法写入文件 takeOutItems.json，请检查文件权限。n"; }} else { echo "JSON编码失败: " . json_last_error_msg();}// ...
大型数据集处理: 对于非常大的数据集，一次性将所有数据加载到内存并编码为JSON可能会消耗大量内存。在这种情况下，可以考虑分批处理数据，或者使用流式JSON库，将数据逐行写入文件，而不是一次性写入整个JSON字符串。
总结
当PHP中mysqli查询结果无法正确写入JSON文件时，最常见且隐蔽的原因是字符编码不匹配。通过在数据库连接建立后立即调用$mysqli->set_charset(“utf8”);，可以有效地解决这个问题，确保数据在PHP和MySQL之间以UTF-8编码正确传输，从而使json_encode能够顺利工作。结合适当的错误处理和文件写入权限检查，可以构建健壮的数据导出功能。
以上就是解决PHP中MySQLi查询结果写入JSON文件失败的字符集问题的详细内容，更多请关注php中文网其它相关文章！
版权声明：本文内容由互联网用户自发贡献，该文观点仅代表作者本人。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。
如发现本站有涉嫌抄袭侵权/违法违规的内容， 请发送邮件至 chuangxiangniao@163.com 举报，一经查实，本站将立刻删除。
发布者：程序猿，转转请注明出处：https://www.chuangxiangniao.com/p/1322767.html
微信扫一扫 
支付宝扫一扫 
