Session 会话管理

HTTP 是一种无状态协议,即服务器不保留与客户交易时的任何状态,所以当我们在开发 HTTP Server 应用时,我们通常会通过 Session 来实现多个请求之间用户数据的共享。您可通过 hyperf/session 来实现 Session 的功能。Session 组件当前仅适配了两种储存驱动,分别为 文件Redis,默认为 文件 驱动,在生产环境下,我们强烈建议您使用 Redis 来作为储存驱动,这样性能更好也更符合集群架构下的使用。

安装

  1. composer require hyperf/session

配置

Session 组件的配置储存于 config/autoload/session.php 文件中,如文件不存在,您可通过 php bin/hyperf.php vendor:publish hyperf/session 命令来将 Session 组件的配置文件发布到 Skeleton 去。

配置 Session 中间件

在使用 Session 之前,您需要将 Hyperf\Session\Middleware\SessionMiddleware 中间件配置为 HTTP Server 的全局中间件,这样组件才能介入到请求流程进行对应的处理,config/autoload/middleware.php 配置文件示例如下:

  1. <?php
  2. return [
  3. // 这里的 http 对应默认的 server name,如您需要在其它 server 上使用 Session,需要对应的配置全局中间件
  4. 'http' => [
  5. \Hyperf\Session\Middleware\SessionMiddleware::class,
  6. ],
  7. ];

配置储存驱动

通过更改配置文件中的 handler 配置修改不同的 Session 储存驱动,而对应 Handler 的具体配置项则由 options 内不同的配置项决定。

使用文件储存驱动

文件储存驱动是默认的储存驱动,但建议生产环境下使用 Redis 驱动

handler 的值为 Hyperf\Session\Handler\FileHandler 时则表明使用 文件 储存驱动,所有的 Session 数据文件都会被生成并储存在 options.path 配置值对应的文件夹中,默认配置的文件夹为根目录下的 runtime/session 文件夹内。

使用 Redis 驱动

在使用 Redis 储存驱动之前,您需要安装 hyperf/redis 组件。当 handler 的值为 Hyperf\Session\Handler\RedisHandler 时则表明使用 Redis 储存驱动。您可以通过配置 options.connection 配置值来调整驱动要使用的 Redis 连接,这里的连接与 hyperf/redis 组件的 config/autoload/redis.php 配置内的 key 命名匹配,

使用

获得 Session 对象

获得 Session 对象可通过注入 Hyperf\Contract\SessionInterface,即可调用接口定义的方法来实现使用:

  1. <?php
  2. namespace App\Controller;
  3. class IndexController
  4. {
  5. /**
  6. * @Inject()
  7. * @var \Hyperf\Contract\SessionInterface
  8. */
  9. private $session;
  10. public function index()
  11. {
  12. // 直接通过 $this->session 来使用
  13. }
  14. }

储存数据

当您希望储存数据到 Session 中去,您可通过调用 set(string $name, $value): void 方法来实现:

  1. <?php
  2. $this->session->set('foo', 'bar');

获取数据

当您希望从 Session 中获取数据,您可通过调用 get(string $name, $default = null) 方法来实现:

<?php

$this->session->get('foo', $default = null);

获取所有数据

您可通过调用 all(): array 方法一次性从 Session 中获得所有的已储存数据:

<?php

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

判断 Session 中是否存在某个值

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

<?php

if ($this->session->has('foo')) {
    //
}

获取并删除一条数据

通过调用 remove(string $name) 方法可以只使用一个方法就从 Session 中获取并删除一条数据:

<?php

$data = $this->session->remove('foo');

删除一条或多条数据

通过调用 forget(string|array $name): void 方法可以只使用一个方法就从 Session 中删除一条或多条数据,当传递字符串时,表示仅删除一条数据,当传递一个 key 字符串数组时,表示删除多条数据:

<?php

$this->session->forget('foo');
$this->session->forget(['foo', 'bar']);

清空当前 Session 数据

当您希望清空当前 Session 里的所有数据,您可通过调用 clear(): void 方法来实现:

<?php

$this->session->clear();

获取当前的 Session ID

当您希望获取当前带 Session ID 去自行处理一些逻辑时,您可通过调用 getId(): string 方法来获取当前的 Session ID:

<?php

$sessionId = $this->session->getId();