session_destroy 销毁一个会话中的全部数据
发表日期:2021-07-01 08:56:51 | 来源: | | 浏览(847) 分类:Session 函数
session_destroy
(PHP 4, PHP 5, PHP 7, PHP 8)
session_destroy — 销毁一个会话中的全部数据
说明
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
- PHP(0)
- PHP杂项(34)
- PHP基础-李炎恢系列课程(20)
- 中文函数手册(0)
- 错误处理 函数(13)
- OPcache 函数(6)
- PHP 选项/信息 函数(54)
- Zip 函数(10)
- Hash 函数(15)
- OpenSSL 函数(63)
- Date/Time 函数(51)
- 目录函数(9)
- Fileinfo 函数(6)
- iconv 函数(11)
- 文件系统函数(81)
- 多字节字符串 函数(57)
- GD 和图像处理 函数(114)
- 可交换图像信息(5)
- Math 函数(50)
- 程序执行函数(11)
- PCNTL 函数(23)
- JSON 函数(4)
- SPL 函数(15)
- URL 函数(10)
- cURL 函数(32)
- 网络 函数(33)
- FTP 函数(36)
- Session 函数(23)
- session_abort Discard session array changes and finish session(0)
- session_cache_expire 返回当前缓存的到期时间(0)
- session_cache_limiter 读取/设置缓存限制器(0)
- session_commit session_write_close() 的别名(0)
- session_create_id Create new session id(0)
- session_decode 解码会话数据(0)
- session_destroy 销毁一个会话中的全部数据(0)
- session_encode 将当前会话数据编码为一个字符串(0)
- session_gc Perform session data garbage collection(0)
- session_get_cookie_params 获取会话 cookie 参数(0)
- session_id 获取/设置当前会话 ID(0)
- session_module_name 获取/设置会话模块名称(0)
- session_name 读取/设置会话名称(0)
- session_regenerate_id 使用新生成的会话 ID 更新现有会话 ID(0)
- session_register_shutdown 关闭会话(0)
- session_reset Re-initialize session array with original values(0)
- session_save_path 读取/设置当前会话的保存路径(0)
- session_set_cookie_params 设置会话 cookie 参数(0)
- session_set_save_handler 设置用户自定义会话存储函数(0)
- session_start 启动新会话或者重用现有会话(0)
- session_status 返回当前会话状态(0)
- session_unset 释放所有的会话变量(0)
- session_write_close Write session data and end session(0)
- PCRE 函数(11)
- PCRE 正则语法(19)
- 数组 函数(81)
- 类/对象 函数(18)
- 函数处理 函数(13)
- 变量处理 函数(37)
- SimpleXML 函数(3)
- 杂项 函数(31)
- 字符串 函数(101)