Session

概述

ThinkPHP采用think\Session类提供Session功能支持。

版本	新增功能
5.0.5	增加安全选项参数secure和httponly
5.0.2	增加flash方法和flush方法

Session初始化

在ThinkPHP5.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类型。