session_gc
(PHP 7 >= 7.1.0, PHP 8)
session_gc — Складання сміття даних сесії
Опис
session_gc(): int|false
session_gc() використовується для виконання складання сміття (garbage collection) для даних сесії. За промовчанням PHP виконує засновану на ймовірності складання сміття сесії.
Складання сміття, що базується на ймовірності в цілому працює, але має кілька проблем. 1) На низькозавантажених сайтах дані сесії можуть бути видалені протягом бажаного часу. 2) На високозавантажених сайтах складання сміття може виконуватися надто часто. 3) Складання сміття виконується під час обробки запиту користувача, що призводить до додаткової затримки користувача.
Тому рекомендується виконувати складання сміття на робочих системах періодично, наприклад, використовувати завдання cron у UNIX-подібних системах. При цьому переконайтеся, що вимкнули складання сміття на основі ймовірності, встановивши session.gc_probability 0.
Список параметрів
Ця функція не має параметрів.
Значення, що повертаються
session_gc() повертає кількість віддалених даних сесії при успішному виконанні та **false**в случае неудачи.
Старі обробники сесії не повертають кількість віддалених даних сесії, а лише прапор успіху/невдачі. У цьому випадку, число віддалених даних сесії завжди буде рівним 1, незалежно від фактичної кількості віддалених даних.
Приклади
Приклад #1 Приклад використання session_gc()** у диспетчерах завдань, таких як cron**
Приклад #2 Приклад використання session_gc()** у скрипті, доступному користувачеві**
Дивіться також
- session_start() - Стартує нову сесію, або відновлює існуючу
- session_destroy() - Знищує всі дані сесії
- session.gc_probability