Session

简介

由于 HTTP 协议是无状态的,所以 session 提供了一种保存用户数据的方法。Laravel 附带支持了多种 session 后端驱动,并通过统一的 API 进行使用。也内置支持像是 MemcachedRedis 和数据库这样的后端驱动。

配置

Session 的配置文件在 config/session.php。请务必看一下此配置文件中可用的设置选项及注释。Laravel 默认使用 file 的 session 驱动,它在大多数应用中可以良好运作。在上线的应用程序中,你可能会考虑使用更快的 memcachedredis 等驱动。

Session driver 定义数据将由什么样的方式进行存储。Laravel 附带了几个不错且可立即使用的驱动:

  • file - 将 sessions 保存在 storage/framework/sessions 中。
  • cookie - 将 sessions 安全的保存在加密后的 cookies 中。
  • database - 将 sessions 保存在应用程序使用的数据库中。
  • memcached / redis - 将 sessions 保存在其中一个快速且基于缓存的存储系统中。
  • array - 将 sessions 保存在简单的 PHP 数组中,并只存在于本次请求。

注意:数组驱动一般应在 测试 环境下使用,以防止 session 数据持续存在。

--

译者注:推荐使用 Redis 来做 Session 驱动。Session 和缓存一起使用 Redis 的话,还需要多余的配置,请参考 - Laravel 下配置 Redis 让缓存、Session 各自使用不同的 Redis 数据库

驱动介绍

数据库

当使用 database session 驱动时,你必需先构建保存 session 项目的数据表。以下例子使用 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');
});

你也可使用 session:table Artisan 命令生成迁移文件!

php artisan session:table

composer dump-autoload

php artisan migrate

Redis

在 Laravel 使用 Redis Session 之前,你需要先通过 Composer 安装 predis/predis(~1.0) 扩展包。

其它的 Session 使用注意事项

Laravel 框架在内部使用了 flash 作为 session 的键,所以应该避免 session 使用此名称。

如果你的 session 数据需要加密,可将配置文件中的 encrypt 选项设为 true

基本用法

访问 Session

我们可在控制器方法内通过对 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 showProfile(Request $request, $id)
    {
        $value = $request->session()->get('key');

        //
    }
}

你可以在 get 方法中的第二个参数内设置一个默认值,当指定的键名不存在时,将会返回设置的默认值。如果你传入一个 闭包 作为 get 方法的默认值,该 闭包 将被运行并返回它的结果:

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

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

如果你想从 session 中获取所有数据,则可以使用 all 方法:

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

你也可使用全局的 session PHP 函数来获取 session 中保存的数据:

Route::get('home', function () {
    // 获取 session 中的一条数据...
    $value = session('key');

    // 写入一条数据至 session 中...
    session(['key' => 'value']);
});

判断项目在 Session 中是否存在

has 方法被用于检查项目是否存在于 session 内。如果存在将会返回 true

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

保存数据到 Session 中

只要你可以访问到 session 实例,就可以调用多个函数来调整里面的数据。例如,put 方法能将一个新的数据加入现有的 session 内。

$request->session()->put('key', 'value');

保存数据进 Session 数组值中

push 方法可以将一个新的值加入至一个 session 数组内。例如,假设 user.teams 这个键是包含团队名称的数组,则可以将一个新的值加入此数组中:

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

从 Session 中取出并删除数据

pull 方法将把数据从 session 内取出,并且删除它:

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

从 Session 中移除数据

forget 方法可以从 session 内删除一条数据。如果你想删除 session 内所有数据,则可以使用 flush 方法:

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

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

重新生成 Session ID

如果你想重新生成 session ID,则可以使用 regenerate 方法:

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

闪存数据

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

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

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

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

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

加入自定义的 Session 驱动

若要加入额外驱动至 Laravel 的 session 中,则可以使用 Session facadeextend 方法。在 服务提供者boot 方法内调用 extend 方法:

<?php

namespace App\Providers;

use Session;
use App\Extensions\MongoSessionStore;
use Illuminate\Support\ServiceProvider;

class SessionServiceProvider extends ServiceProvider
{
    /**
     * 提供注册后运行的服务。
     *
     * @return void
     */
    public function boot()
    {
        Session::extend('mongo', function($app) {
            // 返回 SessionHandlerInterface 的实现...
            return new MongoSessionStore;
        });
    }

    /**
     * 在容器中注册绑定。
     *
     * @return void
     */
    public function register()
    {
        //
    }
}

请注意,你自定义的 session 驱动必须实现 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) {}
}

这些方法就像缓存的 StoreInterface 一样不是那么容易理解。让我们来快速了解每个方法的作用:

  • open 方法通常用在基于文件的 session 存储系统中。像 Larvel 就附带了一个 file 的驱动,所以你不用把任何东西放到这个方法内。你可以把这方法看做是空的也没关系。主要是因为其接口设计不佳(我们将在后面讨论),所以 PHP 要求必需要有这个方法的实现。
  • close 方法跟 open 方法很相似,通常也被忽略了。对大多数的驱动而言,此方法并不是需要的。
  • read 方法必须根据给予的 $sessionId 返回关联的 session 数据的字符串版本。这在驱动中并不需要做任何的编码跟序列化动作,在 Laravel 内已经会自动运行。
  • write 方法必须在大部分存储系统内写入 $data 字符串时关联至 $sessionId,如 MongoDB、Dynamo 等等。
  • destroy 方法能删除与 $sessionId 相关联的数据。
  • gc 方法能删除 $lifetime 之前的所有数据,$lifetime 是一个 UNIX 的时间戳。但在一些如 Memcached 和 Redis 这样的系统中,使用这个方法可能会留下一段空白的存储数据。

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


{note} 欢迎任何形式的转载,但请务必注明出处,尊重他人劳动共创开源社区。

转载请注明:本文档由 Laravel China 社区 [laravel-china.org] 组织翻译。

文档永久地址: http://d.laravel-china.org