Info
Content

Session

由 学院君 创建于1年前, 最后更新于 7个月前    版本号 #2    1753 views    0 likes    0 collects

简介

由于 HTTP 协议本身是无状态的，上一个请求与下一个请求无任何关联，为此我们引入 Session 来存储用户请求信息以解决特定场景下无状态导致的问题（比如登录、购物）。Laravel 通过简洁的 API 统一处理后端各种 Session 驱动，目前开箱支持的流行后端驱动包括 Memcached、Redis 和数据库。

配置

Session 配置文件位于 config/session.php。默认情况下，Laravel 使用的 Session 驱动为 file 驱动，这对许多应用而言是没有什么问题的。在生产环境中，你可能考虑使用 memcached 或者 redis 驱动以便获取更佳的 Session 性能，尤其是线上同一个应用部署到多台机器的时候，这是最佳实践。

Session 的 driver 配置项用于定义请求的 Session 数据存放在哪里，Laravel 可以处理多种类型的驱动：

  • file – Session 数据存储在 storage/framework/sessions 目录下。
  • cookie – Session 数据存储在经过安全加密的 Cookie 中。
  • database – Session 数据存储在数据库中。
  • memcached / redis – Session 数据存储在 Memcached/Redis 缓存中，访问速度最快。
  • dynamodb - Session 数据存储在 AWS DynamoDB。
  • array – Session 数据存储在简单 PHP 数组中，在多个请求之间是非持久化的。

注：数组驱动通常在测试期间使用以避免 Session 数据持久化。

驱动预备知识

数据库

当使用 database 作为 Session 驱动时，需要设置表包含 Session 字段，下面是该数据表的表结构声明：

use Illuminate\Database\Schema\Blueprint;
use Illuminate\Support\Facades\Schema;
 
Schema::create('sessions', function (Blueprint $table) {
    $table->string('id')->primary();
    $table->foreignId('user_id')->nullable()->index();
    $table->string('ip_address', 45)->nullable();
    $table->text('user_agent')->nullable();
    $table->text('payload');
    $table->integer('last_activity')->index();
});

你可以使用 Artisan 命令 session:table 在数据库中创建这张表：

php artisan session:table

php artisan migrate

Redis

在 Laravel 中使用 Redis 作为 Session 驱动前，需要通过 Composer 安装 predis/predis 包。可以在 database 配置文件中配置 Redis 连接，在 Session 配置文件中，connection 选项用于指定 Session 使用哪一个 Redis 连接。

注：关于 Redis 的更多配置细节，请参考相应的 Laravel 文档。

使用 Session

获取数据

在 Laravel 中主要有两种方式处理 Session 数据：全局的辅助函数 session，或者通过 Request 实例（启动过程中会将 Session 数据设置到请求实例的 session 属性中）。首先，我们通过 Request 实例来访问 Session 数据，我们可以在控制器方法中对请求实例进行依赖注入（控制器方法依赖通过 Laravel 服务容器自动注入）：

<?php
 
namespace App\Http\Controllers;
 
use App\Http\Controllers\Controller;
use Illuminate\Http\Request;
use Illuminate\View\View;
 
class UserController extends Controller
{
    /**
     * Show the profile for the given user.
     */
    public function show(Request $request, string $id): View
    {
        $value = $request->session()->get('key');
 
        // ...
 
        $user = $this->users->find($id);
 
        return view('user.profile', ['user' => $user]);
    }
}

从 Session 中获取数据的时候，还可以传递默认值作为第二个参数到 get 方法，默认值在指定键在 Session 中不存在时返回。如果你传递一个闭包作为默认值到 get 方法，该闭包会执行并返回执行结果：

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

全局 Session 辅助函数

还可以使用全局的 PHP 函数 session 来获取和存储 Session 数据，如果只传递一个字符串参数到 session 方法，则返回该 Session 键对应的值；如果传递的参数是 key/value 键值对数组，则将这些数据保存到 Session：

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

注：通过 HTTP 请求实例和辅助函数 session 处理数据并无实质性差别，这两个方法在测试用例中都可以通过 assertSessionHas 方法进行测试。

获取所有 Session 数据

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

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

判断 Session 中是否存在指定项

has 方法可用于检查数据项在 Session 中是否存在。如果存在并且不为 null 的话返回 true：

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

要判断某个值在 Session 中是否存在，即使是 null 的话也无所谓，则可以使用 exists 方法。如果值存在的话 exists 返回 true：

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

要确定会话中是否不存在某个项，您可以使用 missing 方法。 missing 方法返回 true 如果该项不存在：

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

存储数据

要在 Session 中存储数据，通常可以通过 put 方法或 session 辅助函数：

//通过调用请求实例的 put 方法
$request->session()->put('key', 'value');

// 通过全局辅助函数 session
session(['key' => 'value']);

推送数据到数组 Session

push 方法可用于推送数据到值为数组的 Session，例如，如果 user.teams 键包含团队名数组，可以像这样推送新值到该数组：

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

获取&删除数据

pull 方法将会通过一条语句从 Session 获取并删除数据：

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

增加&减少 Session 值

如果您的会话数据包含要增加或减少的整数，则可以使用 increment 和 decrement 方法：

$request->session()->increment('count');
 
$request->session()->increment('count', $incrementBy = 2);
 
$request->session()->decrement('count');
 
$request->session()->decrement('count', $decrementBy = 2);

闪存数据

有时候你可能想要在 Session 中存储只在下个请求中有效的数据，这可以通过 flash 方法来实现。使用该方法存储的 Session 数据只在随后的 HTTP 请求中有效，然后将会被删除：

$request->session()->flash('status', '登录 Laravel 学院成功!');

如果你需要在更多请求中保持该闪存数据，可以使用 reflash 方法，该方法将所有一次性数据保留到下一个请求，如果你只是想要保存特定闪存数据，可以使用 keep 方法：

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

要将仅保留在当前请求中，您可以使用 now 方法：

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

删除数据

重新生成会话 ID 通常是为了防止恶意用户利用会话固定攻击攻击您的应用程序。

如果您使用 Laravel 应用程序入门套件或 Laravel Fortify，则 Laravel 会在身份验证期间自动重新生成会话ID。但是，如果您需要手动重新生成会话ID，则可以使用 regenerate 方法：

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

如果您需要在单个语句中重新生成会话 ID 并删除会话中的所有数据，则可以使用 invalidate 方法：

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

Session 阻塞

注：要使用 Session 阻塞功能，Laravel 应用必须使用支持原子锁的缓存驱动。目前，支持原子锁的缓存驱动包括 memcached、dynamodb、redis 以及 database。此外，不能使用 cookie Session 驱动。

默认情况下，Laravel 允许请求并发使用同一个 Session 对象，举个例子，如果你使用 JavaScript HTTP 库发送两个请求到应用后端，它们会同时执行。对于大多数应用而言，这没有什么问题，不过，在一小部分应用中可能会出现 Session 数据丢失的情况，这是因为发送并发请求到不同的后端接口，可能会同时写入数据到同一个 Session 对象。

为了解决这个问题，Laravel 提供了允许开发者限制给定 Session 并发请求的功能。要使用这个功能，在路由定义之后链接 block 方法调用即可。在下面这个示例中，针对 /profile 或者 /order 接口的输入请求会获取一个 Session 锁，持有这个锁的请求会共享同一个 Session ID，这样一来，一个请求会等待另一个请求执行完毕后才会执行，这样一来，就可以避免上述 Session 写入数据覆盖的问题出现：

Route::post('/profile', function () {
    //
})->block($lockSeconds = 10, $waitSeconds = 10)

Route::post('/order', function () {
    //
})->block($lockSeconds = 10, $waitSeconds = 10)

block 方法接收两个可选参数，第一个参数是 Session 锁从持有到释放的最大时长（单位：秒，可以看作是锁的有效期），当然，如果请求在锁的有效期之前执行完毕，则锁会提前释放。

第二个参数是尝试获取 Session 锁时请求需要等待的最大时长（单位：秒），如果在给定时间内请求无法获取 Session 锁，则会抛出 Illuminate\Contracts\Cache\LockTimeoutException 异常。

如果没有传递上面两个参数，则 Session 锁的默认有效期是 10 秒，获取锁需要等待的默认最大时长也是 10 秒：

Route::post('/profile', function () {
    //
})->block()

添加自定义 Session 驱动

实现驱动

自定义 Session 驱动需要实现 SessionHandlerInterface 接口，该接口包含少许我们需要实现的方法，比如一个基于 MongoDB 的 Session 驱动实现如下：

<?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) {}
}

注：Laravel 默认并没有附带一个用于包含扩展的目录，你可以将扩展放置在任何地方，这里我们创建一个 Extensions 目录用于存放 MongoSessionHandler。

由于这些方法并不是很容易理解，所以我们接下来快速过一遍每一个方法：

  • open 方法用于基于文件的 Session 存储系统，由于 Laravel 已经有了一个 file Session 驱动，所以在该方法中不需要放置任何代码，可以将其置为空方法。
  • close 方法和 open 方法一样，也可以被忽略，对大多数驱动而言都用不到该方法。
  • read 方法应该返回与给定 $sessionId 相匹配的 Session 数据的字符串版本，从驱动中获取或存储 Session 数据不需要做任何序列化或其它编码，因为 Laravel 已经为我们做了序列化。
  • write 方法应该将给定 $data 写到持久化存储系统相应的 $sessionId, 例如 MongoDB, Dynamo 等等。再次重申，不要做任何序列化操作，Laravel 已经为我们处理好了。
  • destroy 方法从持久化存储中移除 $sessionId 对应的数据。
  • gc 方法销毁大于给定 $lifetime 的所有 Session 数据，对本身拥有过期机制的系统如 Memcached 和 Redis 而言，该方法可以留空。

注册驱动

Session 驱动被实现后，需要将其注册到框架，要添加额外驱动到 Laravel Session 后端，可以使用 Session 门面上的 extend 方法。我们在某个服务提供者 如 AppServiceProvider 的 boot 方法中调用该方法（也可以自己重新创建一个新的服务提供者）：

<?php
 
namespace App\Providers;
 
use App\Extensions\MongoSessionHandler;
use Illuminate\Contracts\Foundation\Application;
use Illuminate\Support\Facades\Session;
use Illuminate\Support\ServiceProvider;
 
class SessionServiceProvider extends ServiceProvider
{
    /**
     * Register any application services.
     */
    public function register(): void
    {
        // ...
    }
 
    /**
     * Bootstrap any application services.
     */
    public function boot(): void
    {
        Session::extend('mongo', function (Application $app) {
            // Return an implementation of SessionHandlerInterface...
            return new MongoSessionHandler;
        });
    }
}

Session 驱动被注册之后，就可以在配置文件 config/session.php 中使用 mongo 驱动了。去试试吧。

Laravel
文档
10.x
Session
会话
增删改查
闪存
阻塞
自定义
Cookie
点赞 取消点赞 收藏 取消收藏

<< 上一篇: URL 生成

>> 下一篇: 表单验证

1 条评论
#1    linetw5207   linetw5207 评论于 9个月前

line：60256可 愛 高 中 女 孩 第 一 次 約 會TG：av8526

登录后即可添加评论