ThinkPHP函数详解:session方法
Session方法用于Session 设置、获取、删除和管理操作。
Session 用于Session 设置、获取、删除和管理操作
用法
session($name, $value='')
参数
name(必须):如果传入数组 则表示进行session初始化,如果传入null表示清空当前session,如果是字符串则表示session赋值、获取或者操作。
Value(可选):要设置的session值,如果传入null表示删除session,默认为空字符串
返回值
见详(根据具体的用法返回不同的值)
session函数是一个多元化操作函数,传入不同的参数调用可以完成不同的功能操作,包括下面一些功能。[-more-]
session初始化设置
如果session方法的name参数传入数组则表示进行session初始化设置,例如: - session(array('name'=>'session_id','expire'=>3600));
复制代码
支持传入的session参数包括:
参数名
说明
id
session_id值
name
session_name 值
path
session_save_path 值
prefix
session 本地化空间前缀
expire
session.gc_maxlifetime 设置值
domain
session.cookie_domain 设置值
use_cookies
session.use_cookies 设置值
use_trans_sid
session.use_trans_sid 设置值
cache_limiter
session_cache_limiter设置值
cache_expire
session_cache_expire设置值
type
session hander类型,可以使用hander驱动扩展
Session初始化设置方法 无需手动调用,在App类的初始化工作结束后会自动调用,通常项目只需要配置SESSION_OPTIONS参数即可,SESSION_OPTIONS参数的设置是一个数组,支持的索引名和前面的session初始化参数相同。
默认情况下,初始化之后系统会自动启动session,如果不希望系统自动启动session的话,可以设置SESSION_AUTO_START为false,例如:
- 'SESSION_AUTO_START' =>false
复制代码
关闭自动启动后可以项目的公共文件或者在控制器中通过手动调用session_start或者session('[start]') 启动session。
session赋值
Session赋值比较简单,直接使用: - session('name','value'); //设置session
复制代码
相当于:
- $_SESSION['name'] = 'value';
复制代码
session取值
Session取值使用: - $value = session('name');
复制代码
相当于使用:
- $value = $_SESSION['name'];
复制代码
session删除
- session('name',null); // 删除name
复制代码
相当于:
- unset($_SESSION['name']);
复制代码
要删除所有的session,可以使用:
- session(null); // 清空当前的session
复制代码
相当于:
- $_SESSION = array();
复制代码
session判断
要判断一个session值是否已经设置,可以使用 - session('?name');
复制代码
用于判断名称为name的session值是否已经设置
相当于:
- isset($_SESSION['name']);
复制代码
session管理
session方法支持一些简单的session管理操作,用法如下: - session('[操作名]');
复制代码
支持的操作名包括:
操作名
含义
start
启动session
pause
暂停session写入
destroy
销毁session
regenerate
重新生成session id
使用示例如下:
- session('[pause]'); // 暂停session写入
- session('[start]'); // 启动session
- session('[destroy]'); // 销毁session
- session('[regenerate]'); // 重新生成session id
复制代码
本地化支持
如果在初始化session设置的时候传入prefix参数或者单独设置了SESSION_PREFIX参数的话,就可以启用本地化session管理支持。启动本地化session后,所有的赋值、取值、删除以及判断操作都会自动支持本地化session。本地化session支持开启后,生成的session数据格式由原来的
- $_SESSION['name'] 变成 $_SESSION['前缀']['name']
复制代码
假设前缀设置为think,则赋值操作:
- session('name','value'); //设置session
复制代码
相当于:
- $_SESSION['think']['name'] = 'value';
复制代码
取值操作:
- $value = session('name');
复制代码
相当于使用:
- $value = $_SESSION['think']['name'];
复制代码
删除操作:
- session('name',null);
复制代码
相当于:
- unset($_SESSION['think']['name']);
复制代码
清空操作:
- session(null);
复制代码
相当于:
- unset($_SESSION['think']);
复制代码
判断操作:
- session('?name');
复制代码
相当于:
- isset($_SESSION['think']['name']);