在PHP中生成可下载的TXT文件需设置响应头并处理编码。首先使用header('Content-Type: text/plain')声明内容类型,再通过header('Content-Disposition: attachment; filename="...")强制浏览器下载,并用ob_clean()清除缓冲避免输出污染。为解决中文文件名乱码,需根据用户代理(User-Agent)对IE、Firefox等浏览器分别采用rawurlencode、base64_encode或mb_convert_encoding编码,同时使用filename*=UTF-8''...格式兼容现代浏览器。确保PHP文件、内容字符串及数据库读取均为UTF-8编码,必要时用mb_convert_encoding()转换。导出动态数据时,如数组转制表符分隔文本,需逐行拼接并正确设置Content-Length。最后添加Cache-Control: must-revalidate和Pragma: public确保传输可靠,输出内容后调用exit终止脚本。完整流程包括清空缓冲、设置头部、输出内容三步骤,重点在于头部设置与多浏览器兼容性处理。

在PHP中生成可下载的TXT文件,关键在于正确设置HTTP响应头(header),告诉浏览器不要直接显示内容,而是将其作为附件下载。同时要注意文本内容的编码处理,避免乱码问题。
设置Header强制浏览器下载文件
通过设置合适的Content-Disposition头,可以让浏览器将输出内容提示为下载文件,而不是在页面中显示。
示例代码:
$filename = "data.txt";
$content = "这里是需要写入文件的内容";
// 清除缓冲区,防止额外输出
ob_clean();
header('Content-Type: text/plain');
header('Content-Disposition: attachment; filename="' . $filename . '"');
header('Content-Length: ' . strlen($content));
header('Connection: close');
echo $content;
exit;
说明:
立即学习“PHP免费学习笔记(深入)”;
- Content-Type: text/plain 告诉浏览器这是纯文本
- Content-Disposition: attachment 强制浏览器弹出下载对话框
- filename 指定下载时默认的文件名
- ob_clean() 清除之前可能存在的输出缓冲,避免头部被污染
处理中文文件名乱码问题
如果文件名包含中文,在不同浏览器下可能出现乱码或显示异常。需要对文件名进行编码适配。
推荐做法:
$filename = "报告.txt";
$userAgent = $_SERVER['HTTP_USER_AGENT'] ?? '';
if (strpos($userAgent, 'MSIE') !== false || strpos($userAgent, 'Trident') !== false) {
// IE浏览器
$encodedFilename = rawurlencode($filename);
} elseif (strpos($userAgent, 'Firefox') !== false) {
// Firefox
$encodedFilename = '=?UTF-8?B?' . base64_encode($filename) . '?=';
} else {
// 其他浏览器(Chrome、Safari等)
$encodedFilename = mb_convert_encoding($filename, 'UTF-8', 'auto');
}
header('Content-Disposition: attachment; filename="' . $encodedFilename . '"; filename*=UTF-8\'\'' . rawurlencode($filename));
使用 filename* 格式能更好支持现代浏览器的UTF-8文件名。
确保内容编码统一为UTF-8
PHP脚本、字符串内容和输出编码应保持一致,推荐全部使用UTF-8。
常见处理方式:
- 保存PHP文件为UTF-8无BOM格式
- 如有必要,在输出前转换内容编码:mb_convert_encoding($content, 'UTF-8', 'auto')
- 对于从数据库读取的内容,确保连接和字段编码为utf8mb4
- 若内容含特殊字符,可考虑用 utf8_encode() 或 mb_convert_encoding() 处理
生成动态内容并下载
实际应用中,常需将数组或查询结果导出为TXT。
示例:导出用户列表
$data = [
['ID', '姓名', '邮箱'],
[1, '张三', 'zhang@example.com'],
[2, '李四', 'li@example.com']
];
$csvContent = '';
foreach ($data as $line) {
$csvContent .= implode("\t", $line) . "\n"; // 用制表符分隔
}
$filename = '用户列表.txt';
header('Content-Type: text/plain; charset=UTF-8');
header('Content-Disposition: attachment; filename="' . rawurlencode($filename) . '"; filename*=UTF-8\'\'' . rawurlencode($filename));
header('Content-Length: ' . strlen($csvContent));
header('Cache-Control: must-revalidate');
header('Pragma: public');
header('Connection: close');
echo $csvContent;
exit;
基本上就这些。只要设置好header,处理好编码和文件名,就能稳定实现TXT文件的强制下载功能。注意测试不同浏览器下的表现,尤其是中文环境。不复杂但容易忽略细节。











