如何在UI超时后终止PHP后端API及Snowflake查询？

一、终止PHP后端API进程 #

PHP默认在客户端断开连接（比如UI超时）时会终止脚本，但如果代码中设置了ignore_user_abort(true)则会继续执行。可以通过以下方式确保脚本随客户端断开而终止：

1. 设置脚本超时与连接规则
   在API脚本开头添加：

// 限制脚本最大执行时间为60秒，和UI超时保持一致
set_time_limit(60);
// 确保客户端断开时立即终止脚本
ignore_user_abort(false);

2. 主动检测客户端连接状态
   在Snowflake查询执行过程中，定期检查客户端是否已断开，若断开则主动终止脚本并清理资源：

// 执行Snowflake查询
$stmt = $conn->query($your_snowflake_sql);

// 分批处理查询结果时，每轮都检查连接状态
while ($row = $stmt->fetch()) {
    if (connection_aborted()) {
        $stmt->closeCursor();
        $conn->close();
        exit();
    }
    // 处理单条结果逻辑
}

// 若为一次性执行的大查询，可通过定时触发检测（需pcntl扩展支持，仅CLI或配置允许的环境可用）
declare(ticks=1);
pcntl_signal(SIGALRM, function() use ($conn, $queryId) {
    $conn->cancelQuery($queryId);
    $conn->close();
    exit();
});
pcntl_alarm(60);

3. PHP-FPM全局超时配置（可选）
   如果使用PHP-FPM，可在对应池配置文件中添加：

request_terminate_timeout = 60s

该配置会强制终止运行超过60秒的请求，但属于全局设置，可能影响其他无需超时限制的API，需谨慎使用。

二、主动终止Snowflake后台查询 #

即使PHP脚本终止，Snowflake服务器上的查询可能仍在运行，因此必须主动取消查询：

1. 记录查询ID并触发取消
   执行查询时获取查询ID，在客户端断开时调用Snowflake的取消接口：

$stmt = $conn->query($your_snowflake_sql);
// 获取当前查询的唯一ID
$queryId = $stmt->getQueryId();

// 检测到客户端断开时，立即取消Snowflake查询
if (connection_aborted()) {
    $conn->cancelQuery($queryId);
    $conn->close();
    exit();
}

2. 设置Snowflake会话级超时
   在执行业务查询前，设置Snowflake会话的查询超时，确保即使PHP未处理，Snowflake会自动终止超时查询：

// 将当前会话的查询超时设为60秒
$conn->query("ALTER SESSION SET STATEMENT_TIMEOUT_IN_SECONDS = 60");
// 执行业务查询
$stmt = $conn->query($your_snowflake_sql);

三、最佳实践 #

• 优先结合PHP脚本超时检测和Snowflake会话超时，双重保障避免无效查询持续占用资源。
• 尽量避免在API中执行耗时超过UI超时的大查询，可拆分查询或使用异步任务（如消息队列）处理，从根源减少超时场景。

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