(PHP 4, PHP 5, PHP 7, PHP 8)
ignore_user_abort — Active l'interruption de script sur déconnexion du visiteur
$enable = null): intignore_user_abort() active l'option qui fait que, lors de la déconnexion du client Web, le script poursuit son exécution.
Lorsque PHP est exécuté comme script en ligne de commande, et que
le tty du script est fermé sans que le script soit terminé, alors le script
s'arrêtera dès qu'il essaiera d'écrire quelque chose, à moins que
enable soit true
enable
Si définis et non null, la fonction va attribuer à la directive
ignore_user_abort la
valeur de enable. Si omis, cette
fonction ne fait que retourner la valeur de la configuration
courante.
Retourne la configuration précédente, sous la forme d'un entier.
| Version | Description |
|---|---|
| 8.0.0 |
enable est désormais nullable.
|
Exemple #1 Exemple avec ignore_user_abort()
<?php
// Ignore la déconnexion de l'utilisateur et autorise
// le script à continuer de s'exécuter
ignore_user_abort(true);
set_time_limit(0);
echo 'Test du gestionnaire de connexion de PHP';
// Exécution d'une boucle infinie surveillant
// l'activité de l'utilisateur. Soit il clique en dehors
// de la page, soit il clique sur le boutton "Stop".
while(1)
{
// La connexion a-t-elle échoué ?
if(connection_status() != CONNECTION_NORMAL)
{
break;
}
// On attend 10 secondes
sleep(10);
}
// Si c'est atteint, alors l'instruction 'break'
// sera lancée depuis la boucle infinie
// Aussi, nous pouvons à ce niveau entrer des informations dans l'historique,
// ou exécuter d'autres taches nécessaires, sans pour autant être dépendant
// du navigateur.
?>
PHP ne détecte pas la déconnexion du client Web jusqu'à ce qu'une tentative d'envoi soit faite. La simple utilisation d'un echo ne garantit pas que l'information est envoyée, voir la fonction flush().
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);
?>
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.
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.
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
If running a long process and the browser often close the connection, then use this function.
The script should output something to the browser in order to abort. If there is no output the script keeps on running.
