## 概述 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`類型。