PHP - Manual: session_destroy

2024-11-14

session_encode »

« session_decode

session_destroy

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

session_destroy — 销毁一个会话中的全部数据

说明

session_destroy(): bool

session_destroy() 销毁当前会话中的全部数据，但是不会重置当前会话所关联的全局变量，也不会重置会话 cookie。如果需要再次使用会话变量，必须重新调用 session_start() 函数。

注意: 通常情况下，在你的代码中不必调用 session_destroy() 函数，可以直接清除 $_SESSION 数组中的数据来实现会话数据清理。

为了彻底销毁会话，必须同时重置会话 ID。如果是通过 cookie 方式传送会话 ID 的，那么同时也需要调用 setcookie() 函数来删除客户端的会话 cookie。

当启用了 session.use_strict_mode 配置项的时候，你不需要删除过期会话 ID 对应的 cookie，因为会话模块已经不再接受携带过期会话 ID 的 cookie 了，然后它会生成一个新的会话 ID cookie。建议所有的站点都启用 session.use_strict_mode 配置项。

警告

过早的删除会话中的数据可能会导致不可预期的结果。例如，当存在从 JavaScript 或者 URL 链接过来的并发请求的时候，某一个请求删除了会话中的数据，会导致其他的并发请求无法使用会话数据。

虽然当前的会话处理模块不会接受为空的会话 ID，但是由于客户端（浏览器）的处理方式，立即删除会话中的数据可能会导致生成为空的会话 cookie，进而导致客户端生成很多不必要的会话 ID cookie。

为了避免这种情况的发生，你需要在 $_SESSION 中设置一个时间戳，在这个时间戳之后的对于会话的访问都将被拒绝。或者，确保你的应用中不存在并发请求。这个规则同样适用于 session_regenerate_id()。

返回值

成功时返回 true，或者在失败时返回 false。

范例

示例 #1 销毁会话数据以及 $_SESSION


<?php
// 初始化会话。
// 如果要使用会话，别忘了现在就调用：
session_start();

// 重置会话中的所有变量
$_SESSION = array();

// 如果要清理的更彻底，那么同时删除会话 cookie
// 注意：这样不但销毁了会话中的数据，还同时销毁了会话本身
if (ini_get("session.use_cookies")) {
    $params = session_get_cookie_params();
    setcookie(session_name(), '', time() - 42000,
        $params["path"], $params["domain"],
        $params["secure"], $params["httponly"]
    );
}

// 最后，销毁会话
session_destroy();
?>

注释

注意:
对于旧版本中不使用 $_SESSION 的代码，仅能使用 session_unset() 来完成会话销毁工作。

参见

session.use_strict_mode
session_reset() - Re-initialize session array with original values
session_regenerate_id() - 使用新生成的会话 ID 更新现有会话 ID
unset() - 释放给定的变量
setcookie() - 发送 Cookie

add a note

User Contributed Notes 4 notes

down

Praveen V ¶

9 years ago


If you want to change the session id on each log in, make sure to use session_regenerate_id(true) during the log in process.


<?php

session_start();

session_regenerate_id(true);

?>



[Edited by moderator (googleguy at php dot net)]

down

Jack Luo ¶

8 years ago


It took me a while to figure out how to destroy a particular session in php. Note I'm not sure if solution provided below is perfect but it seems work for me. Please feel free to post any easier way to destroy a particular session. Because it's quite useful for functionality of force an user offline.

1. If you're using db or memcached to manage session, you can always delete that session entry directly from db or memcached.

2. Using generic php session methods to delete a particular session(by session id).

<?php
$session_id_to_destroy = 'nill2if998vhplq9f3pj08vjb1';
// 1. commit session if it's started.
if (session_id()) {
    session_commit();
}

// 2. store current session id
session_start();
$current_session_id = session_id();
session_commit();

// 3. hijack then destroy session specified.
session_id($session_id_to_destroy);
session_start();
session_destroy();
session_commit();

// 4. restore current session id. If don't restore it, your current session will refer to the session you just destroyed!
session_id($current_session_id);
session_start();
session_commit();

?>

down

-19

JBH ¶

4 years ago


I'm using PHP 7.1 and received the following warning when implementing Example #1, above:

    PHP message: PHP Warning:  session_destroy(): Trying to destroy uninitialized session in...

What I discovered is that clearing $_SESSION and removing the cookie destroys the session, hence the warning.  To avoid the warning while still keeping the value of using session_destroy(), do this after everything else:

    if (session_status() == PHP_SESSION_ACTIVE) { session_destroy(); }

down

-7

greald at gmail dot com ¶

1 year ago


All of a sudden neither session_destroy() nor $_SESSION=[] were sufficient to log out. I found the next to work:
<?php
setcookie(session_name(), session_id(), 1); // to expire the session
$_SESSION = [];
?>

add a note

官方地址：https://www.php.net/manual/en/function.session-destroy.php

有任何技术问题请点击这里网站运营推广招聘

IT PHP 编程语言 Linux 开发编程科技 Elasticsearch HTML/CSS/XML 网络 JAVA NoSQL 数据库面试 C/C++ Golang Git 算法操作系统正则表达式 Redis 互联网 MySql JavaScript 运维软件国际架构设计 Mac OS TCP/IP Excel Vim Windows Socket Oracle VR MongoDB Python 运营 MemCache 商业硬件电子娱乐设计 nginx 摄影游戏 WordPress HTTP 团建数码电器

php7 安装fileinfo扩展 preg_split — 通过一个正则表达式分隔字符串 php位值,解决 PHP 中 usort 在值相同时改变原始位置的问题 [PHP] inet_pton/inet_ntop IP地址转换函数 array_multisort() 多字段排序 PHPMailer设置utf8 PHPMailer字符集CharSet ADORecordSet对象 adodb手册 PHP 8.1 [鸟哥]PHP_INT_MIN 和 -9223372036854775808 opcache预加载 Composer的Packagist资源 mysql面试题 [鸟哥]PHP FFI详解 - 一种全新的PHP扩展方式 PHP7添加redis扩展 PHP mkdir()写出来的权限与mode值不符合 Packagist / Composer 中国全量镜像支持php7的性能采集扩展 php $_SERVER中的SERVER_NAME 和HTTP_HOST的区别 adodb连接mysql多个数据库的问题

略微加速

PHP官方手册 - 互联网笔记

session_destroy

说明

返回值

范例

注释

参见

User Contributed Notes 4 notes