connection_timeout()

connection_aborted()

Einführung in die Funktion connection_aborted()

Die Funktion connection_aborted() in PHP wird verwendet, um zu prüfen, ob der Client die Verbindung zum Webserver abgebrochen hat. Beachte, dass diese Funktion nur mit Web-Server-SAPIs (wie Apache oder Nginx) funktioniert und in der CLI-SAPI nicht verfügbar ist. Sie ist vor allem in lang laufenden Skripten oder Batch-Prozessen nützlich, bei denen eine Trennung durch den Client die Ausführung stoppen soll. Im Gegensatz zu serverseitigen Timeouts erkennt diese Funktion gezielt, wenn der Client-Browser oder ein Skript die Verbindung vorzeitig schließt.

Verwendung der Funktion connection_aborted()

Die Funktion connection_aborted() gibt einen boolean-Wert (true oder false) zurück. Numerisch ausgewertet entspricht true dem Wert 1 (was anzeigt, dass der Client die Verbindung abgebrochen hat), und false entspricht 0 (was anzeigt, dass die Verbindung noch aktiv ist).

Beispiel zur Verwendung der Funktion connection_aborted()

Hier ist ein Beispiel, wie die Funktion connection_aborted() in PHP eingesetzt werden kann:

<?php

// Typically used in long-running scripts or loops to detect client disconnection
if (connection_aborted()) {
  // Clean up resources or stop processing
  // e.g., close open files, release locks, or log the disconnection event
} else {
  // Continue normal execution
}

In diesem Beispiel wird die Funktion connection_aborted() aufgerufen, um zu prüfen, ob der Client die Verbindung abgebrochen hat. Der Rückgabewert entscheidet dann, welche Aktion ausgeführt wird.

Bei lang laufenden Skripten wird sie häufig innerhalb einer Schleife verwendet, um die Ausführung frühzeitig zu beenden:

<?php
$processing = true;

while ($processing) {
  // Perform a chunk of work
  do_work();

  // Check if the client has disconnected
  if (connection_aborted()) {
    $processing = false; // Break the loop early
  }
}
?>

Fazit

Zusammenfassend lässt sich sagen, dass die Funktion connection_aborted() in PHP nützlich ist, um zu prüfen, ob der Client die Verbindung abgebrochen hat, und um basierend auf dem Verbindungsstatus geeignete Maßnahmen zu ergreifen.

Übungen