PHP 函数ignore_user_abort ()

PHP很有用的一个函数ignore_user_abort ()  

　ignore_user_abort 设置与客户机断开是否会终止脚本的执行。

　　本函数返回 user-abort 设置的之前的值（一个布尔值）。

int ignore_user_abort ([ string $value ] )

　　

参数	描述
setting	可选。如果设置为 true，则忽略与用户的断开，如果设置为 false，会导致脚本停止运行。  如果未设置该参数，会返回当前的设置。

　注释：PHP 不会检测到用户是否已断开连接，直到尝试向客户机发送信息为止。简单地使用 echo 语句无法确保信息发送，参阅 flush() 函数。

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26

例-1 一个的ignore_user_abort（）的例子，配合set_time_limit()函数 和一个死循环就可以实现计划任务功能。 　　<?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内置函数研究系列第二期，采用PHP函数ignore_user_abort实现计划任务与持续进程实例，并通过一个可检测效果的实例讨论ignore_user_abort()函数的作用与用法。

ignore_user_abort() 可以实现当客户端关闭后仍然可以执行PHP代码，可保持PHP进程一直在执行，可实现所谓的计划任务功能与持续进程，只需要开启执行脚本，除非 apache等服务器重启或有脚本有输出，该PHP脚本将一直处于执行的状态，初看很实用，不过代价是一个PHP执行脚本的持续进程，开销很大，但却可以 实现很多意想不到的功 能。

其描述为设置与客户机断开是否会终止脚本的执行。

一，函数原型 

1	int ignore_user_abort ( [ bool setting] )

　　

二，版本兼容 
PHP 3 >= 3.0.7, PHP 4, PHP 5

三，函数基础用法与实例 
1，函数基础用法

1 2 3

<?php ignore_user_abort(); ?>

说明：调用ignore_user_abort()函数声明即使客户机断开不终止脚本的执行。

2，结合set_time_limit()函数实现一个循环脚本执行任务

1 2 3 4 5 6 7 8

<?php ignore_user_abort(); set_time_limit(0); $interval=60*15; do { //执行的业务 } while ( true ); ?>

　说明：每隔15分钟循环执行

3，自定义实现文件输出并跟踪ignore_user_abort()函数的执行结果

1 2 3 4 5 6 7 8 9 10 11 12

<?php ignore_user_abort ( TRUE ); set_time_limit ( 0 ); $interval = 10; $stop = 1; do {      if ( $stop == 10 ) break ;      file_put_contents( 'liuhui.php' , ' Current Time: ' .time(). ' Stop: ' .$stop);      $stop++;      sleep ( $interval ); } while ( true ); ?>

打开liuhui.php文件，文件内容如下：

 Current Time: 1273735029 Stop: 9

其原理是即使客户端终止脚本，仍然每隔10秒钟执行一次，并打印出当前时间与终止点，这样就可以测试出ignore_user_abort()函数的具体效果。

通过实例发现ignore_user_abort()函数非常实用，实现计划任务，完成后续任务，持续进程等非常有效。更多说明请参与PHP手册。请关注下一期PHP内置函数研究系列。

最后介绍下php手册中的相关的知识：

1.连接处理：

在 PHP 内部，系统维护着连接状态，其状态有三种可能的情况：
 

0 – NORMAL（正常）
1 – ABORTED（异常退出）
2 – TIMEOUT（超时）

当 PHP 脚本正常地运行 NORMAL 状态时，连接为有效。当远程客户端中断连接时，ABORTED 状态的标记将会被打开。远程客户端连接的中断通常是由用户点击 STOP 按钮导致的。当连接时间超过 PHP 的时限时，TIMEOUT 状态的标记将被打开。

可以决定脚本是否需要在客户端中断连接时退出。有时候让脚本完整地运行会带来很多方便，即使没有远程浏览器接受脚本的输出。默认的情况是当远程客户 端连接中断时脚本将会退出。该处理过程可由 php.ini 的 ignore_user_abort 或由 Apache .conf 设置中对应的”php_value ignore_user_abort”以及 ignore_user_abort() 函数来控制。如果没有告诉 PHP 忽略用户的中断，脚本将会被中断，除非通过 register_shutdown_function() 设置了关闭触发函数。通过该关闭触发函数，当远程用户点击 STOP 按钮后，脚本再次尝试输出数据时，PHP 将会检测到连接已被中断，并调用关闭触发函数。

脚本也有可能被内置的脚本计时器中断。默认的超时限制为 30 秒。这个值可以通过设置 php.ini 的 max_execution_time 或 Apache .conf 设置中对应的”php_value max_execution_time”参数或者 set_time_limit() 函数来更改。当计数器超时的时候，脚本将会类似于以上连接中断的情况退出，先前被注册过的关闭触发函数也将在这时被执行。在该关闭触发函数中，可以通过调 用 connection_status() 函数来检查超时是否导致关闭触发函数被调用。如果超时导致了关闭触发函数的调用，该函数将返回 2。

注意：ABORTED 和 TIMEOUT 状态可以同时有效。这在告诉 PHP 忽略用户的退出操作时是可能的。PHP 将仍然注意用户已经中断了连接但脚本仍然在运行的情况。如果到了运行的时间限制，脚本将被退出，设置过的关闭触发函数也将被执行。在这时会发现函数 connection_status() 返回 3。