HTTP 會(huì)話機(jī)制

• 簡介
  • 配置
  • 驅(qū)動(dòng)程序先決條件
• 使用 Session
  • 獲取數(shù)據(jù)
  • 存儲(chǔ)數(shù)據(jù)
  • 閃存數(shù)據(jù)
  • 刪除數(shù)據(jù)
  • 重新生成 Session ID
• 添加自定義 Session 驅(qū)動(dòng)
  • 實(shí)現(xiàn)驅(qū)動(dòng)
  • 注冊(cè)驅(qū)動(dòng)

簡介

由于 HTTP 驅(qū)動(dòng)的應(yīng)用程序是無狀態(tài)的，Session 提供了一種在多個(gè)請(qǐng)求之間存儲(chǔ)有關(guān)用戶信息的方法，Laravel 通過同一個(gè)可讀性強(qiáng)的 API 處理各種自帶的后臺(tái)驅(qū)動(dòng)程序。支持諸如比較熱門的 Memcached, Redis 和數(shù)據(jù)庫。

配置

Session 的配置文件存儲(chǔ)在 config/session.php 文件中。請(qǐng)務(wù)必查看此文件中對(duì)于你而言可用的選項(xiàng)。默認(rèn)情況下，Laravel 為絕大多數(shù)應(yīng)用程序配置的 Session 驅(qū)動(dòng)為 file  。在生產(chǎn)環(huán)境中，你可以考慮使用 memcached 或 redis  驅(qū)動(dòng)，讓 Session 的性能更加出色。

Session driver 的配置預(yù)設(shè)了每個(gè)請(qǐng)求存儲(chǔ) Session 數(shù)據(jù)的位置。Laravel 自帶了幾個(gè)不錯(cuò)而且開箱即用的驅(qū)動(dòng)：

{tip} 數(shù)組驅(qū)動(dòng)一般用于 測試 并且防止存儲(chǔ)在 Session 中的數(shù)據(jù)被持久化。

驅(qū)動(dòng)程序先決條件

數(shù)據(jù)庫

使用 database 作為 Session 驅(qū)動(dòng)時(shí)，你需要?jiǎng)?chuàng)建一張包含 Session 各項(xiàng)數(shù)據(jù)的表。以下是使用 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 驅(qū)動(dòng)之前，需要通過 Composer 安裝 predis/predis 擴(kuò)展包 (~1.0)。然后在 database 配置文件中配置 Redis 連接信息。在 session 配置文件中，connection 選項(xiàng)可用于指定 Session 使用哪個(gè) Redis 連接。

使用 Session

獲取數(shù)據(jù)

Laravel 中處理 Session 數(shù)據(jù)有兩種主要方法：全局輔助函數(shù) session 和通過一個(gè) Request 實(shí)例。首先，我們來看看通過控制器方法類型提示一個(gè) Request 實(shí)例來訪問 session?？刂破鞣椒ㄒ蕾図?xiàng)會(huì)通過 Laravel 服務(wù)容器 實(shí)現(xiàn)自動(dòng)注入：

<?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');    
        //   
       }
     }

當(dāng)你從 Session 獲取值時(shí)，你還可以傳遞一個(gè)默認(rèn)值作為 get 方法的第二個(gè)參數(shù)。如果 Session 中不存在指定的鍵，便會(huì)返回這個(gè)默認(rèn)值。若傳遞一個(gè)閉包作為 get 方法的默認(rèn)值，并且所請(qǐng)求的鍵并不存在時(shí)，get 方法將執(zhí)行閉包并返回其結(jié)果：

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

全局輔助函數(shù) Session

你也可以使用全局的 PHP 輔助函數(shù) session 來獲取和存儲(chǔ) Session 數(shù)據(jù)。 使用單個(gè)字符串類型的值作為參數(shù)調(diào)用輔助函數(shù) session 時(shí)，它會(huì)返回該字該符串對(duì)應(yīng)的 Session 鍵的值。當(dāng)使用一個(gè)鍵值對(duì)數(shù)組作為參數(shù)調(diào)用輔助函數(shù) session 時(shí)，傳入的鍵值將會(huì)存儲(chǔ)在 Session 中：

Route::get('home', function () { 
   // 獲取 session 中的一條數(shù)據(jù)...  
   $value = session('key');    
   // 指定一個(gè)默認(rèn)值...    
   $value = session('key', 'default');    
   // 在 Session 中存儲(chǔ)一條數(shù)據(jù)...    
   session(['key' => 'value']);
});

{tip} 通過 HTTP 請(qǐng)求實(shí)例操作 Session 與使用全局輔助函數(shù) session 兩者之間并沒有實(shí)質(zhì)上的區(qū)別。這兩種方法都可以通過所有測試用例中可用的 assertSessionHas 方法進(jìn)行 測試 。

獲取所有的 Session 數(shù)據(jù)

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

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

判斷 Session 中是否存在某個(gè)值

要確定 Session 中是否存在某個(gè)值，可以使用 has 方法。如果該值存在且不為 null，那么 has 方法會(huì)返回 true：

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

要確定 Session 中是否存在某個(gè)值，即使其值為 null，也可以使用 exists 方法。如果值存在，則 exists 方法返回 true：

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

存儲(chǔ)數(shù)據(jù)

想要存儲(chǔ)數(shù)據(jù)到 Session，你可以使用 put 方法，或者使用輔助函數(shù) session。

// 通過請(qǐng)求實(shí)例...
$request->session()->put('key', 'value');
// 通過全局輔助函數(shù)...
session(['key' => 'value']);

在 Session 數(shù)組中保存數(shù)據(jù)

push 方法可以將一個(gè)新的值添加到 Session 數(shù)組內(nèi)。例如，假設(shè) user.teams 這個(gè)鍵是包括團(tuán)隊(duì)名稱的數(shù)組，你可以這樣將一個(gè)新的值加入到數(shù)組中：

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

檢索 & 刪除一條數(shù)據(jù)

pull 方法可以只使用一條語句就從 Session 中檢索并刪除一條語句：

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

閃存數(shù)據(jù)

有時(shí)候你可能想在 Session 中保存數(shù)據(jù)用于下一次請(qǐng)求，這時(shí)你可以使用 flash 方法。使用這個(gè)方法保存在 Session 中的數(shù)據(jù)，只會(huì)保留到下一個(gè) HTTP 請(qǐng)求到來之前，然后就會(huì)被刪除。閃存數(shù)據(jù)主要用于短期的狀態(tài)消息：

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

如果你需要在更多的請(qǐng)求中使用到該一次性數(shù)據(jù)，你可以使用  reflash 方法，該方法會(huì)將所有一次性請(qǐng)求保留到下一次請(qǐng)求。如果你想保存一次性數(shù)據(jù)，你可以用 keep 方法：

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

刪除數(shù)據(jù)

forget 方法會(huì)從 Session 中刪除指定數(shù)據(jù)，如果想從 Session 中刪除所有數(shù)據(jù)，可以使用 flush 方法：

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

重新生成 Session ID

重新生成 session ID 通常是為了防止惡意用戶利用  session fixation 對(duì)你的應(yīng)用進(jìn)行攻擊。

如果你使用了內(nèi)置函數(shù) LoginController，Laravel 會(huì)自動(dòng)重新生成身份認(rèn)證中的 Session ID。否則，你需要手動(dòng)使用 regenerate 方法重新生成 Session ID。

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

添加自定義 Session 驅(qū)動(dòng)

實(shí)現(xiàn)驅(qū)動(dòng)

你自定義的 Session 驅(qū)動(dòng)必須實(shí)現(xiàn) SessionHandlerInterface 接口。這個(gè)接口包含了一些我們需要實(shí)現(xiàn)的簡單方法。下面是 MongoDB 實(shí)現(xiàn)的大概流程示例：

<?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 默認(rèn)沒有附帶一個(gè)用于包擴(kuò)展的目錄，你可以把它放在你喜歡的目錄內(nèi)。在上面這個(gè)例子中，我們創(chuàng)建了一個(gè) Extensions 目錄用于存放 MongoSessionHandler。

由于以上方法并不是很容易理解，所以我們接下來快速過一遍每一個(gè)方法：

注冊(cè)驅(qū)動(dòng)

當(dāng)實(shí)現(xiàn)驅(qū)動(dòng)后，需要在框架中注冊(cè)它。在 Laravel 后端添加額外的驅(qū)動(dòng)，需要使用 Session facade 的 extend 方法。你應(yīng)該在 服務(wù)提供者 中的 boot 方法中調(diào)用 extend 方法。你可以在已有的  AppServiceProvider 或者另外創(chuàng)建一個(gè)服務(wù)提供者執(zhí)行此操作：

<?php
   namespace App\Providers;
   use App\Extensions\MongoSessionHandler;
   use Illuminate\Support\Facades\Session;
   use Illuminate\Support\ServiceProvider;
   class SessionServiceProvider extends ServiceProvider{    
      /**
     * 執(zhí)行服務(wù)的注冊(cè)后啟動(dòng)
     *
     * @return void
     */  
   public function boot()  
     {      
       Session::extend('mongo', function ($app) {           
        // 返回實(shí)現(xiàn) SessionHandlerInterface 的對(duì)象            
        return new MongoSessionHandler;        
        });    
      }    
     /**
     * 在容器中注冊(cè)綁定關(guān)系
     *
     * @return void
     */    
     public function register()  
       {    
           //    
        }
      }

驅(qū)動(dòng)完成注冊(cè)時(shí)，你可以在使用在配置文件 config/session.php 中使用 mongo 驅(qū)動(dòng)。