ignore_user_abort

Description

intignore_user_abort
([ bool$value
] )

Sets whether a client disconnect should cause a script to be aborted.

When running PHP as a command line script, and the script's tty goes
away without the script being terminated then the script will die the
next time it tries to write anything, unless
value is set to TRUE

Parameters

value

If set, this function will set the ignore_user_abort ini setting
to the given value. If not, this function will
only return the previous setting without changing it.

Return Values

Returns the previous setting, as an integer.

Examples

Example #1 A ignore_user_abort() example

<?php// Ignore user aborts and allow the script// to run foreverignore_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 secondssleep(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.?>

Notes

PHP will not detect that the user has aborted the connection until
an attempt is made to send information to the client. Simply using
an echo statement does not guarantee that information is sent, see
flush().

User Contributed Notes 7 notes

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.

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):

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.