ThinkPHP6 使用`\think\Session`对`PHP`原生的`Session`操作做了包装，更方便使用。 ## 概述 可以直接使用`think\facade\Session`类操作`Session`。 > 新版本不支持操作原生`$_SESSION`数组和所有`session_`开头的函数，只能通过`Session`类（或者助手函数）来操作。会话数据统一在当前请求结束的时候统一写入，所以不要在`session`写入操作之后执行`exit`等中断操作，否则会导致`Session`数据写入失败。 ## 开启Session `Session`功能默认是没有开启的（API应用通常不需要使用`Session`），如果你需要使用`Seesion`，需要在全局的中间件定义文件中开启： ~~~ 'think\middleware\SessionInit' ~~~ > 如果是多应用模式，并且你只是用于部分应用，那么也可以在应用中间件定义文件中单独开启。 ## Session初始化 系统会自动按照`session.php`配置的参数自动初始化`Session`。 默认支持的`session`设置参数包括： | 参数 | 描述 | | --- | --- | | type | session类型（`File`或者`Cache`） | | store | 当type设置为cache类型的时候指定存储标识 | | expire | session过期时间（秒）必须大于0 | | var\_session\_id | 请求session\_id变量名 | | name | session\_name | | prefix | session前缀 | | serialize | 序列化方法 | 无需任何操作就可以直接调用`Session`类的相关方法，例如： ~~~ Session::set('name', 'thinkphp'); Session::get('name'); ~~~ 会话数据保存（请求结束）的时候会自动序列化，并在读取的时候自动反序列化，默认使用`serialize`/`unserialize`进行序列化操作。 ## 基础用法 ### 赋值 ~~~ Session::set('name', 'thinkphp'); session('name', 'foobar'); ~~~ ### 判断是否存在 ~~~ Session::has('name'); session('?name'); ~~~ ### 取值 ~~~ // 如果值不存在，返回null Session::get('name'); session('name'); // 如果值不存在，返回空字符串 Session::get('name', ''); // 获取全部数据 Session::all(); ~~~ ### 删除 ~~~ Session::delete('name'); session('name', null); ~~~ ### 取值并删除 ~~~ // 取值并删除 Session::pull('name'); ~~~ 如果name的值不存在，返回`Null`。 ### 清空 ~~~ Session::clear(); session(null); ~~~ ### 闪存数据，下次请求之前有效 ~~~ // 设置session 并且在下一次请求之前有效 Session::flash('name','value'); ~~~ ### 提前清除当前请求有效的数据 ~~~ // 清除当前请求有效的session Session::flush(); ~~~ > 注意：不要在写入`Session`数据之后使用exit等中断操作，可能会导致`Session`没有正常写入。 ## 多级数组 支持`session`的多级数组操作，例如： ~~~ // 赋值 Session::set('name.item','thinkphp'); // 判断是否赋值 Session::has('name.item'); // 取值 Session::get('name.item'); // 删除 Session::delete('name.item'); ~~~ 其中`set`和`delete`方法只能支持二级数组，其他方法支持任意级数组操作。 ## 助手函数 系统也提供了助手函数`session`完成相同的功能，例如： ~~~ // 赋值 session('name', 'thinkphp'); // 判断是否赋值 session('?name'); // 取值 session('name'); // 删除 session('name', null); // 清除session session(null); ~~~ ## 应用独立会话 > 多应用情况下默认`Session`是跨应用的，如果不希望共享会话数据，可以给每个应用设置不同的前缀`prefix`。 如果是File类型的话，默认的`session`会话数据保存在`runtime/session`目录下面。 ## Session驱动 默认的`Session`驱动采用文件缓存方式记录。除了文件类型之外，还可以支持直接使用缓存作为`Session`类型，例如： ~~~ return [ 'type' => 'cache', 'store' => 'redis', 'prefix' => 'think', ] ~~~ 表示使用`redis`作为`session`类型。 要以上的配置生效，请确保缓存配置文件`cache.php`中的`stores`中已经添加了`redis`缓存配置，例如： ~~~ return [ 'default' => 'file', 'stores' => [ ...... // redis缓存 'redis' => [ // 驱动方式 'type' => 'redis', // 服务器地址 'host' => '127.0.0.1', ], ], ]; ~~~