展開文件目錄

HTTP Session

介紹

由於 HTTP 驅動的應用程式是無狀態的,因此 Session 提供一種跨越多個請求來儲存關於使用者資訊的方法。Laravel 內建使用直觀且一致的 API 來存取各種 Session 後端,並支援目前較熱門的後端驅動,像是 MemcachedRedis 和資料庫。

設定

Session 設定檔被存放在 config/session.php。請確實的查看檔案中的可用選項。預設的 Laravel 被設定使用 file Session 驅動,這對於許多應用程式來說算是不錯。在正式上線的應用程式中,你可能會考慮使用 memcachedredis 驅動來追求更快的 Session 效能。

Session driver 設定選項用來定義每個請求所儲存的 Session 資料位置。Laravel 內建幾個很棒的驅動,且能馬上應用:

  • file - Session 被儲存到 storage/framework/sessions 中。
  • cookie - Session 被儲存到安全且被加密的 Cookie 中。
  • database - Session 被儲存到關聯資料庫中。
  • memcached / redis - Session 被儲存到其中一個快速且基於快取的儲存系統中。
  • array - Session 被儲存到一個 PHP 陣列中且不會被保留。

{tip} 陣列式驅動被用於測試的時候,並防止 Session 中的資料被永久儲存。

驅動需求

資料庫

在使用 database Session 驅動時,你會需要建立一個資料表來放置 Session 項目。以下是使用 Schema 建立資料表的範例:

Schema::create('sessions', function ($table) {
    $table->string('id')->unique();
    $table->unsignedInteger('user_id')->nullable();
    $table->string('ip_address', 45)->nullable();
    $table->text('user_agent')->nullable();
    $table->text('payload');
    $table->integer('last_activity');
});

你可以使用 Artisan 的 session:table 指令來產生這個遷移檔:

php artisan session:table

php artisan migrate

Redis

在使用 Laravel 搭配 Redis Session 之前,你會需要透過 Composer 來安裝predis/predis 套件(~1.0)。你可以在 database 設定檔中設定你的 Redis。在 session 設定檔中,connection 選項可被用於指定 Session 要使用哪一個 Redis 連線。

使用 Session

取得資料

Laravel 有兩種主要的方式來使用 Session 資料:全域的 session 輔助函式和透過 Request 實例。首先,讓我們觀察透過 Request 實例來存取該 Session,這個實例能直接注入在控制器的方法上。但請你記得,控制器方法依賴是透過 Laravel 服務容器來自動注入的:

<?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 show(Request $request, $id)
    {
        $value = $request->session()->get('key');

        //
    }
}

當你從 Session 中取得一個值得時候,你也可以傳入一個預設的值作為 get 方法的第二個參數。如果 Session 中沒有指定的鍵,就會回傳這個預設值。如果你傳入一個閉包作為 get 方法的預設值,結果請求的值並未存在時,就會執行閉包與回傳它的結果:

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

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

全域 Session 輔助函式

你也可以使用全域的 session PHP 函式來取得,並儲存 Session 中的資料。如果只使用一個字串參數來呼叫 session 輔助函式的時候,它會回傳 Session 鍵的值。當使用一組陣列的鍵與值來呼叫輔助函式時,這些值會被存到 Session 中:

Route::get('home', function () {
    // 從 Session 中取得一段資料...
    $value = session('key');

    // 指定一個預設值...
    $value = session('key', 'default');

    // 在 Session 中儲存一段資料...
    session(['key' => 'value']);
});

{tip} 不論是透過 HTTP 請求實例,還是使用全域的 session 輔助函式,這兩者之間並無實際上的差異。能透過 assertSessionHas 方法在所有測試案例中測試這兩種方法。

取得所有 Session 資料

如果你想要在 Session 中取得所有資料,你可以使用 all 方法:

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

確定項目是否存在於 Session

要確定一個值是否存在於 Session,你可以使用 has 方法。如果該值存在,has 方法就會回傳 true,如果沒有則回傳 null

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

要確認一個值是否存在於 Session,縱使這個值是 null,你可以使用 exists 方法。exists 方法會在該值存在時回傳 true

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

儲存資料

要在 Session 儲存資料,你通常會使用 put 方法或 session 輔助函式:

// 透過一個請求實例...
$request->session()->put('key', 'value');

// 透過全域輔助函式...
session(['key' => 'value']);

將 Session 值推入陣列中

push 方法可被用於將一個新的值推入一組放置 Session 值的陣列。例如,如果 user.teams 鍵中有一組團隊名稱的陣列,你可以將一個新值推入陣列中,就像:

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

取得與刪除一個項目

pull 方法只用一行句子就能從 Session 中取得和刪除一個項目:

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

快閃資料

有時你可能希望只有在下一個請求中才將項目儲存到 Session 裡。你可以使用 flash 方法來做到。使用這個方法來將資料儲存到 Session,資料只會保留到下一個 HTTP 請求之前,然後就會清除這些資料。快閃資料主要用於短期的狀態訊息:

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

如果你需要保留快閃資料給更多的請求,你可以使用 reflash 方法,這方法會將所有快閃資料保留到額外的請求。如果你只需要指定快閃資料,你可以使用 keep 方法:

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

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

刪除資料

forget 方法會從 Session 中移除資料片段。如果你想要從 Session 中移除所有資料,你可以使用 flush 方法:

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

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

重新產生 Session ID

重新產生 Session ID 通常是為了預防惡意使用者利用 session fixation 來攻擊你的應用程式。

如果使用內建的 LoginController,Laravel 會在認證過程中自動重新產生 Session ID。然而,如果你需要手動重新產生 Session ID,你可以使用 regenerate 方法。

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

新增自訂的 Session 驅動

實作驅動

你自訂的 Session 驅動會實作 SessionHandlerInterface 介面。這個介面就只有一些需要我們實作的簡易的方法。一個基本 MongoDB 的實作大概會像這個:

<?php

namespace App\Extensions;

class MongoSessionHandler implements \SessionHandlerInterface
{
    public function open($savePath, $sessionName) {}
    public function close() {}
    public function read($sessionId) {}
    public function write($sessionId, $data) {}
    public function destroy($sessionId) {}
    public function gc($lifetime) {}
}

{tip} Laravel 內建沒有提供用來延伸的目錄。所以你可以隨意放置在你想要的地方。在本範例中,我們建立了一個 Extensions 目錄來放置 MongoSessionHandler

由於這些方法不是那麼容易理解,所以讓我們快速的快速的了解每一個方法吧:

  • open 方法通常用在基於檔案的 session 儲存系統中。因為 Larvel 內建就有 file 的驅動,你幾乎不用在方法內寫任何東西。你可以讓這個方法保持空的。只是基於不良的介面設計(我們將在之後討論),PHP 要求必實作此方法。
  • close 方法跟 open 方法很像,通常可以忽略,對大多數的驅動而言都不需要。
  • read 方法必須根據給予的 $sessionId 回傳關聯的 session 資料的字串版本。在驅動中取得或儲存資料都不需要做任何的編碼跟序列化的動作,因為 Laravel 會幫你完成序列化。
  • write 方法要能將與 $sessionId 關聯的 $data 字串存入永久儲存系統,如 MongoDB、Dynamo 等等。再說一次,你不應該執行任何序列化 - Laravel 都已經為你處理。
  • destroy 方法要能從永久儲存系統刪除與 $sessionId 關聯的資料。
  • gc 方法要能刪除給予 $lifetime 之前的所有資料,$lifetime 是一個 UNIX 的時間戳記。在 Memcached 和 Redis 這類會自動過期的系統中,可以讓此方法保持空的。

註冊驅動

一旦你的驅動程式已經實作,你就可以準備在框架中註冊它,要新增額外的驅動到 Laravel Session 後端,你可以在 Session facade 上使用 extend。你應該從一個服務提供者boot 方法中呼叫 extend 方法。你可以從現有的 AppServiceProvider 或建立一個全新的提供者來做到:

<?php

namespace App\Providers;

use App\Extensions\MongoSessionHandler;
use Illuminate\Support\Facades\Session;
use Illuminate\Support\ServiceProvider;

class SessionServiceProvider extends ServiceProvider
{
    /**
     * 執行註冊後啟動服務。
     *
     * @return void
     */
    public function boot()
    {
        Session::extend('mongo', function ($app) {
            // 回傳 SessionHandlerInterface 實作...
            return new MongoSessionHandler;
        });
    }

    /**
     * 在容器中註冊綁定。
     *
     * @return void
     */
    public function register()
    {
        //
    }
}

Session 驅動一旦被註冊,你就可以在 config/session.php 設定檔中使用 mongo 驅動。