要手动初始化 Session 类,你可以在控制器的构造函数中使用 $this->load->library() 方法:
$this->load->library("session");
初始化之后,就可以使用下面的方法来访问 Session 对象了:
$this->session
重要
由于 加载类 是在 CodeIgniter 的控制器基类中实例化的, 所以如果要在你的控制器构造函数中加载类库的话,确保先调用 parent::__construct() 方法。
1. session数据
session数据是个简单的数组,带有一个特定的session ID(cookie)。 CodeIgniter 使用了相同的方式来访问 session 数据,同时使用了 PHP 自带的 session 处理机制, 使用 session 数据和操作 $_SESSION 数组一样简单(包括读取,设置,取消设置)。
2. 获取 Session 数据
session数组中的任何信息都是可以通过$_SESSION全局变量获取:比如:$_SESSION["item"] 或者使用方法:$this->session->item; 同时为了和之前的版本兼容,也可以使用userdata()方法:$this->session->userdata("item");
其中,item 是你想获取的数组的键值。例如,将 "name" 键值对应的项赋值给 $name 变量, 你可以这样:
$name = $_SESSION["name"]; or $name = $this->session->name; or $name = $this->session->userdata("name");
如果你访问的项不存在,userdata() 方法返回 NULL 。
如果你想获取所有已经存在的userdata, 你可以忽略 item 参数:
$_SESSION
// or:
$this->session->userdata();
3. 添加 Session 数据
假设某个用户访问你的网站,当他完成认证之后,你可以将他的用户名和 email 地址添加到 session 中, 这样当你需要的时候你就可以直接访问这些数据,而不用查询数据库了。 你可以简单的将数据赋值给 $_SESSION 数组,或赋值给 $this->session 的某个属性。
同时,老版本中的通过 "userdata" 来赋值的方法也还可以用,只不过是需要传递一个包含你的数据的数组 给 set_userdata() 方法:
$this->session->set_userdata($array);
其中,$array 是包含新增数据的一个关联数组,下面是个例子:
$newdata = array(
"username" => "johndoe",
"email" => "johndoe@some-site.com",
"logged_in" => TRUE
);
$this->session->set_userdata($newdata);
如果你想一次只添加一个值,set_userdata() 也支持这种语法:
$this->session->set_userdata("some_name", "some_value");
如果你想检查某个 session 值是否存在,可以使用 isset():
// returns FALSE if the "some_name" item doesn"t exist or is NULL,
// TRUE otherwise:
isset($_SESSION["some_name"])
或者,你也可以使用 has_userdata():
$this->session->has_userdata("some_name");
4. 删除 Session 数据
和其他的变量一样,可以使用 unset() 方法来删除 $_SESSION 数组中的某个值:
unset($_SESSION["some_name"]);
// or multiple values:
unset(
$_SESSION["some_name"],
$_SESSION["another_name"]
);
同时,正如 set_userdata() 方法可用于向 session 中添加数据,unset_userdata() 方法可用于删除指定键值的数据。例如,如果你想从你的 session 数组中删除 "some_name":
$this->session->unset_userdata("some_name");
这个方法也可以使用一个数组来同时删除多个值:
$array_items = array("username", "email");
$this->session->unset_userdata($array_items);
销毁 Session
要清除当前的 session(例如:退出登录时),你可以简单的使用 PHP 自带的 session_destroy() 函数或者 sess_destroy() 方法。 两种方式效果完全一样:
session_destroy();
// or
$this->session->sess_destroy();
注解
这必须是同一个请求中关于 session 的最后一次操作,所有的 session 数据(包括 flashdata 和 tempdata)都被永久性销毁,销毁之后,关于 session 的方法将不可用。