ignore_user_abort

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

ignore_user_abortУстановить, должно ли отключение клиента прерывать выполнение скрипта

Описание

ignore_user_abort(bool|null $enable = null): int

Устанавливает, необходимо ли прерывать работу скрипта при отключении клиента.

При работе с PHP-скриптом в командной строке, когда терминал скрипта отключается без прерывания работы скрипта, скрипт будет остановлен, если параметр enable не равен true

Список параметров

enable

Если параметр задан и не null, то эта функция устанавливает ini-настройку ignore_user_abort, заданным значением параметра enable. Если же параметр не задан, функция вернёт предыдущее значение опции без его изменения.

Возвращаемые значения

Возвращает предыдущее значение в виде целого числа.

Список изменений

Версия Описание
8.0.0 enable теперь допускает значение null.

Примеры

Пример #1 Пример использования ignore_user_abort()

<?php
// Игнорирует отключение пользователя и позволяет скрипту
// быть запущенным постоянно
ignore_user_abort(true);
set_time_limit(0);

echo 
'Тестирование обработки соединения в PHP';

// Запуск бесконечного цикла,
// который будет завершён при выходе со страницы,
// либо при нажатии кнопки "Stop".
while(1)
{
    
// Завершено ли соединение?
    
if(connection_status() != CONNECTION_NORMAL)
    {
        break;
    }

    
// Пауза на 10 секунд
    
sleep(10);
}

// Если скрипт достиг этой строки, то была
// выполнена функция 'break' из цикла while

// Здесь можно производить журналирование, либо
// выполнять другие необходимые операции независимо
// от браузера.
?>

Примечания

PHP не обнаружит, что пользователь прервал соединение до тех пор, пока не будет произведена попытка отправки информации клиенту. Простое использование выражения echo не гарантирует отправку информации, смотрите функцию flush().

Смотрите также

add a note add a note

User Contributed Notes 7 notes

up
30
lukas dot starecek at centrum dot cz
14 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.
up
54
spiritual-coder at spiritual-coder dot com
17 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);
?>
up
6
Micke
9 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
up
15
Anonymous
14 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.
up
-7
Charlie Brown
9 years ago
If running a long process and the browser often close the connection, then use this function.
up
-23
plamen at pulsator dot com
23 years ago
The script should output something to the browser in order to abort. If there is no output the script keeps on running.
up
-56
phpguy92135 at yahoo dot com
14 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.
To Top