HTTP 会话机制

简介

由于 HTTP 驱动的应用程序是无状态的,Session 提供了一种在多个请求之间存储有关用户信息的方法,Laravel 通过同一个可读性强的 API 处理各种自带的后台驱动程序。支持诸如比较热门的 Memcached, Redis 和数据库。

配置

Session 的配置文件存储在 config/session.php 文件中。请务必查看此文件中对于你而言可用的选项。默认情况下,Laravel 为绝大多数应用程序配置的 Session 驱动为 file 。在生产环境中,你可以考虑使用 memcachedredis 驱动,让 Session 的性能更加出色。

Session driver 的配置预设了每个请求存储 Session 数据的位置。Laravel 自带了几个不错而且开箱即用的驱动:

  • file - 将 Session 存储在 storage/framework/sessions 中。
  • cookie - Sessions 被存储在安全加密的 cookie 中。
  • database - Sessions 被存储在关系型数据库中。
  • memcached / redis - Sessions 被存储在基于高速缓存的存储系统中。
  • array - Sessions 存储在 PHP 数组中,但不会被持久化。

{tip} 数组驱动一般用于 测试 并且防止存储在 Session 中的数据被持久化。

驱动程序先决条件

数据库

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

  1. Schema::create('sessions', function ($table) {
  2. $table->string('id')->unique();
  3. $table->unsignedInteger('user_id')->nullable();
  4. $table->string('ip_address', 45)->nullable();
  5. $table->text('user_agent')->nullable();
  6. $table->text('payload');
  7. $table->integer('last_activity');
  8. });

你可以使用 Artisan 命令 session:table 来生成此迁移:

  1. php artisan session:table
  2. php artisan migrate

Redis

Laravel 在使用 Redis 作为 Session 驱动之前,需要通过 Composer 安装 predis/predis 扩展包 (~1.0)。然后在 database 配置文件中配置 Redis 连接信息。在 session 配置文件中,connection 选项可用于指定 Session 使用哪个 Redis 连接。

使用 Session

获取数据

Laravel 中处理 Session 数据有两种主要方法:全局辅助函数session和通过一个Request实例。首先,我们来看看通过控制器方法类型提示一个Request实例来访问 session。控制器方法依赖项会通过 Laravel 服务容器 实现自动注入:

  1. <?php
  2. namespace App\Http\Controllers;
  3. use Illuminate\Http\Request;
  4. use App\Http\Controllers\Controller;
  5. class UserController extends Controller
  6. {
  7. /**
  8. * 展示给定用户的配置文件。
  9. *
  10. * @param Request $request
  11. * @param int $id
  12. * @return Response
  13. */
  14. public function show(Request $request, $id)
  15. {
  16. $value = $request->session()->get('key');
  17. //
  18. }
  19. }

当你从 Session 获取值时,你还可以传递一个默认值作为get方法的第二个参数。如果 Session 中不存在指定的键,便会返回这个默认值。若传递一个闭包作为get方法的默认值,并且所请求的键并不存在时,get方法将执行闭包并返回其结果:

  1. $value = $request->session()->get('key', 'default');
  2. $value = $request->session()->get('key', function () {
  3. return 'default';
  4. });

全局辅助函数 Session

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

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

{tip} 通过 HTTP 请求实例操作 Session 与使用全局辅助函数session两者之间并没有实质上的区别。这两种方法都可以通过所有测试用例中可用的assertSessionHas方法进行 测试

获取所有的 Session 数据

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

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

判断 Session 中是否存在某个值

要确定 Session 中是否存在某个值,可以使用has方法。如果该值存在且不为null,那么has方法会返回true

  1. if ($request->session()->has('users')) {
  2. //
  3. }

要确定 Session 中是否存在某个值,即使其值为null,也可以使用exists方法。如果值存在,则exists方法返回true

  1. if ($request->session()->exists('users')) {
  2. //
  3. }

存储数据

想要存储数据到 Session,你可以使用 put 方法,或者使用辅助函数 session

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

在 Session 数组中保存数据

push 方法可以将一个新的值添加到 Session 数组内。例如,假设 user.teams 这个键是包括团队名称的数组,你可以这样将一个新的值加入到数组中:

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

检索 & 删除一条数据

pull 方法可以只使用一条语句就从 Session 中检索并删除一条语句:

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

闪存数据

有时候你可能想在 Session 中保存数据用于下一次请求,这时你可以使用 flash 方法。使用这个方法保存在 Session 中的数据,只会在下一个 HTTP 请求有效,然后就会被删除。闪存数据主要用于短期的状态消息:

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

如果你需要在更多的请求中使用到该一次性数据,你可以使用 reflash 方法,该方法会将所有一次性请求保留到下一次请求。如果你想保存一次性数据,你可以用 keep 方法:

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

删除数据

forget 方法会从 Session 中删除指定数据,如果想从 Session 中删除所有数据,可以使用 flush 方法:

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

重新生成 Session ID

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

如果你使用了内置函数 LoginController,Laravel 会自动重新生成身份认证中的 Session ID。否则,你需要手动使用 regenerate 方法重新生成 Session ID。

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

添加自定义 Session 驱动

实现驱动

你自定义的 Session 驱动必须实现 SessionHandlerInterface 接口。这个接口包含了一些我们需要实现的简单方法。下面是 MongoDB 实现的大概流程示例:

  1. <?php
  2. namespace App\Extensions;
  3. class MongoSessionHandler implements \SessionHandlerInterface
  4. {
  5. public function open($savePath, $sessionName) {}
  6. public function close() {}
  7. public function read($sessionId) {}
  8. public function write($sessionId, $data) {}
  9. public function destroy($sessionId) {}
  10. public function gc($lifetime) {}
  11. }

{tip} Laravel 默认没有附带一个用于包扩展的目录,你可以把它放在你喜欢的目录内。在上面这个例子中,我们创建了一个 Extensions 目录用于存放 MongoSessionHandler

由于以上方法并不是很容易理解,所以我们接下来快速过一遍每一个方法:

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

注册驱动

当实现驱动后,需要在框架中注册它。在 Laravel 后端添加额外的驱动,需要使用Session facadeextend 方法。你应该在 服务提供者 中的 boot 方法中调用 extend 方法。你可以在已有的 AppServiceProvider 或者另外创建一个服务提供者执行此操作:

<?php

namespace App\Providers;

use App\Extensions\MongoSessionHandler;
use Illuminate\Support\Facades\Session;
use Illuminate\Support\ServiceProvider;

class SessionServiceProvider extends ServiceProvider
{
    /**
     * 执行服务的注册后启动
     *
     * @return void
     */
    public function boot()
    {
        Session::extend('mongo', function ($app) {
            // 返回实现 SessionHandlerInterface 的对象
            return new MongoSessionHandler;
        });
    }

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

驱动完成注册时,你可以在使用在配置文件 config/session.php 中使用 mongo 驱动。

本文章首发在 LearnKu.com 网站上。

本文中的所有译文仅用于学习和交流目的,转载请务必注明文章译者、出处、和本文链接 我们的翻译工作遵照 CC 协议,如果我们的工作有侵犯到您的权益,请及时联系我们。