SessionHandler::gc

(PHP 5 >= 5.4.0, PHP 7, PHP 8)

SessionHandler::gc — Löscht alte Sessions

Beschreibung

public SessionHandler::gc(int $max_lifetime): int|false

Löscht abgelaufene Sessions. Wird zufällig von PHP intern aufgerufen, wenn eine Session beginnt oder wenn die Funktion session_start() aufgerufen wird. Wie oft dies aufgerufen wird, hängt von den Konfigurationsanweisungen session.gc_divisor und session.gc_probability ab.

Diese Methode ist ein Wrapper für den in der INI-Einstellung session.save_handler definierten internen PHP-Speicherverwalter, der gesetzt wird, bevor er mittels session_set_save_handler() gesetzt wird.

Wenn diese Klasse durch Vererbung erweitert wird, wird durch den Aufruf der übergeordneten gc-Methode der Wrapper für diese Methode und damit der zugehörige interne Callback aufgerufen. Dadurch kann diese Methode überschrieben und/oder abgefangen und gefiltert werden.

Weitere Informationen darüber, welche Aufgaben diese Methode erfüllen soll, sind in der Dokumentation unter SessionHandlerInterface::gc() zu finden.

Parameter-Liste

max_lifetime: Sessions, die in den letzten max_lifetime Sekunden nicht aktualisiert wurden, werden entfernt.

Rückgabewerte

Gibt bei Erfolg die Anzahl der gelöschten Sessions zurück. Bei einem Fehler wird false zurückgegeben. Es ist zu beachten, dass dieser Wert intern an PHP zur Verarbeitung zurückgegeben wird.

Changelog

Version	Beschreibung
7.1.0	Vor dieser Version gab diese Funktion bei Erfolg `true` zurück.

add a note

User Contributed Notes

There are no user contributed notes for this page.