简介

由于 HTTP 是无状态的，Session 提供了一种在多个请求之间存储有关用户信息的方法。Laravel 附带支持了多种 Session 后端驱动，它们都可以通过语义化统一的 API 访问。Laravel 本身支持比较热门的 Session 后端驱动，如 Memcached、 Redis 和数据库。

配置

Session 相关的配置文件存储在 php config/session.php。请务必查看此文件中对于你可用的选项。默认设置下，Laravel 的配置是使用文件作为 Session 驱动，大多数情况下能够运行良好。在生产环境下，你可以考虑使用 php memcached 或 php redis 驱动来达到更出色的性能表现。

Session 配置的 php driver 的选项定义了每次请求的 Session 数据的存储位置。Laravel 附带了几个不错且可开箱即用的驱动：

php file - 将 Session 保存在 php storage/framework/sessions。
php cookie - Session 保存在安全加密的 Cookie 中。
php database - Session 保存在关系型数据库。
php memcached / php redis - 将 Sessions 保存在其中一个快速且基于缓存的存储系统中。
php array - 将 Sessions 保存在简单的 PHP 数组中，并只存在于本次请求.

数组驱动一般用于 测试 防止存储在 Session 的数据被持久化。

驱动条件

数据库
使用 数据库 作为 Session 驱动时，你需要创建一张包含 Session 各项数据的表。以下例子是使用 php Schema 建表：

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

也可以使用 php Artisan 的 php session:table 命令生成一个迁移文件：

php artisan session:table
php artisan migrate

Redis
在使用 Redis 作为 Session 驱动之前，你需要通过 Composer 安装 php predis/predis 扩展包(~1.0)。你还需要在 php database 配置文件中指定 Redis 连接参数信息。在 Session 配置文件中的 php connection 选项中指定 Session 使用的 Redis 连接。

使用 Session

获取 Session 数据

Laravel 中有两种主要的方式使用 Session 数据的方式：一种是全局的辅助函数 php session，另一种是通过 HTTP 请求实例。首先，我们先看一下第二种方法，就是通过具有控制器方法类型提示的 HTTP 请求实例来访问 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 获取值时，你也可以传递一个默认值作为 php get 方法的第二个参数。如果 Session 中并不存在指定的键值便会返回传入的默认值。若传递一个闭包作为 php get 方法的默认值且请求的键值并不存在时，此时 php get 方法会返回这个闭包函数运行后的返回值：

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

全局 Session 辅助函数
你也可以使用全局的 PHP 函数 php session 来获取和存储 Session 数据。 使用单个字符串类型的值作为参数调用 php session 函数时，它将返回字该符串参数对应的 Session 键值。当使用一个 key / value 键值对数组作为参数调用 php session 函数时，传入的键值将会存入 Session：

Route::get('home', function () {
    // 获取 Session 中的一条数据...
    $value = session('key');
    // 指定一个默认值...
    $value = session('key', 'default');
    // 存储一条数据至 Session 中...
    session(['key' => 'value']);
});

HTTP 请求实例与 php Session 全局辅助函数使用 Session 并没有实质上的区别。两种方法都是可以通过 php assertSessionHas 方法 测试 ，php assertSessionHas 方法在所有的测试用例都是可用的。关于测试的更多信息，请阅读文档 测试

获取所有 Session 数据
如果你想要获取所有的 Session 数据，可以使用 php all 方法：

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

判断某个 Session 值是否存在
使用 php has 方法检查某个值是否存在于 Session 内，如果该值存在并且不为 null，那么则返回 true：

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

在判断值是否在 Session 中是否存时，如果该值可能为 null，你需要使用 exists 方法，如果该值存在，那么则返回 true：

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

存储 Session 数据

存储数据到 Session，你可用使用 php put 方法，或者 php session 辅助函数。

// 通过 HTTP 请求实例...
$request->session()->put('key', 'value');
// 通过全局辅助函数
session(['key' => 'value']);

保存数据进 Session 数组值中
push 方法可以将一个新的值加入至一个 Session 数组内。例如，假设 user.teams 这个键是包含团队名称的数组，你可以将一个新的值加入此数组中。比如这样：

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

从 Session 中取出并删除数据
php pull 方法将把数据从 Session 内取出，并且删除：

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

闪存数据到 Session

有时候你想存入一条缓存的数据，让它只在下一次的请求内有效，则可以使用 php flash 方法。使用这个方法保存 session，只能将数据保留到下个 HTTP 请求，然后就会被自动删除。闪存数据在短期的状态消息中很有用：

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

如果需要保留闪存数据给更多请求，可以使用 php reflash 方法，这将会将所有的闪存数据保留给额外的请求。如果想保留特定的闪存数据，则可以使用 php keep 方法：

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

删除 Session 数据

php forget 方法可以从 Session 内删除一条数据。如果你想删除 Session 内所有数据，则可以使用 php flush 方法：

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

重新生成 Session ID

重新生成 Session ID，通常时为了防止恶意用户利用 session fixation 对应用进行攻击。

如果你使用了内置函数 php LoginController，那么 Laravel 会自动重新生成 Session ID，否则，你需要手动使用 php regenerate 方法重新生成 Session ID

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

添加自定义 Session 驱动

实现驱动
你自定义的 Session 驱动必须实现 php SessionHandlerInterface 接口。这个接口包含了一些基本需要实现的方法。一个基本的 MongoDB 实现应该看起来像这样：

<?php
namespace App\Extensions;
class MongoHandler 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) {}
}

Laravel 默认没有附带扩展目录，你可以把它放在你喜欢的目录内。在下面这个例子中，我们创建了一个 php Extensions 目录放置自定义的 php MongoHandler 扩展。

接口中的这些方法不太容易容易理解。让我们来快速了解每个方法的作用：

php open 方法通常用于基于文件的 Session 存储系统。因为 Laravel 已经附带了一个 php file 的驱动，所以在该方法中不需要放置任何代码。PHP 要求必需要有这个方法的实现，但你可以把这方法置空也没关系。
php close 方法跟 php open 方法很相似，通常也可以被忽略。对大多数的驱动而言，此方法并不是需要的。
php read 方法应当返回与给定的 php $sessionId 相匹配的 Session 数据的字符串版本。从这个自定义的驱动中获取或存储 Session 数据不需要做任何序列化或其它编码，因为 Laravel 已经为我们做了序列化。
php write 将与 php $sessionId 关联的特定 php $data 字符串，写入到持久化存储系统，如 MongoDB、Dynamo 等等。再次重申，你不需要做任何序列化或其它编码，因为 Laravel 会自动处理这些事情。
php destroy 方法从持久化存储中移除 php $sessionId 对应的数据。
php gc 方法能销毁 php $lifetime 之前的所有数据，php $lifetime 是一个 UNIX 的时间戳。对本身拥有过期机制的系统如 Memcached 和 Redis 而言，该方法可以留空。

注册驱动
在 Session 驱动实现了 php SessionHandlerInterface 接口后，你还需要在框架中注册该驱动，将该扩展驱动添加到 Laravel Session 后端。你可以使用 php Session Facade 的 php extend 方法。在 服务提供者 的 php boot 方法内调用 php extend 方法。你可用使用已经存在的 php AppServiceProvider 或者创建一个新的提供者。

<?php
namespace App\Providers;
use App\Extensions\MongoSessionStore;
use Illuminate\Support\Facades\Session;
use Illuminate\Support\ServiceProvider;
class SessionServiceProvider extends ServiceProvider
{
    /**
     * 提供注册后运行的服务。
     *
     * @return void
     */
    public function boot()
    {
        Session::extend('mongo', function ($app) {
            // Return implementation of SessionHandlerInterface...
            return new MongoSessionStore;
        });
    }
    /**
     * 在容器中注册绑定。
     *
     * @return void
     */
    public function register()
    {
        //
    }
}

一旦 Session 驱动被注册，则必须在 php config/session.php 的配置文件内使用 php Mongo 驱动。