> CakePHP中文手册 > Cake Session Component

Cake session Component

Section 1 Cake Session存储选项

Cake预设3种Session数据保存方式:存储为Cake安装目录下的临时文件,采用PHP的默认机制,或者序列化到数据库中。默认情况下,Cake采用PHP的默认设置。如果想要更改为采用临时文件或数据库,编辑你的核心配置文件/app/config/core.php,根据需要把CAKE_SESSION_SAVE设置为“cake”,“php”,或者“database”。

core.php Session 配置

/*
 *
 * CakePHP有3种Session存储方式 
 * CakePHP包含3种类型的session来保存数据库或者文件,选择您中意的方法
 * 如果你想用自己的存储方式将其保存到app/config/name.php
 * 不要附值为“file”或者“database”
 * 请使用以下配置:
 * 设置为“cake”,保存文件到/cakedistro/tmp目录
 * 设置为“php”,采用php的缺省路径
 * 设置为“database”,保存到数据库
 *
 */
define('CAKE_SESSION_SAVE', 'php');
		

为了在数据库中存储Session数据,你需要在数据库中建立一张表。 /app/config/sql/sessions.sql 为创建数据库的脚本。

Section 2 使用Cake Session Component

Cake Session Component用来与Session进行交互。包含基本的Session读写,也包括通过Session来提示错误、发出提示消息(例“您的数据已经保存”)。 Session Component在所有Cake controller中默认为可用。

  • check
    • string $name

检查Session中是否已有 $name 为键值的数据项。

  • del
    • string $name
  • delete
    • string $name

删除$name 指定的Session变量。

  • error

返回最近由Cake Session Component产生的错误,常用于调试。

  • flash
    • string $key = 'flash'

返回最后一条Session中用setFlash()设置的消息。如果$key已设置,将返回最近存储于其中的消息。

  • read
    • string $name

返回$name变量值

  • renew

通过创建新的session ID,删除原有的ID,将原有Session中信息传递到新的Session中来更新当前Session。

  • setFlash
    • string $flashMessage
    • string $layout = 'default'
    • array $params
    • string $key = 'flash'

将变量$flashMessage中的信息写入Session(提供给之后的flash()方法来获取)。

如果$layout设置为“default”,该消息被存储为'<div class="message"> '.$flashMessage.'</div> '.如果$default设置为'',该消息就按原样保存。如果参数为其他任何值,该消息以 $layout 所指定的格式保存在Cake view里.

该方法中的 $params 参数会在未来版本中赋予功能,请记得查看更新信息以获取相关内容。

参数 $key 允许你在键下存储提示消息,flash()方法是基于键来读取提示信息的。

  • valid

当Session有效时返回true。最好在read()操作前用它来确定你要访问的会话是否确实有效。

  • write
    • string $name
    • mixed $value

将变量$name、$value写入会话。