企业🤖AI智能体构建引擎,智能编排和调试,一键部署,支持私有化部署方案 广告
# Session Session组件轮子,拆自ThinkPHP5的session组件 ## Session初始化 Session会在第一次调用Session类的时候按照`app.ini`配置的参数自动初始化: ~~~ 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设置参数包括: | 参数 | 描述 | | --- | --- | | 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 | | secure | 安全选项 | | 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驱动类型。