## 概述 ThinkPHP采用`think\Session`類提供`Session`功能支持。 |版本|新增功能| |---|---| |5.0.5|增加安全選項參數`secure`和`httponly`| |5.0.2|增加`flash`方法和`flush`方法| ## Session初始化 在ThinkPHP`5.0`中使用`\think\Session`類進行Session相關操作，Session會在第一次調用Session類的時候按照配置的參數自動初始化，例如，我們在應用配置中添加如下配置： ~~~ 'session' => [ 'prefix' => 'think', 'type' => '', 'auto_start' => true, ], ~~~ 如果我們使用上述的session配置參數的話，無需任何操作就可以直接調用Session類的相關方法，例如： ~~~ Session::set('name','thinkphp'); Session::get('name'); ~~~ 如果你應用下面的不同模塊需要不同的session參數，那么可以在模塊配置文件中重新設置： ~~~ 'session' => [ 'prefix' => 'module', 'type' => '', 'auto_start' => true, ], ~~~ 或者調用init方法進行初始化： ~~~ Session::init([ 'prefix' => 'module', 'type' => '', 'auto_start' => true, ]); ~~~ > 如果你沒有使用Session類進行Session操作的話，例如直接操作`$_SESSION`,必須使用上面的方式手動初始化或者直接調用`session_start()`方法進行`session`初始化。 ## 設置參數 默認支持的session設置參數包括： |參數|描述| |---|---| |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| > 如果做了session驅動擴展，可能有些參數不一定有效。 ## 基礎用法 賦值 ~~~ // 賦值（當前作用域） Session::set('name','thinkphp'); // 賦值think作用域 Session::set('name','thinkphp','think'); ~~~ 判斷是否存在 ~~~ // 判斷（當前作用域）是否賦值 Session::has('name'); // 判斷think作用域下面是否賦值 Session::has('name','think'); ~~~ 取值 ~~~ // 取值（當前作用域） Session::get('name'); // 取值think作用域 Session::get('name','think'); ~~~ 如果name的值不存在，返回`null`。 刪除 ~~~ // 刪除（當前作用域） Session::delete('name'); // 刪除think作用域下面的值 Session::delete('name','think'); ~~~ 指定作用域 ~~~ // 指定當前作用域 Session::prefix('think'); ~~~ 取值并刪除 ~~~ // 取值并刪除 Session::pull('name'); ~~~ 如果name的值不存在，返回`Null`。 清空 ~~~ // 清除session（當前作用域） Session::clear(); // 清除think作用域 Session::clear('think'); ~~~ 閃存數據，下次請求之前有效（`v5.0.2+`） ~~~ // 設置session 并且在下一次請求之前有效 Session::flash('name','value'); ~~~ 提前清除當前請求有效的數據（`v5.0.2+`） ~~~ // 清除當前請求有效的session Session::flush(); ~~~ ## 二級數組 支持session的二維數組操作，例如： ~~~ // 賦值（當前作用域） Session::set('name.item','thinkphp'); // 判斷（當前作用域）是否賦值 Session::has('name.item'); // 取值（當前作用域） Session::get('name.item'); // 刪除（當前作用域） Session::delete('name.item'); ~~~ ## 助手函數 系統也提供了助手函數session完成相同的功能，例如： ~~~ // 初始化session session([ 'prefix' => 'module', 'type' => '', 'auto_start' => true, ]); // 賦值（當前作用域） session('name', 'thinkphp'); // 賦值think作用域 session('name', 'thinkphp', 'think'); // 判斷（當前作用域）是否賦值 session('?name'); // 取值（當前作用域） session('name'); // 取值think作用域 session('name', '', 'think'); // 刪除（當前作用域） session('name', null); // 清除session（當前作用域） session(null); // 清除think作用域 session(null, 'think'); ~~~ ## Session驅動 支持指定 Session 驅動，配置文件如下： ~~~ 'session' => [ 'prefix' => 'module', 'type' => 'redis', 'auto_start' => true, // redis主機 'host' => '127.0.0.1', // redis端口 'port' => 6379, // 密碼 'password' => '', ] ~~~ 表示使用`redis`作為`session`類型。