SessionHandler::gc
(PHP 5 >= 5.4.0, PHP 7, PHP 8)
SessionHandler::gc — Очищает старые сессии
Описание
Очищает сессии с истёкшим сроком жизни. Вызывается случайным образом изнутри PHP когда сессия стартует или когда вызвана функция session_start(). Частота, с которой она вызывается, основана на значении параметров конфигурации session.gc_divisor и session.gc_probability.
Этот метод обёртывает внутренний обработчик сессии определённый в настройке ini-файла session.save_handler который устанавливается перед тем, как определяется данный обработчик в функции session_set_save_handler().
Если этот класс расширяется путём наследования, вызов родительского метода
gc выполнит код обёртки для этого метода, а также внутренний
обработчик. Это позволит методу быть переопределённым, или перехваченным
и отфильтрованным.
Для дополнительной информации о том, что ожидается от реализации этого метода смотрите документацию по методу SessionHandlerInterface::gc().
Список параметров
-
max_lifetime -
Сессии, которые не были обновлены в течение последних
max_lifetimeсекунд удаляются.
Возвращаемые значения
В случае успешного выполнения возвращает количество удалённых сессий или false в случае возникновения ошибки.
Обратите внимание, что это значение возвращается внутрь PHP для обработки.
Список изменений
| Версия | Описание |
|---|---|
| 7.1.0 |
До этой версии, в случае успешного выполнения эта функция возвращала true.
|
add a note
