WordPress中PHP的readFile返回内容而非文件下载问题求助

核心问题 #

你原来的思路存在本质错误：Ajax请求无法直接触发浏览器的文件下载。浏览器会把Ajax请求返回的内容交给JS回调处理，不会自动识别成下载响应，所以你只会收到文件内容，而不会弹出下载框。

修复方案 #

方案1：直接跳转触发下载（最简单） #

放弃Ajax，点击按钮时直接跳转到WordPress的Ajax处理端点，后端输出下载响应。

前端代码

// 给按钮绑定点击事件
document.getElementById("download-btn").addEventListener("click", function() {
    // 跳转到Ajax处理URL，action对应后端注册的函数名
    window.location.href = "/wp-admin/admin-ajax.php?action=generate_download";
});

后端functions.php代码

// 注册Ajax动作，允许登录/未登录用户访问
add_action("wp_ajax_generate_download", "generate_and_download");
add_action("wp_ajax_nopriv_generate_download", "generate_and_download");

function generate_and_download() {
    // 1. 生成文件内容
    $file_content = "这是test.txt的内容";
    $filename = "test.txt";

    // 2. 设置下载响应头
    header("Content-Type: text/plain");
    header("Content-Disposition: attachment; filename=\"{$filename}\"");
    header("Content-Length: " . strlen($file_content));

    // 3. 输出内容并终止程序（必须exit，避免输出WordPress多余内容）
    echo $file_content;
    exit;
}

方案2：用Ajax先验证/生成，再触发下载（适合需要前置逻辑的场景） #

如果需要先通过Ajax做数据验证、异步处理，再生成文件，可让后端返回文件临时URL，前端创建a标签触发下载。

前端代码

document.getElementById("download-btn").addEventListener("click", function() {
    fetch("/wp-admin/admin-ajax.php", {
        method: "POST",
        headers: {
            "Content-Type": "application/x-www-form-urlencoded",
            // 加载WordPress的CSRF验证nonce，需确保主题已加载wp-api脚本
            "X-WP-Nonce": wpApiSettings.nonce
        },
        body: "action=generate_file&user_data=自定义参数"
    })
    .then(res => res.json())
    .then(data => {
        if (data.success) {
            // 提示用户请求成功
            alert(data.data.message);
            // 创建a标签触发下载
            const downloadLink = document.createElement("a");
            downloadLink.href = data.data.file_url;
            downloadLink.download = data.data.file_url.split("/").pop();
            document.body.appendChild(downloadLink);
            downloadLink.click();
            document.body.removeChild(downloadLink);

            // 可选：30秒后删除服务器临时文件（需后端配合）
            setTimeout(() => {
                fetch("/wp-admin/admin-ajax.php", {
                    method: "POST",
                    headers: {
                        "Content-Type": "application/x-www-form-urlencoded",
                        "X-WP-Nonce": wpApiSettings.nonce
                    },
                    body: "action=delete_temp_file&file_url=" + encodeURIComponent(data.data.file_url)
                });
            }, 30000);
        } else {
            // 提示错误
            alert("生成失败：" + data.data.message);
        }
    })
    .catch(err => {
        alert("请求出错：" + err.message);
    });
});

后端functions.php代码

// 注册生成文件的Ajax动作
add_action("wp_ajax_generate_file", "generate_temp_file");
add_action("wp_ajax_nopriv_generate_file", "generate_temp_file");

function generate_temp_file() {
    // 验证请求参数
    if (!isset($_POST["user_data"])) {
        wp_send_json_error(["message" => "缺少必要参数"], 400);
    }

    // 生成文件内容
    $content = "根据参数生成的文件内容：" . $_POST["user_data"];
    $filename = "temp_" . time() . ".txt";
    $upload_dir = wp_upload_dir();
    $file_path = $upload_dir["path"] . "/" . $filename;

    // 写入文件到服务器上传目录
    if (!file_put_contents($file_path, $content)) {
        wp_send_json_error(["message" => "文件写入失败"], 500);
    }

    // 返回成功信息和文件URL
    wp_send_json_success([
        "message" => "文件生成成功，开始下载",
        "file_url" => $upload_dir["url"] . "/" . $filename
    ]);
}

// 注册删除临时文件的Ajax动作
add_action("wp_ajax_delete_temp_file", "remove_temp_file");
add_action("wp_ajax_nopriv_delete_temp_file", "remove_temp_file");

function remove_temp_file() {
    $file_url = isset($_POST["file_url"]) ? $_POST["file_url"] : "";
    if (empty($file_url)) {
        wp_send_json_error(["message" => "参数错误"]);
    }

    $upload_dir = wp_upload_dir();
    // 转换URL为服务器本地路径，防止路径遍历
    $file_path = str_replace($upload_dir["url"], $upload_dir["basedir"], $file_url);
    if (strpos($file_path, $upload_dir["basedir"]) !== 0) {
        wp_send_json_error(["message" => "非法文件路径"]);
    }

    // 删除文件
    if (file_exists($file_path)) {
        unlink($file_path);
        wp_send_json_success(["message" => "临时文件已清理"]);
    } else {
        wp_send_json_error(["message" => "文件不存在"]);
    }
}

请求状态反馈说明 #

• 方案1中：如果后端处理成功，浏览器会直接弹出下载框；如果失败（如权限不足、文件生成失败），浏览器会提示"下载失败"，也可以在后端提前判断，失败时跳转回原页面并携带错误参数，前端解析后显示自定义提示。
• 方案2中：通过wp_send_json_success和wp_send_json_error返回标准的WordPress Ajax响应，前端根据success字段判断结果，用弹窗或页面提示告知用户请求状态。

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