如何处理ThinkPHP导出文件名称中文乱码问题_iconv转码与浏览器Header适配-ThinkPHP-PHP中文网

根本原因是Content-Disposition的filename参数不支持UTF-8直接传入，需用RFC 5987标准的filename*=UTF-8''{encoded}格式并配合rawurlencode编码，同时兼顾IE等旧浏览器兼容性。

如何处理thinkphp导出文件名称中文乱码问题_iconv转码与浏览器header适配

导出文件名含中文时 Chrome / Edge 显示乱码

根本原因是 Content-Disposition 响应头里的 filename 参数不支持 UTF-8 直接传入，浏览器按 ISO-8859-1 解析导致乱码。IE 和旧版 Edge 甚至会直接截断或报错。

实操建议：

不要用 iconv('UTF-8', 'GB2312', $filename) 硬转——GB2312 不覆盖所有中文字符，且现代浏览器根本不认这个编码
优先采用 RFC 5987 标准的 filename*=UTF-8''{encoded} 格式，兼容 Chrome、Firefox、Edge（≥79）、Safari（≥15.4）
为兼容老版 IE（filename（ASCII fallback）和 filename*（UTF-8 encoded）两个字段

示例响应头写法：

Content-Disposition: attachment; filename="report.csv"; filename*=UTF-8''%E6%8A%A5%E8%A1%A8.csv

ThinkPHP 5.1+ 中设置 Header 的正确姿势

TP 默认的 response()->download() 不自动处理中文名，必须手动构造 Content-Disposition。直接改 header() 容易被框架后续逻辑覆盖。

实操建议：

用 Response::create() 手动构建响应对象，再调用 header() 设置完整 Content-Disposition
中文部分必须用 rawurlencode() 编码（不是 urlencode()），否则空格、括号等会被破坏
避免在控制器里多次调用 header()，ThinkPHP 5.1+ 的 Response 对象 header 是累积式，但顺序错乱会导致失效

关键代码片段：

page-agent 浏览器控制（CDP）

使用 page-agent CLI（CDP）控制浏览器；CLI只能通过 GitHub Release 的 .tgz 安装，npm 官方包暂未发布。

下载

$filename = '用户数据报表.csv';
$encoded = rawurlencode($filename);
header('Content-Disposition: attachment; filename="' . basename($filename) . '"; filename*=UTF-8\'\'' . $encoded);

为什么 `iconv` 在这里基本没用

iconv 是用来做字符集转换的，但问题不在文件内容编码，而在 HTTP 头字段的传输规范。HTTP/1.1 协议明确要求 header 值只能是 US-ASCII 字符，中文必须编码后以 token 形式传递。

常见错误现象：

用 iconv('UTF-8', 'GBK', $name) 后塞进 filename="xxx" → Chrome 显示问号，Firefox 拒绝下载
只设 filename*=UTF-8''xxx 不带 filename fallback → IE11 直接弹出“未命名.csv”
用 mb_convert_encoding($name, 'UTF-8', 'auto') 再 rawurlencode → 多余，输入本来就是 UTF-8