Session
概述
ThinkPHP采用think\Session
類提供Session
功能支持。
版本 | 新增功能 |
---|---|
5.0.5 |
增加安全選項(xiàng)參數(shù)secure 和httponly |
5.0.2 |
增加flash 方法和flush 方法 |
Session初始化
在ThinkPHP5.0
中使用\think\Session
類進(jìn)行Session相關(guān)操作,Session會(huì)在第一次調(diào)用Session類的時(shí)候按照配置的參數(shù)自動(dòng)初始化,例如,我們?cè)趹?yīng)用配置中添加如下配置:
'session' => [
'prefix' => 'think',
'type' => '',
'auto_start' => true,
],
如果我們使用上述的session配置參數(shù)的話,無(wú)需任何操作就可以直接調(diào)用Session類的相關(guān)方法,例如:
Session::set('name','thinkphp');
Session::get('name');
如果你應(yīng)用下面的不同模塊需要不同的session參數(shù),那么可以在模塊配置文件中重新設(shè)置:
'session' => [
'prefix' => 'module',
'type' => '',
'auto_start' => true,
],
或者調(diào)用init方法進(jìn)行初始化:
Session::init([
'prefix' => 'module',
'type' => '',
'auto_start' => true,
]);
如果你沒(méi)有使用Session類進(jìn)行Session操作的話,例如直接操作
$_SESSION
,必須使用上面的方式手動(dòng)初始化或者直接調(diào)用session_start()
方法進(jìn)行session
初始化。
設(shè)置參數(shù)
默認(rèn)支持的session設(shè)置參數(shù)包括:
參數(shù) | 描述 |
---|---|
type | session類型 |
expire | session過(guò)期時(shí)間 |
prefix | session前綴 |
auto_start | 是否自動(dòng)開啟 |
use_trans_sid | 是否使用use_trans_sid |
var_session_id | 請(qǐng)求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 |
如果做了session驅(qū)動(dòng)擴(kuò)展,可能有些參數(shù)不一定有效。
基礎(chǔ)用法
賦值
// 賦值(當(dāng)前作用域)
Session::set('name','thinkphp');
// 賦值think作用域
Session::set('name','thinkphp','think');
判斷是否存在
// 判斷(當(dāng)前作用域)是否賦值
Session::has('name');
// 判斷think作用域下面是否賦值
Session::has('name','think');
取值
// 取值(當(dāng)前作用域)
Session::get('name');
// 取值think作用域
Session::get('name','think');
如果name的值不存在,返回null
。
刪除
// 刪除(當(dāng)前作用域)
Session::delete('name');
// 刪除think作用域下面的值
Session::delete('name','think');
指定作用域
// 指定當(dāng)前作用域
Session::prefix('think');
取值并刪除
// 取值并刪除
Session::pull('name');
如果name的值不存在,返回Null
。
清空
// 清除session(當(dāng)前作用域)
Session::clear();
// 清除think作用域
Session::clear('think');
閃存數(shù)據(jù),下次請(qǐng)求之前有效(v5.0.2+
)
// 設(shè)置session 并且在下一次請(qǐng)求之前有效
Session::flash('name','value');
提前清除當(dāng)前請(qǐng)求有效的數(shù)據(jù)(v5.0.2+
)
// 清除當(dāng)前請(qǐng)求有效的session
Session::flush();
二級(jí)數(shù)組
支持session的二維數(shù)組操作,例如:
// 賦值(當(dāng)前作用域)
Session::set('name.item','thinkphp');
// 判斷(當(dāng)前作用域)是否賦值
Session::has('name.item');
// 取值(當(dāng)前作用域)
Session::get('name.item');
// 刪除(當(dāng)前作用域)
Session::delete('name.item');
助手函數(shù)
系統(tǒng)也提供了助手函數(shù)session完成相同的功能,例如:
// 初始化session
session([
'prefix' => 'module',
'type' => '',
'auto_start' => true,
]);
// 賦值(當(dāng)前作用域)
session('name', 'thinkphp');
// 賦值think作用域
session('name', 'thinkphp', 'think');
// 判斷(當(dāng)前作用域)是否賦值
session('?name');
// 取值(當(dāng)前作用域)
session('name');
// 取值think作用域
session('name', '', 'think');
// 刪除(當(dāng)前作用域)
session('name', null);
// 清除session(當(dāng)前作用域)
session(null);
// 清除think作用域
session(null, 'think');
Session驅(qū)動(dòng)
支持指定 Session 驅(qū)動(dòng),配置文件如下:
'session' => [
'prefix' => 'module',
'type' => 'redis',
'auto_start' => true,
// redis主機(jī)
'host' => '127.0.0.1',
// redis端口
'port' => 6379,
// 密碼
'password' => '',
]
表示使用redis
作為session
類型。