CONNECTION_STATUS

Syntaxe

Retour

Description

Cette fonction permet de demander les bits d'état de la connexion HTTP.

Remarques

• connection_status() est essentielle pour vérifier l'état de la connexion HTTP en cours : Elle retourne une valeur entière représentant un ensemble de bits qui décrivent si la connexion a été interrompue, fermée, ou si une erreur est survenue. Cela permet de prendre des décisions en temps réel lors de l'exécution du script.
• Cette fonction est particulièrement utile pour les scripts longs ou interactifs : Dans les cas où un script génère du contenu pendant une longue période (exemple génération de rapports), connection_status() permet de détecter si l'utilisateur a fermé la page ou interrompu la requête.
• Une valeur de retour 0 indique que la connexion est intacte : Cela signifie que le client est encore connecté, et que le script peut continuer à envoyer du contenu en toute sécurité. Toute autre valeur indique une interruption ou une erreur.
• Les valeurs possibles incluent CONNECTION_ABORTED, CONNECTION_TIMEOUT et CONNECTION_NORMAL : Ces constantes permettent une interprétation plus lisible des états retournés. Elles sont utiles pour structurer un traitement conditionnel clair, par exemple : if (connection_status() === CONNECTION_ABORTED).
• Cette fonction est souvent combinée avec ignore_user_abort() : En utilisant ignore_user_abort(true), le script peut continuer son exécution même si l'utilisateur se déconnecte, tout en surveillant avec connection_status() pour décider d'un comportement conditionnel.
• Elle peut servir à libérer des ressources plus tôt si l'utilisateur s'est déconnecté : Cela permet d'éviter un gaspillage de mémoire ou de traitement serveur inutile en interrompant une tâche en cours dès qu'elle devient non pertinente.
• connection_status() est compatible avec les systèmes de gestion de tampons de sortie : Il est recommandé de vider régulièrement les tampons avec ob_flush() et flush() pour que les vérifications de connexion soient plus précises et reflètent mieux la réalité côté client.
• Bien qu'ancienne, cette fonction reste utile dans les architectures PHP modernes : Elle garde sa pertinence dans les applications en ligne critiques ou interactives où il est nécessaire de suivre le statut de la session utilisateur à la volée.