系统提供了Session管理和操作的完善支持,全部操作可以通过一个内置的session函数完成,该函数可以完成Session的设置、获取、删除和管理操作。
### session初始化设置
如果session方法的第一个参数传入数组则表示进行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处理类型,支持驱动扩展 |
Session初始化设置方法无需手动调用,在Think\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
~~~
~~~
3.2.3版本开始,session赋值操作支持二维,例如:
~~~
~~~
session('user.user_id',10); //设置session
~~~
~~~
### session取值
Session取值使用:
~~~
~~~
$value = session('name');
// 获取所有的session 3.2.2版本新增
$value = session();
~~~
~~~
3.2.3版本开始支持二维数组取值,例如:
~~~
~~~
$value = session('user.user_id');
~~~
~~~
### session删除
删除某个session的值使用:
~~~
~~~
session('name',null); // 删除name
~~~
~~~
3.2.3版本开始支持删除二维数组,例如:
~~~
~~~
session('user.user_id',null); // 删除session
~~~
~~~
要删除所有的session,可以使用:
~~~
~~~
session(null); // 清空当前的session
~~~
~~~
### session判断
要判断一个session值是否已经设置,可以使用
~~~
~~~
// 判断名称为name的session值是否已经设置
session('?name');
~~~
~~~
3.2.3版本开始,支持判断二维数组,例如:
~~~
~~~
session('?user.user_id');
~~~
~~~
### 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 handler支持
初始化session设置的时候如果传入了`type`参数或者设置了`SESSION_TYPE`参数的话,则会自动引入对应的Session处理驱动,驱动目录位于Library/Think/Session/Driver目录下面(详见扩展部分)。
- 序言
- 基础
- 获取ThinkPHP
- 环境要求
- 目录结构
- 入口文件
- 自动生成
- 模块
- 控制器
- 开发规范
- 配置
- 配置格式
- 配置加载
- 读取配置
- 动态配置
- 扩展配置
- 批量配置
- 架构
- 模块化设计
- URL模式
- 多层MVC
- CBD模式
- 命名空间
- 自动加载
- 应用模式
- 项目编译
- 系统流程
- 路由
- 路由定义
- 规则路由
- 正则路由
- 静态路由
- 闭包支持
- 实例说明
- 控制器
- 控制器定义
- 前置和后置操作
- Action参数绑定
- 伪静态
- URL大小写
- URL生成
- AJAX返回
- 跳转和重定向
- 输入变量
- 请求类型
- 空操作
- 空控制器
- 插件控制器
- 操作绑定到类
- 模型
- 模型定义
- 模型实例化
- 字段定义
- 连接数据库
- 切换数据库
- 分布式数据库支持
- 连贯操作
- WHERE
- TABLE
- ALIAS
- DATA
- FIELD
- ORDER
- LIMIT
- PAGE
- GROUP
- HAVING
- JOIN
- UNION
- DISTINCT
- LOCK
- CACHE
- COMMENT
- RELATION
- USING
- fetchSql
- TOKEN
- STRICT
- INDEX
- 命名范围
- CURD操作
- 数据创建
- 数据写入
- 数据读取
- 数据更新
- 数据删除
- ActiveRecord
- 字段映射
- 查询语言
- 查询方式
- 表达式查询
- 快捷查询
- 区间查询
- 组合查询
- 统计查询
- SQL查询
- 动态查询
- 子查询
- 自动验证
- 自动完成
- 参数绑定
- 虚拟模型
- 模型分层
- 视图模型
- 关联模型
- 高级模型
- Mongo模型
- 视图
- 模板定义
- 模板主题
- 模板赋值
- 模板渲染
- 获取模板地址
- 获取内容
- 模板引擎
- 模板
- 变量输出
- 系统变量
- 使用函数
- 默认值输出
- 使用运算符
- 标签库
- 模板继承
- 修改定界符
- 三元运算
- 包含文件
- 内置标签
- Volist标签
- Foreach标签
- For标签
- Switch标签
- 比较标签
- 范围判断标签
- IF标签
- Present标签
- Empty标签
- Defined标签
- Assign标签
- Define标签
- 标签嵌套
- import标签
- 使用PHP代码
- 原样输出
- 模板注释
- 模板布局
- 模板替换
- 调试
- 调试模式
- 异常处理
- 日志记录
- 页面Trace
- Trace方法
- 变量调试
- 性能调试
- 错误调试
- 模型调试
- 缓存
- 数据缓存
- 快速缓存
- 查询缓存
- 静态缓存
- 安全
- 输入过滤
- 表单合法性检测
- 表单令牌
- 防止SQL注入
- 目录安全文件
- 保护模板文件
- 上传安全
- 防止XSS攻击
- 其他安全建议
- 扩展
- 类库扩展
- 驱动扩展
- 缓存驱动
- 数据库驱动
- 日志驱动
- Session驱动
- 存储驱动
- 模板引擎驱动
- 标签库驱动
- 行为扩展
- 标签扩展
- Widget扩展
- 应用模式
- 部署
- PATH_INFO支持
- URL重写
- 模块部署
- 域名部署
- 入口绑定
- 替换入口
- 专题
- SESSION支持
- Cookie支持
- 多语言支持
- 数据分页
- 文件上传
- 验证码
- 图像处理
- RESTFul
- RPC
- SAE
- IP获取和定位
- 附录
- 常量参考
- 配置参考
- 升级指导
- 鸣谢
- CoverPage