ignore_user_abort

(PHP 4, PHP 5, PHP 7)

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

Descripción

ignore_user_abort ([ bool $value ] ) : int

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

Cuando se ejecuta PHP como un script de línea de comandos, y el tty del script finaliza sin que el script haya terminado, el script cesará su ejecución 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 integer.

Ejemplos

Ejemplo #1 Un ejemplo ignore_user_abort()

<?php
// Ignorar los abortos hechos por el usuario y permitir que el script
// se ejecute 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 tanto, aquí podemos realizar una anotación o cualquier
// otra tarea que sea necesaria sin depender 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