ignore_user_abort

(PHP 4, PHP 5)

ignore_user_abortEstablecer si la desconexión de un cliente debería abortar la ejecución del script

Descripción

int ignore_user_abort ([ string $value ] )

Establece si la desconexión de un cliente deberia ocasionar que el script sea abortado.

Cuando se ejecuta PHP como un script de línea de comandos, y el tty del script se marcha sin que el script haya finalizado, el script morirá la siguiente vez que se intente escribir algo, a menos que value esté establecido a TRUE

Parámetros

value

Si se establece, esta función establecerá la configuración ini de ignore_user_abort al valor dado por value. Si no, esta función sólo devolverá la configuración previa sin cambiarla.

Valores devueltos

Devuelve la configuración previa, como un valor de tipo integer.

Ejemplos

Ejemplo #1 Un ejemplo ignore_user_abort()

<?php
// Ignorar los abortos hechos por el usuario y permitir que el script
// se ejecute para siempre
ignore_user_abort(true);
set_time_limit(0);

echo 
'Probando la gestión de conexión de PHP';

// Ejecutar un bucle que hará, con suerte,
// que hagamos clic fuera de la
// página o en el botón "Parar".
while(1)
{
    
// ¿Falló la conexión?
    
if(connection_status() != CONNECTION_NORMAL)
    {
        break;
    }

    
// Dormir durante 10 segundos
    
sleep(10);
}

// Si se alcanza esto, el 'break' 
// fue provocado desde dentro del bucle while

// Por lo que aquí podemos realizar una anotazión, o cualquier tarea
// que necesitemos sin ser dependientes realmente del
// navegador.
?>

Notas

PHP no detectará que el usuario abortó la conexión hasta que se haga un intento de enviar información al cliente. Usar simplemente una sentencia echo no garantiza que la información sea enviada, veáse flush().

Ver también

add a note add a note

User Contributed Notes 5 notes

up
13
spiritual-coder at spiritual-coder dot com
8 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
lukas dot starecek at centrum dot cz
4 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
1
Anonymous
5 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
0
plamen at pulsator dot com
13 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
-8
phpguy92135 at yahoo dot com
5 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