ignore_user_abort
(PHP 4, PHP 5, PHP 7, PHP 8)
ignore_user_abort — Legt fest, ob der Verbindungsabbruch eines Clients die Skript-Ausführung abbrechen soll
Beschreibung
$enable = null): intSetzt den Wert dafür, ob der Abbruch einer Client-Verbindung die weitere Abarbeitung eines Skripts beenden soll.
Wird PHP als Kommondozeilen-Skript ausgeführt, und das TTY des Skripts wird
entfernt ohne dass das Skript terminiert wurde, dann stirbt das Skript beim
nächsten Versuch etwas zu schreiben, außer wenn
enable auf true gesetzt ist.
Parameter-Liste
-
enable -
Sofern dieser Parameter angegeben wird und nicht
nullist, überschreibt diese Funktion die aktuelle Einstellung von ignore_user_abort mit dem übergebenenenable. Andernfalls gibt die Funktion nur die aktuelle Einstellung zurück, ohne sie zu verändern.
Rückgabewerte
Gibt das vorhergehende Setting als Ganzzahl (Integer) zurück.
Changelog
| Version | Beschreibung |
|---|---|
| 8.0.0 |
enable ist nun ein Nullable-Typ.
|
Beispiele
Beispiel #1 Ein ignore_user_abort()-Beispiel
<?php
// Ignoriere Abbruch durch den Benutzer und erlaube dem Skript weiterzulaufen
ignore_user_abort(true);
set_time_limit(0);
echo 'Teste Connectionhandling in PHP';
// Lasse eine sinnfreie Schleife laufen, die uns irgendwann
// hoffentlich von der Seite wegklicken oder den "Stop"-Button
// betätigen lässt
while(1)
{
// Schlug die Verbindung fehl?
if(connection_status() != CONNECTION_NORMAL)
{
break;
}
// 10 Sekunden warten
sleep(10);
}
// Wird dieser Punkt erreicht, wurde das 'break'
// von einem Punkt innerhalb der while-Schleife getriggert
// Somit können wir hier ein Log schreiben oder andere Aufgaben
// ausführen, die nicht davon abhängig sind, ob der Browser des
// Benutzers noch eine stehende Verbindung zum Server hat
?>
Anmerkungen
PHP wird nicht herausfinden, ob ein Benutzer die Verbindung abgebrochen hat, bevor es nicht versucht, Informationen an den Client zu senden. Die einfache Verwendung eines echo-Statements ist keine Garantie dafür, dass eine Information übertragen wurde, lesen Sie daher auch die Dokumentation zu flush().
Siehe auch
- connection_aborted() - Überprüft, ob die Verbindung zum Client beendet wurde
- connection_status() - Liefert den Verbindungsstatus als Bitfeld
- Die Verbindungssteuerung mit einer kompletten Beschreibung der Verbindungssteuerung in PHP.
