PHP数组转JSON文件需三步：编码（json_encode加JSON_UNESCAPED_UNICODE和JSON_PRETTY_PRINT）、验证（检查返回值是否false）、写入（file_put_contents并确认路径权限与返回值），缺一不可。
PHP数组转JSON文件不能只靠 json_encode 生成字符串就完事——它不自动写入文件，也不处理编码、格式、错误等实际问题。
为什么 json_encode 生成的不是“JSON文件”？
json_encode 只返回一个 JSON 格式的字符串，不是文件。要变成文件，必须显式调用写入操作（如 file_put_contents）。常见错误是只打印或返回字符串，却没保存到磁盘。
- 直接
echo json_encode($arr)→ 浏览器看到的是内容，但服务器上没生成任何文件 - 忽略返回值：若
json_encode失败（比如含资源、循环引用），会返回false，不检查就写入会导致空文件或乱码 - 中文默认被转成 Unicode（如
\u4f60\u597d），不加JSON_UNESCAPED_UNICODE选项，文件可读性差
正确保存数组为 JSON 文件的三步操作
核心是：编码 → 验证 → 写入。缺一不可。
- 用
json_encode($arr, JSON_UNESCAPED_UNICODE | JSON_PRETTY_PRINT)保证中文可读、结构清晰（JSON_PRETTY_PRINT非必需，但调试时强烈建议） - 判断返回值：
if ($json === false) { trigger_error('JSON encode failed: ' . json_last_error_msg(), E_USER_WARNING); } - 写入文件：
file_put_contents('/path/to/data.json', $json)；注意路径需有写权限，目录存在，且返回值应检查是否等于字符串长度（写入失败可能静默返回false）
常见报错和对应处理
以下错误大多源于数据本身，而非函数调用方式：
立即学习“PHP免费学习笔记（深入）”；
-
Warning: json_encode(): type is not supported→ 数组里混入了资源（如mysqli对象）、闭包、SimpleXML实例。先用array_walk_recursive过滤或转换 - 写入后文件为空 → 检查
json_encode是否返回false，再确认file_put_contents是否因权限/路径问题失败（返回false或0） - JSON 文件打开显示乱码 → 确保文件以 UTF-8 无 BOM 编码保存；PHP 脚本自身也应是 UTF-8；避免在数组值中混入 GBK 字符串
要不要用 fopen + fwrite 替代 file_put_contents？
一般不用。除非你需要追加内容、控制锁机制或分块写入大数组。file_put_contents 更简洁安全，它默认使用 LOCK_EX（加独占锁），并发写入时不会覆盖。如果真要用 fopen，务必手动加锁并检查 fwrite 返回字节数是否匹配：
if (($fp = fopen($file, 'c')) !== false && flock($fp, LOCK_EX)) {
ftruncate($fp, 0);
if (fwrite($fp, $json) !== strlen($json)) {
trigger_error('Partial write to JSON file', E_USER_WARNING);
}
flock($fp, LOCK_UN);
fclose($fp);
}
真正容易被忽略的点是：JSON 文件的生成不是一次性的“转换动作”，而是涉及数据合法性、字符编码、磁盘权限、错误反馈四个层面的协同。少检查任意一环，都可能让脚本看似成功，实则输出无效文件。
