array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'ru', ), 'this' => array ( 0 => 'sessionhandler.gc.php', 1 => 'SessionHandler::gc', 2 => 'Очищает старые сессии', ), 'up' => array ( 0 => 'class.sessionhandler.php', 1 => 'SessionHandler', ), 'prev' => array ( 0 => 'sessionhandler.destroy.php', 1 => 'SessionHandler::destroy', ), 'next' => array ( 0 => 'sessionhandler.open.php', 1 => 'SessionHandler::open', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'ru', 'path' => 'reference/session/sessionhandler/gc.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

SessionHandler::gc

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

SessionHandler::gc — Очищает старые сессии

Описание

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

Очищает сессии с истёкшим сроком жизни. Вызывается случайным образом изнутри 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.