WordPress自定义插件后台导出TXT混入页面HTML的问题求助

问题根源在于你在admin_menu钩子中处理导出逻辑——这个钩子触发时，WordPress已经开始输出后台页面的HTML结构了，此时再输出导出内容，自然会和页面HTML混在一起。

解决思路是提前在页面输出前处理导出请求，并且处理完成后立即终止程序，具体步骤如下：

1. 移到更早的钩子处理导出 #

使用admin_init钩子，它在后台页面输出任何内容之前触发，完美适配这类需要输出文件的场景。

2. 处理导出后立即退出 #

输出文件内容后必须调用exit()，阻止WordPress继续渲染后续的后台页面HTML。

完整代码示例 #

// 处理导出请求（放在admin_init钩子中）
add_action('admin_init', 'handle_email_txt_export');
function handle_email_txt_export() {
    // 验证提交标识和用户权限
    if (isset($_POST['txt_submit']) && current_user_can('manage_options')) {
        // 替换为你的实际邮箱数组
        $email_list = ['user1@example.com', 'user2@example.com', 'user3@example.com'];
        $export_content = implode(PHP_EOL, $email_list);

        // 设置文件下载响应头
        header('Content-Type: text/plain');
        header('Content-Disposition: attachment; filename="email_list.txt"');
        header('Content-Length: ' . strlen($export_content));

        // 输出内容并终止程序
        echo $export_content;
        exit;
    }
}

// 注册后台菜单页面（原admin_menu逻辑保留）
add_action('admin_menu', 'register_email_export_menu');
function register_email_export_menu() {
    add_menu_page(
        '邮箱导出工具',
        '邮箱导出',
        'manage_options',
        'email-export-tool',
        'render_export_page'
    );
}

// 渲染后台页面表单
function render_export_page() {
    ?>
    <div class="wrap">
        <h1>导出邮箱列表</h1>
        <form method="post">
            <?php submit_button('导出为TXT文件', 'primary', 'txt_submit'); ?>
        </form>
    </div>
    <?php
}

关键注意事项 #

• 权限检查：current_user_can('manage_options')确保只有有权限的用户才能触发导出，避免安全风险。
• 必须exit：如果省略exit()，WordPress会继续输出后台页面的HTML，导致导出文件仍然混入多余内容。
• 响应头顺序：先设置Content-Type再设置Content-Disposition，确保浏览器正确识别文件类型。

内容的提问来源于stack exchange，提问作者ILG