Session
概述
ThinkPHP采用think\Session類提供Session功能支持。
| 版本 | 新增功能 |
|---|---|
| 5.0.5 |
增加安全選項參數secure和httponly |
| 5.0.2 |
增加flash方法和flush方法 |
Session初始化
在ThinkPHP5.0中使用\think\Session類進行Session相關(guan)操作,Session會在第一次調用(yong)Session類的(de)時候按照(zhao)配(pei)置(zhi)的(de)參數自動初始化,例如,我們(men)在應用(yong)配(pei)置(zhi)中添加如下配(pei)置(zhi):
'session' => [
'prefix' => 'think',
'type' => '',
'auto_start' => true,
],
如果我(wo)們使用上述的(de)session配置參數的(de)話(hua),無需任何操作(zuo)就可以(yi)直接調用Session類的(de)相關方法,例(li)如:
Session::set('name','thinkphp');
Session::get('name');
如果你應用下面(mian)的不(bu)(bu)同模(mo)塊需要(yao)不(bu)(bu)同的session參數,那么可(ke)以在模(mo)塊配置文件中重新(xin)設置:
'session' => [
'prefix' => 'module',
'type' => '',
'auto_start' => true,
],
或者調用init方(fang)法(fa)進行初始化(hua):
Session::init([
'prefix' => 'module',
'type' => '',
'auto_start' => true,
]);
如果你沒有使用Session類進行Session操作的話,例如直接操作
$_SESSION,必須使用上面的方式手動初始化或者直接調用session_start()方法進行session初始化。
設置參數
默認支持(chi)的(de)session設(she)置參數包(bao)括:
| 參數 | 描述 |
|---|---|
| type | session類型 |
| expire | session過期時間 |
| prefix | session前綴 |
| auto_start | 是否自動開啟 |
| use_trans_sid | 是否使用use_trans_sid |
| var_session_id | 請求session_id變量名 |
| id | session_id |
| name | session_name |
| path | session保存路徑 |
| domain | session cookie_domain |
| use_cookies | 是否使用cookie |
| cache_limiter | session_cache_limiter |
| cache_expire | session_cache_expire |
如果(guo)做(zuo)了session驅動擴展,可(ke)能有些(xie)參數不一定有效。
基礎用法
賦值
// 賦值(zhi)(當前作用域)
Session::set('name','thinkphp');
// 賦值think作用(yong)域
Session::set('name','thinkphp','think');
判斷是否存在
// 判(pan)斷(當前作(zuo)用域)是否賦(fu)值
Session::has('name');
// 判斷(duan)think作用域下面是否賦值
Session::has('name','think');
取值
// 取(qu)值(當前(qian)作(zuo)用域)
Session::get('name');
// 取值think作用域
Session::get('name','think');
如果name的值不存在,返回null。
刪除
// 刪除(當前(qian)作用域)
Session::delete('name');
// 刪(shan)除think作用域下面的值
Session::delete('name','think');
指定作用域
// 指定當前作(zuo)用域
Session::prefix('think');
取值并刪除
// 取值并刪(shan)除
Session::pull('name');
如果name的值不存在,返回Null。
清空
// 清除(chu)session(當前作用域)
Session::clear();
// 清除(chu)think作用(yong)域
Session::clear('think');
閃存數據,下次請求之前有效(v5.0.2+)
// 設置(zhi)session 并且在(zai)下一次請求之前有效
Session::flash('name','value');
提前清除當前請求有效的數據(v5.0.2+)
// 清除當前請求有效的session
Session::flush();
二級數組
支持session的二(er)維數組操作,例如:
// 賦(fu)值(zhi)(當前作用域)
Session::set('name.item','thinkphp');
// 判斷(當前(qian)作用(yong)域)是否賦值
Session::has('name.item');
// 取值(當前作用(yong)域)
Session::get('name.item');
// 刪(shan)除(當前作用域)
Session::delete('name.item');
助手函數
系統也(ye)提供(gong)了(le)助手函數session完成相同的(de)功能,例如:
// 初(chu)始(shi)化session
session([
'prefix' => 'module',
'type' => '',
'auto_start' => true,
]);
// 賦值(當前(qian)作用(yong)域)
session('name', 'thinkphp');
// 賦值think作用域(yu)
session('name', 'thinkphp', 'think');
// 判斷(當(dang)前(qian)作(zuo)用域)是否賦(fu)值
session('?name');
// 取值(zhi)(當前作(zuo)用域)
session('name');
// 取值(zhi)think作用域
session('name', '', 'think');
// 刪除(當前作(zuo)用域)
session('name', null);
// 清除session(當前作用域)
session(null);
// 清除think作(zuo)用域
session(null, 'think');
Session驅動
支持指定 Session 驅動(dong),配置文(wen)件(jian)如(ru)下(xia):
'session' => [
'prefix' => 'module',
'type' => 'redis',
'auto_start' => true,
// redis主(zhu)機
'host' => '127.0.0.1',
// redis端(duan)口
'port' => 6379,
// 密(mi)碼
'password' => '',
]
表示使用redis作為session類型。
