Session

• 組態
• Session 用法
• 快閃資料（Flash Data）
• 資料庫 Sessions
• Session 驅動

組態

由於 HTTP 協定是無狀態（Stateless）的，所以 session 提供一種儲存用戶資料的方法。Laravel 支援了多種 session 後端驅動，並透過清楚、統一的 API 提供使用。也內建支援像是 Memcached、Redis 和資料庫的後端驅動。

session 的設定檔配置在 app/config/session.php 中，請務必看一下 session 設定檔中可用的選項設定及註解。Laravel 預設使用 file 的 session 驅動，它在大多的應用中可以良好運作。

保留鍵值

Laravel 框架在內部有使用 flash 作為 session 的鍵值，所以應該避免 session 使用此名稱。

Session 用法

儲存項目到 Session 中

Session::put('key', 'value');

儲存項目進 Session 陣列值中

Session::push('user.teams', 'developers');

從 Session 取回項目

$value = Session::get('key');

從 Session 取回項目，若無則回傳預設值

$value = Session::get('key', 'default');

$value = Session::get('key', function() { return 'default'; });

從 Session 取回項目，並刪除

$value = Session::pull('key', 'default');

從 Session 取出所有項目

$data = Session::all();

判斷項目在 Session 中是否存在

if (Session::has('users'))
{
	//
}

移除 Session 中指定的項目

Session::forget('key');

清空整個 Session

Session::flush();

重新產生 Session ID

Session::regenerate();

快閃資料（Flash Data）

有時你可能希望暫存一些資料，並只在下次請求有效。你可以使用 Session::flash 方法來達成目的：

Session::flash('key', 'value');

刷新當前快閃資料，延長到下次請求

Session::reflash();

只刷新指定快閃資料

Session::keep(array('username', 'email'));

資料庫 Sessions

當使用 database session 驅動時，你必需建置一張儲存 session 的資料表。下方範例使用 Schema 來建表：

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

當然你也可以使用 Artisan 指令 session:table 來建表：

php artisan session:table

composer dump-autoload

php artisan migrate

Session 驅動

session 設定檔中的「driver」定義了 session 資料將以哪種方式被儲存。Laravel 提供了許多良好的驅動：

• file - sessions 將儲存在 app/storage/sessions 資料夾中。
• cookie - sessions 將安全儲存在加密的 cookies 中。
• database - sessions 將儲存在你的應用程式資料庫中。
• memcached / redis - sessions 將儲存在一個高速快取的系統中。
• array - sessions 將單純的以 PHP 陣列儲存，只存在當次請求。

注意： 運行 unit tests 時，session 驅動會被設定為 array，所以不會留下任何 session 資料。