Session
最后更新于：2022-04-01 21:25:38
## 概述
ThinkPHP采用`think\Session`类提供`Session`功能支持。
|版本|新增功能|
|---|---|
|5.0.5|增加安全选项参数`secure`和`httponly`|
|5.0.2|增加`flash`方法和`flush`方法|
## Session初始化
在ThinkPHP`5.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+`）
~~~
// 清除当前请求有效的session
Session::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`类型。
';