PHP生成JSON并触发下载的实现方法

本文详解了如何用PHP正确返回JSON数据并强制浏览器触发下载（而非直接渲染），强调必须精准设置Content-Type、Content-Disposition等关键响应头，清除所有前置输出以避免headers已发送错误，并提供支持UTF-8中文不转义、防缓存及兼容性优化的完整可运行示例，是Web开发中实现JSON文件安全导出的实用指南。

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 不认。稳妥做法是避开中文文件名：

• 用英文命名：如 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 调用时无法触发下载？

这是正常现象——浏览器只对直接导航（如 ）或表单提交（target="_blank"）自动触发下载。如果用 fetch 或 $.ajax 请求，响应体不会自动下载，需手动处理：