ThinkPHP3.0完全开发手册                                           

 

19.1               Session支持

系统提供了Session管理和操作的完善支持,全部操作可以通过一个内置的session函数完成。

Session  用于Session 设置、获取、删除和管理操作

用法

session($name, $value='')

参数

name(必须):如果传入数组 则表示进行session初始化,如果传入null表示清空当前session,如果是字符串则表示session赋值、获取或者操作。

Value(可选):要设置的session值,如果传入null表示删除session,默认为空字符串

返回值

见详(根据具体的用法返回不同的值)

session函数是一个多元化操作函数,传入不同的参数调用可以完成不同的功能操作,包括下面一些功能。

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 设置值

type

session hander类型,可以使用hander驱动扩展

Session初始化设置方法 无需手动调用,在App类的初始化工作结束后会自动调用,通常项目只需要配置SESSION_OPTIONS参数即可,SESSION_OPTIONS参数的设置是一个数组,支持的索引名和前面的session初始化参数相同。

默认情况下,初始化之后系统会自动启动session,如果不希望系统自动启动session的话,可以设置SESSION_AUTO_STARTfalse,例如:

'SESSION_AUTO_START' =>false

关闭自动启动后可以项目的公共文件或者在控制器中通过手动调用session_start或者session('[start]') 启动session

 

session赋值

Session赋值比较简单,直接使用:

session('name','value');  //设置session

 

session取值

Session取值使用:

$value = session('name');

 

session删除

session('name',null); // 删除name

要删除所有的session,可以使用:

session(null); // 清空当前的session

 

session判断

要判断一个session值是否已经设置,可以使用

session('?name');

用于判断名称为namesession值是否已经设置

 

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']

 

session hander支持

是初始化session设置的时候,如果传入了type参数,则会自动引入对应的hander驱动,驱动扩展目录位于Extend/Driver/Session目录下面(详见扩展部分)。


NetPc