WordPress自定义主题后台导出邮件列表遇Header已发送问题求助

问题场景 #

在自定义主题的functions.php中通过add_theme_page创建邮件列表后台页面，尝试导出自定义数据库表中的邮件数据时，因WordPress已提前发送页面Header，导致无法设置CSV下载所需的Header，无法完成导出操作。

原添加页面代码：

add_theme_page( 'Newsletter', 'Emails Nota 10', 'manage_options', 'emails.php', 'paginaEmails');

原页面处理代码：

function paginaEmails()
{

    if ( (isset($_GET['exportar'])) and ($_GET['exportar']='true')){
        global $wpdb;
        $table_name = $wpdb->prefix . 'tb_emails_newsletter';
        $result = $wpdb->get_results("select * from " . $table_name);
        var_dump($result);
        if (count($result)>0){
            //just a test
            header('Content-Type: text/csv'); 
            header('Content-Disposition: attachment; filename="teste.csv";'); 
        }
        echo '';exit;
    }
    ?>
    <div class="section panel">
    <h1>Emails Cadastrados</h1>
    <a href="?page=emails.php&exportar=true">Exportar Emails CSV</a>

解决方案 #

核心思路是在WordPress输出任何HTML内容之前处理导出请求，利用admin_init钩子拦截导出参数，提前执行导出逻辑，避免Header已发送的冲突。

步骤1：添加admin_init钩子处理导出逻辑 #

在functions.php中新增以下代码，用来提前拦截并处理导出请求：

add_action('admin_init', 'handle_email_export');

function handle_email_export() {
    // 验证导出请求及用户权限
    if (isset($_GET['exportar']) && $_GET['exportar'] === 'true' && current_user_can('manage_options')) {
        global $wpdb;
        $table_name = $wpdb->prefix . 'tb_emails_newsletter';
        // 以关联数组形式获取数据，方便生成表头
        $results = $wpdb->get_results("SELECT * FROM {$table_name}", ARRAY_A);

        if (!empty($results)) {
            // 设置CSV下载的Header
            header('Content-Type: text/csv; charset=utf-8');
            header('Content-Disposition: attachment; filename="emails_newsletter.csv"');
            
            // 打开输出缓冲区用于生成CSV
            $output = fopen('php://output', 'w');
            
            // 写入CSV表头（自动取数据表的字段名）
            fputcsv($output, array_keys($results[0]));
            
            // 循环写入数据行
            foreach ($results as $row) {
                fputcsv($output, $row);
            }
            
            // 终止程序，防止输出后台页面的HTML内容
            exit;
        }
    }
}

步骤2：修改原页面回调函数 #

移除原函数中处理导出的代码，仅保留页面展示部分：

function paginaEmails() {
    ?>
    <div class="section panel">
        <h1>Emails Cadastrados</h1>
        <a href="?page=emails.php&exportar=true">Exportar Emails CSV</a>
    </div>
    <?php
}

关键说明 #

• admin_init钩子在WordPress后台初始化阶段触发，此时还未输出任何HTML内容，可正常设置下载Header。
• 必须验证用户权限（current_user_can('manage_options')），防止未授权的导出请求。
• 使用ARRAY_A参数让get_results返回关联数组，自动提取数据表字段作为CSV表头。
• php://output直接将内容输出到浏览器，配合Header实现文件下载的效果。

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