## 概述 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`类型。