Session会话

不支持操作$_SESSION数组，只能使用Session类

不支持操作$_SESSION数组，只能使用Session类

6.0的Session类可以很好的支持诸如Swoole/Workerman等环境。

开启Session

Session功能默认没有开启，如果你需要使用Seesion，需要在全局的中间件定义文件中加上下面的中间件定义：

'think\middleware\SessionInit'

如果是多应用模式，并且你只是用于部分应用，那么也可以在应用中间件定义文件中单独开启。

Session初始化

系统会自动按照session.php配置的参数自动初始化Session。

默认支持的session设置参数包括：

无需任何操作就可以直接调用Session类的相关方法，例如：

Session::set('name', 'thinkphp');
Session::get('name');

序列化

会话数据保存的时候会自动序列化，并在读取的时候自动反序列化，你可以自定义序列化机制。

例如在配置文件中设置为使用JSON序列化：

'serialize'    =>    ['json_encode', 'json_decode'],

要尽量避免把对象保存到Session会话

基础用法

赋值

Session::set('name', 'thinkphp');
// 支持两级赋值
Session::set('user.name', 'thinkphp');

判断是否存在

Session::has('name');
Session::has('user.name');

取值

// 如果值不存在，返回null
Session::get('name');
// 如果值不存在，返回空字符串
Session::get('name', '');
// 支持多级
Session::get('user.name');

删除

Session::delete('name');

取值并删除

// 取值并删除
Session::pull('name');

如果name的值不存在，返回Null。

清空

Session::clear();

闪存数据，下次请求之前有效

// 设置session 并且在下一次请求之前有效
Session::flash('name','value');

提前清除当前请求有效的数据

// 清除当前请求有效的session
Session::flush();

注意，Session写入数据的操作会在请求结束的时候统一进行本地化存储，所以不要在写入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);

Request对象中读取Session

可以在Request对象中读取Session数据（不支持设置）

public function index(Request $request) {
    // 读取某个session数据
    $request->session('user.name', '');
    // 获取全部session数据
    $request->session();
}

但Request类中不支持Session写入操作。

应用独立会话

如果使用默认的是文件类型的话，多应用的Session保存路径是相同的，也就是说多应用之间是共享会话数据的，如果不希望共享会话数据，可以给每个应用设置不同的path或者是不同的前缀prefix。

如果是File类型的话，默认的session会话数据保存在runtime/session目录下面，你可以设置path改变存储路径。

如果是其它类型驱动的话，可以设置prefix配置参数来区分不同的应用会话数据。

Session驱动

默认的Session驱动采用文件缓存方式记录，并且支持如下配置

除了文件类型之外，还可以支持其它的Session类型，例如：

return [
    'type'       => 'redis',
    'prefix'     => 'think',
    'auto_start' => true,
     // redis主机
    'host'       => '127.0.0.1',
     // redis端口
    'port'       => 6379,
     // 密码
    'password'   => '',
]

表示使用redis作为session类型。

要以上的配置生效，请确保缓存配置文件cache.php中的stores中已经添加了redis缓存配置，例如：

return [
    'default'    =>    'file',
    'stores'    =>    [
        // 文件缓存
        'file'   =>  [
            // 驱动方式
            'type'   => 'file',
            // 设置不同的缓存保存目录
            'path'   => '../runtime/file/',
        ],  
        // redis缓存
        'redis'   =>  [
            // 驱动方式
            'type'   => 'redis',
            // 服务器地址
            'host'       => '127.0.0.1',
        ],  
    ],
];

目前内置支持的类型包括redis、memcache和memcached。

自定义驱动

如果需要自定义Session驱动，你的驱动类必须实现think\contract\SessionHandlerInterface接口，包含了三个方法。

interface SessionHandlerInterface
{
    public function read(string $sessionId): string;
    public function delete(string $sessionId): bool;
    public function write(string $sessionId, string $data): bool;
}

read方法是在调用Session::start()的时候执行，并且只会执行一次。
write方法是在本地化会话数据的时候执行（调用Session::save()方法），系统会在每次请求结束的时候自动执行。
delete方法是在销毁会话的时候执行（调用Session::destroy()方法）。