在长时间运行的任务中使用 ignore_user_abort 避免 PHP 脚本超时

gitbox 2025-05-29

在使用 PHP 执行长时间任务时，我们经常会遇到一种情况：用户关闭浏览器或主动断开请求连接，PHP 脚本就会被中止执行。这对于需要长时间运行或者后端持续处理的脚本来说，是非常致命的。那么，如何防止用户断开连接时脚本被中止呢？答案就是使用 ignore_user_abort() 函数。

什么是 ignore_user_abort？

ignore_user_abort() 是 PHP 提供的一个函数，用于设置当客户端断开连接时，脚本是否继续执行。

ignore_user_abort(true);

当传入 true 参数时，即使用户关闭了浏览器，PHP 脚本仍会继续执行，直到执行完毕或超时/主动退出为止。

ignore_user_abort 的应用场景

处理异步任务
后台队列处理
定时任务模拟执行
文件生成或大数据导出
需要保持状态一致性的后台操作

举个实际的例子，如果你正在开发一个系统备份功能，用户点击“开始备份”后，脚本需要运行十几分钟才能完成。此时用户若关闭浏览器，默认情况脚本就会中止，备份任务失败。而通过 ignore_user_abort(true)，即便用户离开页面，脚本依旧会在服务器上继续执行，直至备份完成。

如何使用 ignore_user_abort

以下是一个典型的长任务处理代码示例：

<?php
ignore_user_abort(true); // 即使用户中断连接也继续执行
set_time_limit(0); // 取消脚本执行时间限制

file_put_contents('log.txt', "任务开始时间：" . date('Y-m-d H:i:s') . "\n", FILE_APPEND);

// 模拟一个长时间任务
for ($i = 1; $i <= 10; $i++) {
    file_put_contents('log.txt', "第 {$i} 步执行中...\n", FILE_APPEND);
    sleep(5); // 模拟每一步耗时
}

file_put_contents('log.txt', "任务完成时间：" . date('Y-m-d H:i:s') . "\n", FILE_APPEND);
?>

你可以通过 curl 或 Ajax 请求来调用这个脚本，比如：

fetch("https://gitbox.net/run-task.php");

即使用户在发送请求后关闭浏览器，该脚本仍会完整执行。

检查连接状态

如果你希望在用户断开连接后做一些逻辑处理，比如写日志或中止某些行为，可以用 connection_aborted() 函数来检测：

if (connection_aborted()) {
    file_put_contents('log.txt', "用户连接已中断\n", FILE_APPEND);
}

配合 ignore_user_abort(true) 使用，可以让你更灵活地处理中断与不中断的情况。

注意事项

使用 ignore_user_abort() 并不意味着你可以忽视所有异常，中断可能还来自服务器端（如 Nginx、Apache 配置）或 PHP 脚本本身（如内存限制）。
推荐同时使用 set_time_limit(0) 来取消最大执行时间限制。
如果脚本输出数据到客户端，尽量在逻辑前就使用 ob_start() 开启缓冲，避免输出行为导致连接问题。

总结

在 PHP 中处理长任务时，使用 ignore_user_abort(true) 是确保脚本不中途被用户中断的一种有效方式。它能保证任务在服务端完整执行，提升系统的稳定性和可靠性。对于涉及备份、推送、导出等任务的后台脚本而言，这是一个非常实用的技巧。