概述

ThinkPHP采用think\Session類提供Session功能支持。

Session初始化

在ThinkPHP5.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設置參數包括：

如果做了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類型。