概述
ThinkPHP采用think\Session
类提供Session
功能支持。
版本 | 新增功能 |
---|---|
5.0.5 | 增加安全选项参数secure 和httponly |
5.0.2 | 增加flash 方法和flush 方法 |
Session初始化
在ThinkPHP5.0
中使用\think\Session
类进行Session相关操作,Session会在第一次调用Session类的时候按照配置的参数自动初始化,例如,我们在应用配置中添加如下配置:
'session' => [ 'prefix' => 'think', 'type' => '', 'auto_start' => true, ],
如果我们使用上述的session配置参数的话,无需任何操作就可以直接调用Session类的相关方法,例如:
Session::set('name','thinkphp'); Session::get('name');
如果你应用下面的不同模块需要不同的session参数,那么可以在模块配置文件中重新设置:
'session' => [ 'prefix' => 'module', 'type' => '', 'auto_start' => true, ],
或者调用init方法进行初始化:
Session::init([ 'prefix' => 'module', 'type' => '', 'auto_start' => true, ]);
如果你没有使用Session类进行Session操作的话,例如直接操作
$_SESSION
,必须使用上面的方式手动初始化或者直接调用session_start()
方法进行session
初始化。
设置参数
默认支持的session设置参数包括:
参数 | 描述 |
---|---|
type | session类型 |
expire | session过期时间 |
prefix | session前缀 |
auto_start | 是否自动开启 |
use_trans_sid | 是否使用use_trans_sid |
var_session_id | 请求session_id变量名 |
id | session_id |
name | session_name |
path | session保存路径 |
domain | session cookie_domain |
use_cookies | 是否使用cookie |
cache_limiter | session_cache_limiter |
cache_expire | session_cache_expire |
如果做了session驱动扩展,可能有些参数不一定有效。
基础用法
赋值
// 赋值(当前作用域) Session::set('name','thinkphp'); // 赋值think作用域 Session::set('name','thinkphp','think');
判断是否存在
// 判断(当前作用域)是否赋值 Session::has('name'); // 判断think作用域下面是否赋值 Session::has('name','think');
取值
// 取值(当前作用域) Session::get('name'); // 取值think作用域 Session::get('name','think');
如果name的值不存在,返回null
。
删除
// 删除(当前作用域) Session::delete('name'); // 删除think作用域下面的值 Session::delete('name','think');
指定作用域
// 指定当前作用域 Session::prefix('think');
取值并删除
// 取值并删除 Session::pull('name');
如果name的值不存在,返回Null
。
清空
// 清除session(当前作用域) Session::clear(); // 清除think作用域 Session::clear('think');
闪存数据,下次请求之前有效(v5.0.2+
)
// 设置session 并且在下一次请求之前有效 Session::flash('name','value');
提前清除当前请求有效的数据(v5.0.2+
)
// 清除当前请求有效的 sessionSession::flush();
二级数组
支持session的二维数组操作,例如:
// 赋值(当前作用域) Session::set('name.item','thinkphp'); // 判断(当前作用域)是否赋值 Session::has('name.item'); // 取值(当前作用域) Session::get('name.item'); // 删除(当前作用域) Session::delete('name.item');
助手函数
系统也提供了助手函数session完成相同的功能,例如:
// 初始化session session([ 'prefix' => 'module', 'type' => '', 'auto_start' => true, ]); // 赋值(当前作用域) session('name', 'thinkphp'); // 赋值think作用域 session('name', 'thinkphp', 'think'); // 判断(当前作用域)是否赋值 session('?name'); // 取值(当前作用域) session('name'); // 取值think作用域 session('name', '', 'think'); // 删除(当前作用域) session('name', null); // 清除session(当前作用域) session(null); // 清除think作用域 session(null, 'think');
Session驱动
支持指定 Session 驱动,配置文件如下:
'session' => [ 'prefix' => 'module', 'type' => 'redis', 'auto_start' => true, // redis主机 'host' => '127.0.0.1', // redis端口 'port' => 6379, // 密码 'password' => '', ]
表示使用redis
作为session
类型。