解决WordPress中PHP导出数据库CSV含后台HTML垃圾问题

你遇到的问题是因为WordPress在执行add_menu_page的回调函数csvFile前后，会自动输出后台管理面板的HTML框架（比如头部、侧边栏、页脚等）。你的代码虽然输出了CSV内容，但WordPress后续输出的HTML会被一并写入到下载文件中，导致CSV混入无用内容。

另外，你用ob_start()和return ob_get_clean()的方式是错误的——这个回调函数的返回值会被WordPress插入到后台页面的主体部分，而不是作为独立的下载响应返回。

修改代码，移除输出缓冲区操作，并且在输出CSV内容后立即终止程序，阻止WordPress继续输出后台HTML：

add_action( 'admin_menu', 'my_admin_menu' );

function my_admin_menu() {
    add_menu_page('CSV', 'CSV File', 'manage_options', 'csv-file', 'csvFile', 'dashicons-admin-post', 6);
}

function csvFile() {
    // 二次检查权限，提升安全性
    if (!current_user_can('manage_options')) {
        wp_die(__('You do not have sufficient permissions to access this page.'));
    }

    global $wpdb;

    // 清理缓冲区，确保响应头能正常发送
    ob_clean();
    flush();

    // 设置CSV响应头
    header('Content-Type: text/csv; charset=utf-8');
    header('Content-Disposition: attachment; filename=redirect_export.csv');

    $values = [['source URL', 'target URL']];
    $table_name = 'wp_wbz404_redirects';
    $results = $wpdb->get_results("SELECT * FROM $table_name");

    if (!empty($results)) {
        $fp = fopen('php://output', 'w');
        fputcsv($fp, $values[0]); // 先写入表头

        foreach ($results as $result) {
            $home = home_url();
            $source_url = $home . $result->url;
            $id = $result->final_dest;

            if ($id == 0) {
                continue;
            }

            $target_url = get_permalink($id);
            fputcsv($fp, [$source_url, $target_url]); // 逐行写入，避免数组合并的性能损耗
        }

        fclose($fp);
    } else {
        // 无数据时输出提示
        echo "NO RESULTS";
    }

    // 终止程序，阻止WordPress输出后续后台HTML
    exit();
}

• 移除ob_start()和return ob_get_clean()：无需捕获输出，直接将CSV内容写入输出流即可。
• 添加ob_clean()和flush()：清理可能残留的缓冲区内容，避免响应头发送失败。
• 逐行写入CSV数据：避免合并大数组，提升处理效率，尤其在数据量较大时更明显。
• 调用exit()终止程序：直接停止PHP执行，彻底阻止WordPress输出后台管理面板的HTML内容。
• 增加权限二次校验：避免未授权用户直接访问该功能。

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