Session方法用于Session 設(shè)置、獲取、刪除和管理操作。
Session 用于Session 設(shè)置、獲取、刪除和管理操作 |
用法 | session($name, $value='') |
參數(shù) | name(必須):如果傳入數(shù)組 則表示進(jìn)行session初始化,如果傳入null表示清空當(dāng)前session,如果是字符串則表示session賦值、獲取或者操作。 Value(可選):要設(shè)置的session值,如果傳入null表示刪除session,默認(rèn)為空字符串 |
返回值 | 見詳(根據(jù)具體的用法返回不同的值) |
session函數(shù)是一個多元化操作函數(shù),傳入不同的參數(shù)調(diào)用可以完成不同的功能操作,包括下面一些功能。[-more-]
session初始化設(shè)置
如果session方法的name參數(shù)傳入數(shù)組則表示進(jìn)行session初始化設(shè)置,例如:
session(array('name'=>'session_id','expire'=>3600));
支持傳入的session參數(shù)包括:
參數(shù)名 | 說明 |
id | session_id值 |
name | session_name 值 |
path | session_save_path 值 |
prefix | session 本地化空間前綴 |
expire | session.gc_maxlifetime 設(shè)置值 |
domain | session.cookie_domain 設(shè)置值 |
use_cookies | session.use_cookies 設(shè)置值 |
use_trans_sid | session.use_trans_sid 設(shè)置值 |
cache_limiter | session_cache_limiter設(shè)置值 |
cache_expire | session_cache_expire設(shè)置值 |
type | session hander類型,可以使用hander驅(qū)動擴(kuò)展 |
Session初始化設(shè)置方法 無需手動調(diào)用,在App類的初始化工作結(jié)束后會自動調(diào)用,通常項目只需要配置SESSION_OPTIONS參數(shù)即可,SESSION_OPTIONS參數(shù)的設(shè)置是一個數(shù)組,支持的索引名和前面的session初始化參數(shù)相同。
默認(rèn)情況下,初始化之后系統(tǒng)會自動啟動session,如果不希望系統(tǒng)自動啟動session的話,可以設(shè)置SESSION_AUTO_START為false,例如:
'SESSION_AUTO_START' =>false
關(guān)閉自動啟動后可以項目的公共文件或者在控制器中通過手動調(diào)用session_start或者session('[start]') 啟動session。
session賦值
Session賦值比較簡單,直接使用:
session('name','value'); //設(shè)置session
相當(dāng)于:
$_SESSION['name'] = 'value';
session取值
Session取值使用:
$value = session('name');
相當(dāng)于使用:
$value = $_SESSION['name'];
session刪除
session('name',null); // 刪除name
相當(dāng)于:
unset($_SESSION['name']);
要刪除所有的session,可以使用:
session(null); // 清空當(dāng)前的session
相當(dāng)于:
$_SESSION = array();
session判斷
要判斷一個session值是否已經(jīng)設(shè)置,可以使用
session('?name');
用于判斷名稱為name的session值是否已經(jīng)設(shè)置
相當(dāng)于:
isset($_SESSION['name']);
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設(shè)置的時候傳入prefix參數(shù)或者單獨(dú)設(shè)置了SESSION_PREFIX參數(shù)的話,就可以啟用本地化session管理支持。啟動本地化session后,所有的賦值、取值、刪除以及判斷操作都會自動支持本地化session。
本地化session支持開啟后,生成的session數(shù)據(jù)格式由原來的
$_SESSION['name'] 變成 $_SESSION['前綴']['name']
假設(shè)前綴設(shè)置為think,則賦值操作:
session('name','value'); //設(shè)置session
相當(dāng)于:
$_SESSION['think']['name'] = 'value';
取值操作:
$value = session('name');
相當(dāng)于使用:
$value = $_SESSION['think']['name'];
刪除操作:
session('name',null);
相當(dāng)于:
unset($_SESSION['think']['name']);
清空操作:
session(null);
相當(dāng)于:
unset($_SESSION['think']);
判斷操作:
session('?name');
相當(dāng)于:
isset($_SESSION['think']['name']);