session_unset

(PHP 4, PHP 5, PHP 7, PHP 8)

session_unset — Освобождает переменные сессии

Описание

session_unset(): bool

Функция session_unset() удаляет переменные текущей сессии, которые зарегистрировали прежде.

Список параметров

У этой функции нет параметров.

Возвращаемые значения

Функция возвращает true, если выполнилась успешно, или false, если возникла ошибка.

Список изменений

Версия	Описание
7.2.0	Теперь функция возвращает тип bool. Раньше функция возвращала тип void.

Примечания

Замечание:
Переменные сессии в суперглобальном массиве $_SESSION удаляют конструкцией unset(): unset($_SESSION['varname']);.

Предостережение

Сам массив $_SESSION удалять вызовом unset($_SESSION) НЕ нужно, поскольку это не даст зарегистрировать новые переменные сессии через суперглобальный массив $_SESSION.

Замечание:
Вызов функции session_unset() идентичен выражению $_SESSION = [].

Предостережение

Функция работает только при активной сессии. Функция не очистит массив $_SESSION, если сессию ещё не запустили или уже уничтожили. Выражение $_SESSION = [] удалит все переменные сессии, даже если сессия неактивна.

Нашли ошибку?

Инструкция • Исправление • Сообщение об ошибке

＋Добавить

Примечания пользователей 3 notes

down

tim at leethost dot com ¶

12 years ago

I was having a problem clearing all session variables, deleting the session, and creating a new session without leaving old session stuff behind in all browsers.  The below code is perfect for a logout script to totally delete everything and start new.  It even works in Chrome which seems to not work as other browsers when trying do logout and start a new session.

<?php
    session_start();
    session_unset();
    session_destroy();
    session_write_close();
    setcookie(session_name(),'',0,'/');
    session_regenerate_id(true);
?>

down

jerry ¶

9 years ago

The difference between both session_unset and session_destroy is as follows:

session_unset just clears out the session for usage. The session is still on the users computer. Note that by using session_unset, the variable still exists. session_unset just remove all session variables. it does not destroy the session....so the session would still be active.

Using session_unset in tandem with session_destroy however, is a much more effective means of actually clearing out data. As stated in the example above, this works very well, cross browser. session_destroy is destroy the session. session_destroy() to kill all session information.....This is the more secure function to use.

down

christian+php at ¶

5 months ago

The solution provided by tim at leethost dot com is nice but you must check a active session first, because else you fill the logs with PHP Errors or Notices depending on your settings. I use it as a function, and it works smooth. 

```php
    /** @return void  */
    public static function sayonara():void
    {
        if (session_status() !== PHP_SESSION_ACTIVE) :void
        {
            session_start();
            session_unset();
            session_destroy();
            session_write_close();
            setcookie(session_name(), '', 0, '/');
            session_regenerate_id(true);
        }        
    }

    sayonara();
```

＋Добавить