1、簡(jiǎn)介

由于HTTP驅(qū)動(dòng)的應(yīng)用是無(wú)狀態(tài)的，所以我們使用session來(lái)存儲(chǔ)用戶請(qǐng)求信息。Lumen通過(guò)干凈、統(tǒng)一的API處理后端各種有效session驅(qū)動(dòng)，目前支持的流行后端驅(qū)動(dòng)包括Memcached、Redis和數(shù)據(jù)庫(kù)。

1.1 開啟Session

要開啟session，你需要取消bootstrap/app.php文件中$app->middleware()方法調(diào)用前的注釋。

1.2 配置

session驅(qū)動(dòng)由.env文件中的配置選項(xiàng)SESSION_DRIVER來(lái)控制。默認(rèn)情況下，Lumen使用的session驅(qū)動(dòng)為memcached，這對(duì)許多應(yīng)用而言是沒有什么問(wèn)題的。在生產(chǎn)環(huán)境中，你可以考慮使用memcached或者redis驅(qū)動(dòng)以便獲取更快的session性能。

session驅(qū)動(dòng)定義請(qǐng)求的session數(shù)據(jù)存放在哪里，Lumen可以處理多種類型的驅(qū)動(dòng)：

• file – session數(shù)據(jù)存儲(chǔ)在 storage/framework/sessions目錄下；
• cookie – session數(shù)據(jù)存儲(chǔ)在經(jīng)過(guò)加密的安全的cookie中；
• database – session數(shù)據(jù)存儲(chǔ)在數(shù)據(jù)庫(kù)中
• memcached / redis – session數(shù)據(jù)存儲(chǔ)在memcached/redis中；
• array – session數(shù)據(jù)存儲(chǔ)在簡(jiǎn)單PHP數(shù)組中，在多個(gè)請(qǐng)求之間是非持久化的。

注意：數(shù)組驅(qū)動(dòng)通常用于運(yùn)行測(cè)試以避免session數(shù)據(jù)持久化。

1.3 Session驅(qū)動(dòng)預(yù)備知識(shí)

數(shù)據(jù)庫(kù)

當(dāng)使用databasesession驅(qū)動(dòng)時(shí)，需要設(shè)置表包含session項(xiàng)，下面是該數(shù)據(jù)表的表結(jié)構(gòu)聲明：

Schema::create('sessions', function ($table) {
    $table->string('id')->unique();
    $table->text('payload');
    $table->integer('last_activity');
});

Redis

在Lumen中使用Redis session驅(qū)動(dòng)前，需要通過(guò)Composer安裝predis/predis包以及illuminate/redis包。

1.4 其它Session相關(guān)問(wèn)題

Lumen框架內(nèi)部使用flash session鍵，所以你不應(yīng)該通過(guò)該名稱添加數(shù)據(jù)項(xiàng)到session。

2、基本使用

訪問(wèn)session

首先，我們來(lái)訪問(wèn)session，我們可以通過(guò)HTTP請(qǐng)求訪問(wèn)session實(shí)例，可以在控制器方法中通過(guò)類型提示引入請(qǐng)求實(shí)例，記住，控制器方法依賴通過(guò)Lumen服務(wù)容器注入：

<?php

namespace App\Http\Controllers;

use Illuminate\Http\Request;
use App\Http\Controllers\Controller;

class UserController extends Controller{
    /**
     * 顯示指定用戶的屬性
     *
     * @param  Request  $request
     * @param  int  $id
     * @return Response
     */
    public function showProfile(Request $request, $id)
    {
        $value = $request->session()->get('key');

        //
    }
}

從session中獲取數(shù)據(jù)的時(shí)候，還可以傳遞默認(rèn)值作為第二個(gè)參數(shù)到get方法，默認(rèn)值在指定鍵在session中不存在時(shí)返回。如果你傳遞一個(gè)閉包作為默認(rèn)值到get方法，該閉包會(huì)執(zhí)行并返回執(zhí)行結(jié)果：

$value = $request->session()->get('key', 'default');

$value = $request->session()->get('key', function() {
    return 'default';
});

如果你想要從session中獲取所有數(shù)據(jù)，可以使用all方法：

$data = $request->session()->all();

還可以使用全局的PHP函數(shù)session來(lái)獲取和存儲(chǔ)session中的數(shù)據(jù)：

$app->get('home', function () {
    // 從session中獲取數(shù)據(jù)...
    $value = session('key');

    // 存儲(chǔ)數(shù)據(jù)到session...
    session(['key' => 'value']);
});

判斷session中是否存在指定項(xiàng)

has方法可用于檢查數(shù)據(jù)項(xiàng)在session中是否存在。如果存在的話返回true：

if ($request->session()->has('users')) {
    //
}

在session中存儲(chǔ)數(shù)據(jù)

獲取到session實(shí)例后，就可以調(diào)用多個(gè)方法來(lái)與底層數(shù)據(jù)進(jìn)行交互，例如，put方法存儲(chǔ)新的數(shù)據(jù)到session中：

$request->session()->put('key', 'value');

推送數(shù)據(jù)到數(shù)組session

push 方法可用于推送數(shù)據(jù)到值為數(shù)組的session，例如，如果user.teams鍵包含團(tuán)隊(duì)名數(shù)組，可以像這樣推送新值到該數(shù)組：

$request->session()->push('user.teams', 'developers');

獲取并刪除數(shù)據(jù)

pull方法將會(huì)從session獲取并刪除數(shù)據(jù)：

$value = $request->session()->pull('key', 'default');

從session中刪除數(shù)據(jù)項(xiàng)

forget方法從session中移除指定數(shù)據(jù)，如果你想要從session中移除所有數(shù)據(jù)，可以使用flush方法：

$request->session()->forget('key');
$request->session()->flush();

重新生成Session ID

如果你需要重新生成session ID，可以使用regenerate方法：

$request->session()->regenerate();

2.1 一次性數(shù)據(jù)

有時(shí)候你可能想要在session中存儲(chǔ)只在下個(gè)請(qǐng)求中有效的數(shù)據(jù)，可以通過(guò)flash方法來(lái)實(shí)現(xiàn)。使用該方法存儲(chǔ)的session數(shù)據(jù)只在隨后的HTTP請(qǐng)求中有效，然后將會(huì)被刪除：

$request->session()->flash('status', 'Task was successful!');

如果你需要在更多請(qǐng)求中保持該一次性數(shù)據(jù)，可以使用reflash方法，該方法將所有一次性數(shù)據(jù)保留到下一個(gè)請(qǐng)求，如果你只是想要保存特定一次性數(shù)據(jù)，可以使用keep方法：

$request->session()->reflash();
$request->session()->keep(['username', 'email']);