SessionHandler::gc

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

SessionHandler::gc — Nettoie les anciennes sessions

Description

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

Nettoie les sessions expirées. Appelé aléatoirement en interne par PHP lorsqu'une session démarre ou lorsque la fonction session_start() est appelée. La fréquence d'appel est basée sur les directives de configuration session.gc_divisor et session.gc_probability.

Cette méthode se substitue au gestionnaire interne de sauvegarde PHP défini via l'option de configuration session.save_handler qui a été définie avant que ce dernier ne le soit via la fonction session_set_save_handler().

Si cette classe est Ă©tendue par hĂ©ritage, l'appel Ă  la mĂ©thode parente gc invoquera l'enveloppe pour cette mĂ©thode, mais aussi, invoquera en interne la fonction de rappel associĂ©e. Ce comportement permet Ă  cette mĂ©thode d'ĂȘtre surchargĂ©e ou bien d'ĂȘtre interceptĂ©e et filtrĂ©e.

Pour plus d'informations sur l'attendu de cette méthode, se référer à la documentation sur la fonction SessionHandlerInterface::gc().

Liste de paramĂštres

max_lifetime

Les sessions qui n'auront pas été mises à jour les derniÚres max_lifetime secondes seront supprimées.

Valeurs de retour

Retourne le nombre de sessions supprimées en cas de succÚs, ou false si une erreur survient. Il est à noter que cette valeur est retournée en interne à PHP pour traitement.

Historique

Version Description
7.1.0 Antérieur à cette version, cette fonction retournait true en cas de succÚs.
add a note

User Contributed Notes

There are no user contributed notes for this page.