php强制浏览器下载json需设置content-type、content-disposition等响应头并清除前置输出,示例代码包含utf-8中文不转义和防缓存头。

PHP 直接输出 JSON 并触发浏览器下载
要让 PHP 返回 JSON 数据并强制浏览器弹出「另存为」对话框(即下载文件),关键不是只 echo json_encode(...),而是必须设置正确的 HTTP 响应头,告诉浏览器这不是要渲染的页面内容,而是一个待下载的文件。
- 必须设置
Content-Type: application/json(语义正确)或更通用的application/octet-stream(兼容性更强) - 必须设置
Content-Disposition: attachment; filename="data.json",其中filename建议用英文或 URL 编码,避免中文乱码或截断 - 建议加上
Content-Transfer-Encoding: binary和Expires: 0防止缓存干扰下载 - 输出前确保无任何输出(包括空格、BOM、
echo、var_dump),否则 headers 已发送会报错Cannot modify header information
完整可运行的 PHP 下载 JSON 示例
以下代码可直接放入 download.php 中使用,支持 GET 参数传数据或固定内容:
<?php
header('Content-Type: application/json; charset=utf-8');
header('Content-Disposition: attachment; filename="export.json"');
header('Content-Transfer-Encoding: binary');
header('Expires: 0');
header('Cache-Control: must-revalidate, post-check=0, pre-check=0');
header('Pragma: public');
$data = [
'name' => '张三',
'score' => 95,
'tags' => ['php', 'json', 'download']
];
echo json_encode($data, JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES);
?>
注意:JSON_UNESCAPED_UNICODE 保证中文不转义成 \uXXXX;JSON_UNESCAPED_SLASHES 避免斜杠被转义,提升可读性。若需兼容旧版 PHP(
常见失败原因:中文文件名乱码或下载失败
浏览器对 Content-Disposition 中的中文 filename 支持不一。Chrome / Edge 支持 filename*=UTF-8''xxx.json,但 IE 和部分旧 Safari 不认。稳妥做法是避开中文文件名:
立即学习“PHP免费学习笔记(深入)”;
- 用英文命名:如
filename="user_data.json" - 若必须中文,可尝试双写:
header('Content-Disposition: attachment; filename="data.json"; filename*=UTF-8\'\'%E6%95%B0%E6%8D%AE.json');,但实际兼容性差,不推荐生产环境依赖 - 更可靠的方式:服务端生成唯一英文文件名(如
export_202405201423.json),前端通过 API 响应头或额外接口查原始名称
用 cURL 或 AJAX 调用时无法触发下载?
这是正常现象——浏览器只对直接导航(如 <a href="download.php"></a>)或表单提交(target="_blank")自动触发下载。如果用 fetch 或 $.ajax 请求,响应体不会自动下载,需手动处理:
- 用
fetch获取 Blob,再创建 URL 下载:URL.createObjectURL(new Blob([response], {type: 'application/json'})) - 后端改用
Content-Type: text/plain+Content-Disposition有时反而更稳(尤其在某些代理或 CDN 环境下) - 如果必须走 Ajax 流程,别省略
responseType: 'blob',否则 JSON 字符串会被当作文本解析,丢失二进制完整性
最简验证方式永远是:把 PHP 脚本地址粘贴到浏览器地址栏直接访问,看是否弹出下载框。这步不通,其他前端逻辑都白搭。











