如何在PHP中以非阻塞方式运行WP-CLI命令（跨平台兼容）

if (substr(php_uname(), 0, 7) == "Windows") {
    // 构造WP-CLI命令，并使用 start /B 确保后台运行
    $command = "wp your-custom-command args"; // 替换为你的WP-CLI命令
    pclose(popen("start /B " . $command, "r"));
}

else {
    // 构造WP-CLI命令，并重定向输出到 /dev/null 2>&1 & 确保后台运行
    $command = "wp your-custom-command args"; // 替换为你的WP-CLI命令
    exec($command . " > /dev/null 2>&1 &");
}

/**
 * 在后台执行WP-CLI命令，不阻塞PHP脚本。
 *
 * @param string $wp_cli_command 完整的WP-CLI命令字符串，例如 "wp cache flush"
 * @return bool 命令是否成功启动
 */
function run_wp_cli_command_in_background($wp_cli_command) {
    if (empty($wp_cli_command)) {
        error_log("run_wp_cli_command_in_background: 命令字符串不能为空。");
        return false;
    }

    // 确保 wp-cli 可执行文件在 PATH 中，或者提供完整路径
    // 例如：$wp_cli_executable = '/usr/local/bin/wp';
    // $full_command = $wp_cli_executable . ' ' . $wp_cli_command;
    $full_command = $wp_cli_command; // 假设 wp 在 PATH 中

    if (substr(php_uname(), 0, 7) == "Windows") {
        // Windows 环境下使用 start /B 和 popen/pclose
        // 注意：Windows路径可能需要引号，例如 "C:\path\to\wp"
        $command_to_run = "start /B " . escapeshellcmd($full_command);
        $handle = popen($command_to_run, "r");
        if ($handle === false) {
            error_log("run_wp_cli_command_in_background: Windows环境下启动命令失败: " . $command_to_run);
            return false;
        }
        pclose($handle);
        return true;
    } else {
        // Unix-like (Linux/macOS) 环境下使用 exec 和后台运行符
        $command_to_run = escapeshellcmd($full_command) . " > /dev/null 2>&1 &";
        exec($command_to_run, $output, $return_var);
        if ($return_var !== 0) {
            error_log("run_wp_cli_command_in_background: Unix-like环境下启动命令失败: " . $command_to_run . " 错误码: " . $return_var);
            return false;
        }
        return true;
    }
}

// 在WordPress的某个AJAX处理函数中调用
add_action('wp_ajax_generate_report_async', 'handle_generate_report_async');
function handle_generate_report_async() {
    // 验证用户权限和 nonce
    if (!current_user_can('manage_options') || !check_ajax_referer('my_plugin_nonce', 'security', false)) {
        wp_send_json_error('权限不足或安全验证失败。');
        wp_die();
    }

    $user_id = isset($_POST['user_id']) ? intval($_POST['user_id']) : 0;
    if ($user_id <= 0) {
        wp_send_json_error('无效的用户ID。');
        wp_die();
    }

    $wp_cli_command_str = "wp my-plugin report generate --user=" . $user_id;

    if (run_wp_cli_command_in_background($wp_cli_command_str)) {
        wp_send_json_success('报表生成任务已在后台启动。');
    } else {
        wp_send_json_error('无法启动报表生成任务。请检查服务器日志。');
    }
    wp_die();
}