PHP
Referenzliste
connection_status
Sonstige-Funktionen
Befehl:
int connection_status ( void )
Beschreibung:
Gibt den Verbindungsstatus als Bitfeld zurück.
Aktiv in Version:
(PHP 4, PHP 5, PHP 7)
Siehe auch:
Überprüft, ob die Verbindung zum Client beendet wurde
Stellt ein, ob der Verbindungsabbruch eines Clients die Skript-Ausführung abbrechen soll
connection_status() - Beispiel
Eingabe:
Noch kein Beispiel vorhanden.
Beschreibung:
Mit connection_status() kann man sich den internen Verbindungsstatus von PHP zur�ckgeben lassen.
Folgende drei (bzw. vier - siehe unten) Zustandsm�glichkeiten k�nnen eintreten:
� 0 - NORMAL
� 1 - ABORTED
� 2 - TIMEOUT
� 3 - ABORTED und TIMEOUT
Ein aktives PHP-Skript hat normalerweise den Status NORMAL, es sei denn, dass durch irgendein Vorkommnis dieser Status ge�ndert wird. Dabei gibt es mehrere M�glichkeiten. Zum einen kann der User das laufende Skript abbrechen und somit den Status auf ABORTED setzen, oder es kann vorkommen, dass das Skript l�nger l�uft, als das eingestellte Zeitlimit zul�sst (Standard-Timeout in der Apache-Konfigurationsdatei ist 30 Sekunden, oder �ber set_time_limit() eine vorgegebene Zeit). Bei �berschreiten dieses Limits wird der Verbindungsstatus auf TIMEOUT gesetzt. Anhand dieser drei Werte kann man nun entscheiden, wie man mit diesem Status umgehen m�chte. Oftmals will man gerade beim Abbruch durch den User noch wichtige Daten retten. Beachten Sie bitte, dass die Funktion connection_status() gleichzeitig den Staus ABORTED und TIMEOUT besitzen kann. Dies geschieht gerade dann, wenn man mit der Funkton ignore_user_abort() den Benutzerabbruch unterbindet. Dennoch kann es zu einem TIMEOUT kommen. In diesem Fall gibt die Funktion den Wert 3 (ABORTED + TIMEOUT) zur�ck, weil neben dem Timeout auch der (folgenlose) Benutzerabbruch registriert wurde.
Folgende drei (bzw. vier - siehe unten) Zustandsm�glichkeiten k�nnen eintreten:
� 0 - NORMAL
� 1 - ABORTED
� 2 - TIMEOUT
� 3 - ABORTED und TIMEOUT
Ein aktives PHP-Skript hat normalerweise den Status NORMAL, es sei denn, dass durch irgendein Vorkommnis dieser Status ge�ndert wird. Dabei gibt es mehrere M�glichkeiten. Zum einen kann der User das laufende Skript abbrechen und somit den Status auf ABORTED setzen, oder es kann vorkommen, dass das Skript l�nger l�uft, als das eingestellte Zeitlimit zul�sst (Standard-Timeout in der Apache-Konfigurationsdatei ist 30 Sekunden, oder �ber set_time_limit() eine vorgegebene Zeit). Bei �berschreiten dieses Limits wird der Verbindungsstatus auf TIMEOUT gesetzt. Anhand dieser drei Werte kann man nun entscheiden, wie man mit diesem Status umgehen m�chte. Oftmals will man gerade beim Abbruch durch den User noch wichtige Daten retten. Beachten Sie bitte, dass die Funktion connection_status() gleichzeitig den Staus ABORTED und TIMEOUT besitzen kann. Dies geschieht gerade dann, wenn man mit der Funkton ignore_user_abort() den Benutzerabbruch unterbindet. Dennoch kann es zu einem TIMEOUT kommen. In diesem Fall gibt die Funktion den Wert 3 (ABORTED + TIMEOUT) zur�ck, weil neben dem Timeout auch der (folgenlose) Benutzerabbruch registriert wurde.
Sonstige-Funktionen