在 WordPress 插件后台页面中触发 TXT 文件下载时，若 PHP 输出未及时终止，会导致当前页面 HTML 被一并写入文件；正确做法是立即发送响应头、输出内容后强制终止脚本执行。
在 wordpress 后台页面（如自定义 admin_menu 页面）中实现字符串导出为纯 txt 文件时，常见陷阱是：php 逻辑嵌入在 html 渲染流程中，即使设置了正确的 content-type 和 content-disposition 头，后续仍会继续输出页面模板的 html 结构，最终导致下载的 txt 文件开头和结尾包含完整网页源码。
根本原因在于 HTTP 响应必须是“纯净”的——一旦开始输出文件内容，就不应再有任何额外输出（包括空白符、HTML 标签、WordPress 主题/插件注入的脚本等）。而 WordPress 的 admin 页面生命周期决定了你的代码通常运行在 HTML 渲染中途，因此仅靠 header() 和 echo 并不足以阻断后续输出。
✅ 正确解决方案分三步：
- 尽早拦截请求并独占响应流：在 WordPress 钩子中优先判断是否为导出请求（如检查特定 $_POST 或 $_GET 参数），一旦命中，立即处理并退出；
- 发送严格响应头：禁用缓存、指定二进制流类型与附件名称；
-
输出内容后强制终止：使用
exit或die阻止 WordPress 继续执行后续页面渲染逻辑。
以下是适配 WordPress 自定义后台菜单页的安全导出示例（推荐在 admin_init 或 load-{page-hook} 中注册）：
// 在插件主文件或 admin 初始化逻辑中添加
add_action('load-your-plugin-page', 'handle_email_export');
function handle_email_export() {
if (isset($_POST['txt_submit']) && wp_verify_nonce($_POST['_wpnonce'], 'export_emails_nonce')) {
// 构建数据
$emails = [
'<a class="__cf_email__" data-cfemail="4d2c2f2e0d2c2f2e632e2220" href="/cdn-cgi/l/email-protection">[email protected]</a>',
'<a class="__cf_email__" data-cfemail="b6cecfccf6cecfcc98d5d9db" href="/cdn-cgi/l/email-protection">[email protected]</a>'
];
$content = implode(PHP_EOL, $emails);
// 发送响应头（关键：必须在任何输出前）
status_header(200);
header('Content-Type: text/plain; charset=utf-8');
header('Content-Disposition: attachment; filename="emails.txt"');
header('Content-Length: ' . strlen($content));
header('Cache-Control: must-revalidate, post-check=0, pre-check=0');
header('Expires: 0');
header('Pragma: public');
// 输出内容并立即终止 —— 这是防止 HTML 混入的核心
echo $content;
exit; // ✅ 必须！不可省略
}
}
? 重要注意事项：
-
永远在
echo后调用exit或die：这是解决本问题的最关键一步，否则 WordPress 会继续执行admin_footer、do_action('admin_print_footer_scripts')等钩子，将页面 HTML 注入响应体； -
使用 nonce 验证表单提交：防止 CSRF 攻击（示例中已加入
wp_verify_nonce）； - 避免空格或 BOM 字符：确保 PHP 文件本身无 UTF-8 BOM、前后无多余换行或空格，否则会破坏 header 发送；
-
不要在输出后调用
wp_die()或重定向：它们可能触发额外输出，exit是最干净的选择； - 若需兼容 IE8 及更早版本，可额外添加
header('Accept-Ranges: bytes');，但现代场景通常无需。
通过该方式，你将获得一个真正纯净的 .txt 文件，仅包含预期的邮箱列表，零 HTML 噪声——既符合 Web 安全规范，也满足 WordPress 插件开发最佳实践。
前端入门到VUE实战笔记：立即使用
在学习笔记中，你将探索 前端 的入门与实战技巧！
