session_set_save_handler
session_set_save_handler — 设置用户自定义会话存储函数
说明
session_set_save_handler ( callable $open
, callable $close
, callable $read
, callable $write
, callable $destroy
, callable $gc
[, callable $create_sid
[, callable $validate_sid
[, callable$update_timestamp
]]] ) : bool
自 PHP 5.4 开始,可以使用下面的方式来注册自定义会话存储函数:
session_set_save_handler ( object $sessionhandler
[, bool $register_shutdown
= TRUE
] ) : bool
session_set_save_handler() 设置用户自定义 会话存储函数。 如果想使用 PHP 内置的会话存储机制之外的方式, 可以使用本函数。 例如,可以自定义会话存储函数来将会话数据存储到数据库。
参数
本函数有 2 种原型:
sessionhandler
实现了 SessionHandlerInterface, SessionIdInterface 和/或 SessionUpdateTimestampHandlerInterface 接口的对象, 例如 SessionHandler。 自 PHP 5.4 之后可以使用。
register_shutdown
将函数 session_write_close() 注册为 register_shutdown_function() 函数。
或者
open(string $savePath, string $sessionName)
open 回调函数类似于类的构造函数, 在会话打开的时候会被调用。 这是自动开始会话或者通过调用 session_start() 手动开始会话 之后第一个被调用的回调函数。 此回调函数操作成功返回 TRUE
,反之返回 FALSE
。
close()
close 回调函数类似于类的析构函数。 在 write 回调函数调用之后调用。 当调用 session_write_close() 函数之后,也会调用 close 回调函数。 此回调函数操作成功返回 TRUE
,反之返回 FALSE
。
read(string $sessionId)
如果会话中有数据,read 回调函数必须返回将会话数据编码(序列化)后的字符串。 如果会话中没有数据,read 回调函数返回空字符串。
在自动开始会话或者通过调用 session_start() 函数手动开始会话之后,PHP 内部调用 read 回调函数来获取会话数据。 在调用 read 之前,PHP 会调用 open 回调函数。
read 回调返回的序列化之后的字符串格式必须与 write
回调函数保存数据时的格式完全一致。 PHP 会自动反序列化返回的字符串并填充 $_SESSION 超级全局变量。 虽然数据看起来和 serialize() 函数很相似, 但是需要提醒的是,它们是不同的。 请参考: session.serialize_handler。
write(string $sessionId, string $data)
在会话保存数据时会调用 write
回调函数。 此回调函数接收当前会话 ID 以及 $_SESSION 中数据序列化之后的字符串作为参数。 序列化会话数据的过程由 PHP 根据 session.serialize_handler 设定值来完成。
序列化后的数据将和会话 ID 关联在一起进行保存。 当调用 read
回调函数获取数据时,所返回的数据必须要和 传入 write
回调函数的数据完全保持一致。
PHP 会在脚本执行完毕或调用 session_write_close() 函数之后调用此回调函数。 注意,在调用完此回调函数之后,PHP 内部会调用 close
回调函数。
Note:
PHP 会在输出流写入完毕并且关闭之后 才调用 write 回调函数, 所以在 write 回调函数中的调试信息不会输出到浏览器中。 如果需要在 write 回调函数中使用调试输出, 建议将调试输出写入到文件。
destroy($sessionId)
当调用 session_destroy() 函数, 或者调用 session_regenerate_id() 函数并且设置 destroy 参数为 TRUE
时, 会调用此回调函数。此回调函数操作成功返回 TRUE
,反之返回 FALSE
。
gc($lifetime)
为了清理会话中的旧数据,PHP 会不时的调用垃圾收集回调函数。 调用周期由 session.gc_probability 和 session.gc_divisor 参数控制。 传入到此回调函数的 lifetime 参数由 session.gc_maxlifetime 设置。 此回调函数操作成功返回 TRUE
,反之返回 FALSE
。
create_sid()
当需要新的会话 ID 时被调用的回调函数。 回调函数被调用时无传入参数, 其返回值应该是一个字符串格式的、有效的会话 ID。
返回值
成功时返回 TRUE
, 或者在失败时返回 FALSE
。
<?php
class RedisSession implements \SessionHandlerInterface
{
private $redis;
private $expTime = 30; // 默认超时时间 根据业务场景设置
function __construct(){
$this->redis = new Redis();
$this->redis->connect('127.0.0.1',6379);
// 设置session处理回调 并且将session_write_close注册为register_shutdown_function函数
session_set_save_handler($this, true);
// 开启
session_start();
}
function open($path, $name)
{
return true;
}
function close(){
return true;
}
function read($session_id)
{
$value = $this->redis->get($session_id);
if ($value){
return $value;
}
return '';
}
function write($session_id, $data)
{
if( $this->redis->set($session_id, $data) ){
$this->redis->expire($session_id, $this->expTime);
return true;
}
return false;
}
function destroy($session_id)
{
if ( $this->redis->delete($session_id) )
{
return true;
}
return false;
}
function gc($maxlifetime)
{
return true; // 因为redis设置了过期时间,不需要再gc回收
}
function __destruct()
{
session_write_close();
}
}
new RedisSession();