[PHP 4, PHP 5, PHP 7, PHP 8]
ignore_user_abort — Set whether a client disconnect should abort script execution
Description
ignore_user_abort[?bool $enable
= null
]: int
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 enable
is set to true
Parameters
enable
If set and not null
, this function will set the
ignore_user_abort ini setting to the given enable
. Otherwise, this function will only return the previous setting without changing it.
Return Values
Returns the previous setting, as an integer.
Changelog
8.0.0 | enable is nullable now.
|
Examples
Example #1 A ignore_user_abort[] example
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[].
See Also
- connection_aborted[] - Check whether client disconnected
- connection_status[] - Returns connection status bitfield
- Connection Handling for a complete description of connection handling in PHP.
spiritual-coder at spiritual-coder dot com ¶
16 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]:
lukas dot starecek at centrum dot cz ¶
13 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 //www.php.net/manual/en/function.sleep.php and comments]. We tested it and it's true. Try this:
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.
Anonymous ¶
13 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.
Charlie Brown ¶
7 years ago
If running a long process and the browser often close the connection, then use this function.
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.