PHP - Manual: ignore_user_abort

2024-12-21

pack »

« hrtime

ignore_user_abort

(PHP 4, PHP 5, PHP 7, PHP 8)

ignore_user_abort — 设置客户端断开连接时是否中断脚本的执行

说明

ignore_user_abort(bool $value = ?): int

设置客户端断开连接时是否中断脚本的执行

PHP 以命令行脚本执行时，当脚本终端结束，脚本不会被立即中止，除非设置 value 为 true，否则脚本输出任意字符时会被中止。

参数

value: 如果设置了该值，函数会把 ignore_user_abort ini 的值设置为 value。如果未设置该值，函数不会改变设置，仅会返回之前的设置。

返回值

以整型返回之前的设置

范例

示例 #1 ignore_user_abort()例子


<?php
// Ignore user aborts and allow the script
// to run forever
ignore_user_abort(true);
set_time_limit(0);

echo 'Testing connection handling in PHP';

// Run a pointless loop that sometime 
// hopefully will make us click away from 
// page or click the "Stop" button.
while(1)
{
    // Did the connection fail?
    if(connection_status() != CONNECTION_NORMAL)
    {
        break;
    }

    // Sleep for 10 seconds
    sleep(10);
}

// If this is reached, then the 'break' 
// was triggered from inside the while loop

// So here we can log, or perform any other tasks
// we need without actually being dependent on the 
// browser.
?>

注释

在PHP尝试发送信息到客户端之前，不会检测到用户是否已中断连接。仅使用 echo 语句不能确保信息已发送，参见 flush() 函数。

参见

connection_aborted() - 检查客户端是否已经断开
connection_status() - 返回连接的状态位
Connection Handling 关于PHP连接处理的完整描述。

add a note

User Contributed Notes 7 notes

down

spiritual-coder at spiritual-coder dot com ¶

15 years ago


If you want to simulate a crontask you must call this script once and it will keep running forever (during server uptime) in the background while "doing something" every specified seconds (= $interval):


<?php

ignore_user_abort(1); // run script in background

set_time_limit(0); // run script forever

$interval=60*15; // do every 15 minutes...

do{

   // add the script that has to be ran every 15 minutes here

   // ...

   sleep($interval); // wait 15 minutes

}while(true);

?>

down

lukas dot starecek at centrum dot cz ¶

12 years ago


Comment from Anonymous is not 100% valid. Time from sleep function is not counted to execution time because sleep delays program execution (see http://www.php.net/manual/en/function.sleep.php and comments). We tested it and it's true. Try this:

<?php

set_time_limit(2);
sleep(4);
echo 'hi!';
sleep(4);
echo 'bye bye!';

?>

It means, that if the loop most of the time will be at sleep (and in this case it probably be), then this script may be active for months or years even if you set time limit to one day.

down

Anonymous ¶

12 years ago


use the spiritual-coder's code below with exreme caution and do not use it unless you are an advanced user.

first of all, such a code with no bypass point can cause infinite loops and ghost threads in server. there must be a trick to break out the loop. 

i.e. you can use  if (file_exists(dirname(__FILE__)."stop.txt")) break; in the loop so if you create "stop.txt", she script will stop execution.

also if you use set_time_limit(86400); instead of set_time_limit(0); your script will stop after one day.

down

Micke ¶

7 years ago


It seems that this function does not work for IIS servers.

A detailed description can be found on the PHP Bug Tracking System:
https://bugs.php.net/bug.php?id=60586#1378935714

down

-15

Charlie Brown ¶

7 years ago


If running a long process and the browser often close the connection, then use this function.

down

-24

plamen at pulsator dot com ¶

21 years ago


The script should output something to the browser in order to abort. If there is no output the script keeps on running.

down

-61

phpguy92135 at yahoo dot com ¶

13 years ago


Theres no point in sending anything to the browser if the user does abort.  Since the user aborted, the browser wont listen even if PHP did send information to the browser.

If you want to see if the user did abort, then use error_log() or some other form of logging to find out what happened, but dont rely on the output to the browser as the only method of checking ones data.

add a note

官方地址：https://www.php.net/manual/en/function.ignore-user-abort.php

有任何技术问题请点击这里网站运营推广招聘

IT PHP 编程语言 Linux 开发编程科技 Elasticsearch HTML/CSS/XML 网络数据库 JAVA 面试 NoSQL C/C++ Golang Git 算法操作系统正则表达式 Redis 互联网 MySql JavaScript 运维软件国际架构设计 Mac OS TCP/IP Excel Vim Windows Socket Oracle VR MongoDB Python 运营 MemCache 商业硬件电子娱乐设计 nginx 摄影游戏 WordPress HTTP 团建数码电器

php7 安装fileinfo扩展 preg_split — 通过一个正则表达式分隔字符串 php位值,解决 PHP 中 usort 在值相同时改变原始位置的问题 [PHP] inet_pton/inet_ntop IP地址转换函数 PHP 8.1 [鸟哥]PHP_INT_MIN 和 -9223372036854775808 adodb手册 ADORecordSet对象 opcache预加载 Composer的Packagist资源 array_multisort() 多字段排序 PHPMailer设置utf8 PHPMailer字符集CharSet PHP json解析（json_decode）页面工具 mysql面试题纯php实现DES以及TripleDES加密算法 php中几种注释规范两千行PHP学习笔记 php 修改图片大小支持php7的性能采集扩展利用PHP SOAP实现WEB SERVICE

略微加速

PHP官方手册 - 互联网笔记

ignore_user_abort

说明

参数

返回值

范例

注释

参见

User Contributed Notes 7 notes