概述
在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免费学习笔记（深入）”；
$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();
?>代码解释：
- $mysqli->set_charset("utf8");: 这是解决问题的核心。它确保了从数据库获取的数据以UTF-8编码传输到PHP，为json_encode提供了有效输入。
- json_encode($rows, JSON_UNESCAPED_UNICODE | JSON_PRETTY_PRINT);:
- 错误检查: 在写入文件之前，增加了对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.json\n"; } 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能够顺利工作。结合适当的错误处理和文件写入权限检查，可以构建健壮的数据导出功能。
