# Session ## 概述 可以直接使用`think\facade\Session`类操作`Session`。 版本新增功能5.1.3`get`方法支持获取多级## Session初始化 Session会在第一次调用Session类的时候按照`session.php`配置的参数自动初始化： ``` return [ 'prefix' => 'think', 'type' => '', 'auto_start' => true, ], ``` 如果我们使用上述的session配置参数的话，无需任何操作就可以直接调用Session类的相关方法，例如： ``` Session::set('name','thinkphp'); Session::get('name'); ``` 或者调用init方法进行初始化： ``` Session::init([ 'prefix' => 'module', 'type' => '', 'auto_start' => true, ]); ``` > 如果你没有使用Session类进行Session操作的话，例如直接操作`$_SESSION`,必须使用上面的方式手动初始化或者直接调用`session_start()`方法进行`session`初始化。 ## 设置参数 默认支持的session设置参数包括： 参数描述typesession类型expiresession过期时间prefixsession前缀auto\_start是否自动开启use\_trans\_sid是否使用use\_trans\_sidvar\_session\_id请求session\_id变量名idsession\_idnamesession\_namepathsession保存路径domainsession cookie\_domainuse\_cookies是否使用cookiecache\_limitersession\_cache\_limitercache\_expiresession\_cache\_expiresecure安全选项httponly使用httponly> 如果做了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'); ``` 闪存数据，下次请求之前有效 ``` // 设置session 并且在下一次请求之前有效 Session::flash('name','value'); ``` 提前清除当前请求有效的数据 ``` // 清除当前请求有效的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 驱动，配置文件如下： ``` return [ 'type' => 'redis', 'prefix' => 'module', 'auto_start' => true, // redis主机 'host' => '127.0.0.1', // redis端口 'port' => 6379, // 密码 'password' => '', ] ``` 表示使用`redis`作为`session`类型。 目前内置支持使用`redis`、`memcache`和`memcached`作为session驱动类型。