系統提供了Session管理和操作的完善支持,全部操作可以通過一個內置的session函數完成,該函數可以完成Session的設置、獲取、刪除和管理操作。
session初始化設置
如果session方法的第一個參數傳入數組則表示進行session初始化設置,例如:
session(array('name'=>'session_id','expire'=>3600));
支持傳入的session參數包括:
參數名 | 說明 |
---|---|
id | session_id值 |
name | session_name 值 |
path | session_save_path 值 |
prefix | session 本地化空間前綴 |
expire | session.gc_maxlifetime 設置值 |
domain | session.cookie_domain 設置值 |
use_cookies | session.use_cookies 設置值 |
use_trans_sid | session.use_trans_sid 設置值 |
type | session處理類型,支持驅動擴展 |
Session初始化設置方法無需手動調用,在Think\App類的初始化工作結束后會自動調用,通常項目只需要配置SESSION_OPTIONS
參數即可,SESSION_OPTIONS
參數的設置是一個數組,支持的索引名和前面的session初始化參數相同。
默認情況下,初始化之后系統會自動啟動session,如果不希望系統自動啟動session的話,可以設置SESSION_AUTO_START
為false,例如:
'SESSION_AUTO_START' =>false
關閉自動啟動后可以項目的公共文件或者在控制器中通過手動調用session_start
或者session('[start]')
啟動session。
session賦值
Session賦值比較簡單,直接使用:
session('name','value'); //設置session
session取值
Session取值使用:
$value = session('name');
// 獲取所有的session 3.2.2版本新增
$value = session();
session刪除
刪除某個session的值使用:
session('name',null); // 刪除name
要刪除所有的session,可以使用:
session(null); // 清空當前的session
session判斷
要判斷一個session值是否已經設置,可以使用
// 判斷名稱為name的session值是否已經設置
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設置的時候傳入prefix
參數或者單獨設置了SESSION_PREFIX
參數的話,就可以啟用本地化session管理支持。啟動本地化session后,所有的賦值、取值、刪除以及判斷操作都會自動支持本地化session。
本地化session支持開啟后,生成的session數據格式由原來的 $_SESSION['name']
變成 $_SESSION['前綴']['name']
。
session handler支持
初始化session設置的時候如果傳入了type
參數或者設置了SESSION_TYPE
參數的話,則會自動引入對應的Session處理驅動,驅動目錄位於Library/Think/Session/Driver目錄下面(詳見擴展部分)。