PHP生成JSON数据文件操作教程

本文详解PHP中两种主流JSON处理场景：一是直接输出JSON响应给前端或API调用方，强调必须前置设置正确的Content-Type头、使用安全编码选项（如JSON_UNESCAPED_UNICODE）、严格避免BOM/空白输出，并校验json_encode返回值；二是生成临时JSON文件并强制浏览器下载，需配合attachment头、octet-stream类型及及时清理文件，同时警示勿混淆“下载”与“API响应”、禁用低效冗余的file_get_contents+echo方式；最后指出调试关键——用curl和DevTools精准验证响应头与JSON有效性，并特别提醒UTF-8编码统一是防止静默失败的核心前提。

PHP 直接输出 JSON 数据（不生成文件）

绝大多数场景下，你并不需要「生成并保存为 .json 文件」，而是让 PHP 脚本直接返回 JSON 响应给前端或 API 调用方。关键在于设置正确的响应头 + 正确编码数据。

常见错误是只调用 json_encode() 但没设 Content-Type: application/json，导致前端收到文本却解析失败，或浏览器直接下载/乱码。

• 必须调用 header('Content-Type: application/json; charset=utf-8')，且在任何输出前执行
• 推荐使用 json_encode($data, JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES) 避免中文转义、URL 斜杠被转义
• 务必检查 json_encode() 返回值是否为 false，可用 json_last_error_msg() 查错
• 不要在 echo json_encode(...) 前有空格、BOM 或 print/var_dump 等输出，否则响应头失效

header('Content-Type: application/json; charset=utf-8');
$data = ['name' => '张三', 'score' => 95];
echo json_encode($data, JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES);

PHP 生成物理 JSON 文件并强制下载

只有当明确需要用户点击下载一个 .json 文件（比如导出配置、备份数据），才走「写入文件 + 发送下载头」流程。注意：这不是 API 返回方式，而是文件交付行为。

容易踩的坑是混淆「下载」和「响应 JSON」——前者会触发浏览器保存对话框，后者是程序间通信。

• 先用 file_put_contents($filepath, $json_str) 写入文件（确保目录可写）
• 再用 header('Content-Disposition: attachment; filename="data.json"') 触发下载
• 必须搭配 header('Content-Type: application/octet-stream')，不能用 application/json，否则部分浏览器不弹下载框
• 下载后建议用 unlink($filepath) 清理临时文件，否则磁盘会被占满

$data = ['items' => [['id'=>1,'title'=>'A'], ['id'=>2,'title'=>'B']]];
$json_str = json_encode($data, JSON_UNESCAPED_UNICODE);
$filepath = sys_get_temp_dir() . '/export_' . time() . '.json';
file_put_contents($filepath, $json_str);

header('Content-Type: application/octet-stream');
header('Content-Disposition: attachment; filename="export.json"');
header('Content-Length: ' . filesize($filepath));
readfile($filepath);
unlink($filepath); // 立即删除

为什么不该用 file_get_contents + echo 返回 JSON 文件

有人想“先生成文件，再读出来 echo”，这完全多余，还引入 IO 开销和竞态风险（如文件被删、权限变、内容被改）。

典型错误写法：echo file_get_contents('output.json'); —— 它漏了响应头，且绕过 JSON 编码校验，一旦文件损坏或含 BOM，前端解析必崩。

• 若已存在合法 JSON 文件，应先 json_decode(file_get_contents($f), true) 校验有效性，再 json_encode() 输出
• 直接 readfile() + application/json 头仅适用于静态、可信、无需动态处理的场景（极少见）
• Web 服务器（如 Nginx）对 .json 后缀默认不执行 PHP，所以靠 URL 访问本地 .json 文件 ≠ 执行 PHP 逻辑

调试时如何确认返回的是有效 JSON

别依赖浏览器地址栏打开看——它可能渲染成 HTML 或触发下载。真实验证方式就两个：

• 用 curl -I http://your-site/api.php 检查响应头是否含 Content-Type: application/json
• 用 curl -s http://your-site/api.php | python3 -m json.tool（或 jq）验证格式是否合法；报错说明 json_encode() 出了问题（比如资源类型、循环引用、非 UTF-8 字符）
• Chrome DevTools 的 Network → Preview 标签页能直观显示解析后的 JSON 结构，比 Response 更可靠

最常被忽略的是字符编码：MySQL 查询结果、文件读取、XML 解析等来源的数据若含 GBK 或 Latin1 字符，json_encode() 会静默失败，必须提前转为 UTF-8。

以上就是《PHP生成JSON数据文件操作教程》的详细内容，更多关于的资料请关注golang学习网公众号！