CONNECTION_ABORTED |
Connexion annulé |
| PHP 4+ |
Syntaxe
|
function connection_aborted();
|
Retour
| Valeur |
Description |
| 0 |
Cette valeur permet d'indiquer qu'une erreur s'est produite. |
| 1 |
Cette valeur permet d'indiquer que l'opération s'est correctement effectué. |
Description
Cette fonction permet de vérifier sur l'internaute a effectué une déconnexion HTTP.
Remarques
- La fonction connection_aborted() est utile pour détecter une interruption de la connexion HTTP côté client : Elle permet de savoir si l'internaute a
quitté la page ou fermé son navigateur avant la fin de l'exécution du script, ce qui est particulièrement pertinent dans les traitements longs.
- Le retour de connection_aborted() est un entier logique : 1 pour une connexion interrompue, 0 sinon : Il ne s'agit pas d'un booléen typique, ce
qui peut prêter à confusion lors de l'analyse des résultats, notamment si on ne fait pas attention à la documentation.
- Cette fonction est souvent utilisée en combinaison avec ignore_user_abort() : Grâce à cette combinaison, un script peut soit continuer malgré la
déconnexion de l'utilisateur, soit interrompre proprement son traitement en tenant compte de l'état de la connexion.
- Elle prend tout son sens dans les scripts de traitement en arrière-plan (batch, export, upload) : Lors d'opérations longues, il est important de savoir
si le client est toujours en ligne afin d'éviter des traitements inutiles ou de libérer des ressources plus tôt.
- La fonction repose sur le comportement du serveur Web, notamment Apache ou
Nginx, et le tampon de sortie : Il est important que les entêtes aient été envoyés
(flush() ou ob_flush()) pour que le serveur détecte réellement une interruption côté client.
- connection_aborted() ne détecte pas immédiatement les coupures de réseau ou déconnexions intempestives : Il peut y avoir un léger délai avant que
l'état de la connexion soit mis à jour, ce qui signifie qu'une vérification immédiate après l'envoi initial peut ne pas détecter l'interruption.
- Elle fait partie d'un trio de fonctions avec connection_status() et connection_timeout() : Ensemble, ces fonctions permettent une gestion
plus fine des erreurs de communication HTTP entre le client et le serveur dans les scripts PHP.
- Elle est très utile dans les systèmes où des ressources critiques sont engagées, comme les réservations ou les traitements bancaires : En vérifiant si
l'utilisateur est encore connecté, le script peut décider de ne pas finaliser une transaction ou de journaliser un événement d'interruption anormale.
Dernière mise à jour : Mercredi, le 25 mars 2015
