Session
Session
HTTP 會(huì)話機(jī)制
簡(jiǎn)介
由于 HTTP 驅(qū)動(dòng)的應(yīng)用程序是無(wú)狀態(tài)的，Session 提供了一種在多個(gè)請(qǐng)求之間存儲(chǔ)有關(guān)用戶信息的方法，Laravel 通過(guò)同一個(gè)可讀性強(qiáng)的 API 處理各種自帶的后臺(tái)驅(qū)動(dòng)程序。支持諸如比較熱門的 Memcached, Redis 和數(shù)據(jù)庫(kù)。
配置
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ò)而且開(kāi)箱即用的驅(qū)動(dòng)：
file- 將 Session 存儲(chǔ)在storage/framework/sessions中。cookie- Sessions 被存儲(chǔ)在安全加密的 cookie 中。database- Sessions 被存儲(chǔ)在關(guān)系型數(shù)據(jù)庫(kù)中。memcached/redis- Sessions 被存儲(chǔ)在基于高速緩存的存儲(chǔ)系統(tǒng)中。array- Sessions 存儲(chǔ)在 PHP 數(shù)組中，但不會(huì)被持久化。
{tip} 數(shù)組驅(qū)動(dòng)一般用于 測(cè)試 并且防止存儲(chǔ)在 Session 中的數(shù)據(jù)被持久化。
驅(qū)動(dòng)程序先決條件
數(shù)據(jù)庫(kù)
使用 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 來(lái)生成此遷移：
php artisan session:table php artisan migrate
Redis
Laravel 在使用 Redis 作為 Session 驅(qū)動(dòng)之前，需要通過(guò) Composer 安裝 predis/predis 擴(kuò)展包 (~1.0)。然后在 database 配置文件中配置 Redis 連接信息。在 session 配置文件中，connection 選項(xiàng)可用于指定 Session 使用哪個(gè) Redis 連接。
使用 Session
獲取數(shù)據(jù)
Laravel 中處理 Session 數(shù)據(jù)有兩種主要方法：全局輔助函數(shù) session 和通過(guò)一個(gè) Request 實(shí)例。首先，我們來(lái)看看通過(guò)控制器方法類型提示一個(gè) Request 實(shí)例來(lái)訪問(wèn) session?？刂破鞣椒ㄒ蕾図?xiàng)會(huì)通過(guò) 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 來(lái)獲取和存儲(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} 通過(guò) HTTP 請(qǐng)求實(shí)例操作 Session 與使用全局輔助函數(shù)
session兩者之間并沒(méi)有實(shí)質(zhì)上的區(qū)別。這兩種方法都可以通過(guò)所有測(cè)試用例中可用的assertSessionHas方法進(jìn)行 測(cè)試 。
獲取所有的 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。
// 通過(guò)請(qǐng)求實(shí)例...
$request->session()->put('key', 'value');
// 通過(guò)全局輔助函數(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 方法可以只使用一條語(yǔ)句就從 Session 中檢索并刪除一條語(yǔ)句：
$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)求到來(lái)之前，然后就會(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)的簡(jiǎ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)沒(méi)有附帶一個(gè)用于包擴(kuò)展的目錄，你可以把它放在你喜歡的目錄內(nèi)。在上面這個(gè)例子中，我們創(chuàng)建了一個(gè)
Extensions目錄用于存放MongoSessionHandler。
由于以上方法并不是很容易理解，所以我們接下來(lái)快速過(guò)一遍每一個(gè)方法：
open方法通常用于基于文件的 Session 存儲(chǔ)系統(tǒng)。因?yàn)?Laravel 已經(jīng)附帶了一個(gè)fileSession 驅(qū)動(dòng)。所以你不需要在該方法中放置任何代碼。PHP 要求必須要有這個(gè)方法的實(shí)現(xiàn)（這只是一個(gè)糟糕的接口設(shè)計(jì)），你只需要把這個(gè)方法置空。close方法跟open方法相似，通常也可以被忽略。對(duì)大多數(shù)的驅(qū)動(dòng)而言，此方法不是必須的。read方法應(yīng)當(dāng)返回與給定的$sessionId相匹配的 Session 數(shù)據(jù)的字符串格式。在你的自定義的驅(qū)動(dòng)中獲取或存儲(chǔ) Session 數(shù)據(jù)時(shí)，不需要進(jìn)行任何序列化或者其他編碼，因?yàn)?Laravel 會(huì)自動(dòng)為你執(zhí)行序列化。write方法將與$sessionId關(guān)聯(lián)的給定的$data字符串寫(xiě)入到一些持久化存儲(chǔ)系統(tǒng)，如 MongoDB、 Dynamo 等。再次重申，你不需要進(jìn)行任何序列化或其他編碼，因?yàn)?Laravel 會(huì)自動(dòng)為你處理這些事情。destroy方法將會(huì)從持久化存儲(chǔ)中與刪除與$sessionId相關(guān)的數(shù)據(jù)。gc方法能銷毀給定的$lifetime（UNIX 的時(shí)間戳）之前的所有數(shù)據(jù)。對(duì)本身?yè)碛羞^(guò)期機(jī)制的系統(tǒng)如 Memcached 和 Redis 而言，該方法可以置空。
注冊(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)。