Laravel 的 HTTP 会话机制
简介
由于 HTTP 驱动的应用程序是无状态的,Session 提供了一种在多个请求之间存储有关用户的信息的方法。Laravel 通过同一个可读性强的 API 处理各种自带的 Session 后台驱动程序。支持诸如比较热门的 Memcached、Redis 和开箱即用的数据库等常见的后台驱动程序。
配置
Session 的配置文件存储在 config/session.php
。请务必查看此文件中对于你可用的选项。默认情况下,Laravel 配置了适用于大多数应用程序的 file
Session 驱动。在生产环境下,你可以考虑使用 memcached
或 redis
驱动来实现更出色的 Session 性能。
Session driver
的配置选项定义了每个请求存储 Session 数据的位置。Laravel 自带了几个不错且可开箱即用的驱动:
-
file
- 将 Session 保存在storage/framework/sessions
中。 -
cookie
- Session 保存在安全加密的 Cookie 中。 -
database
- Session 保存在关系型数据库中。 -
memcached
/redis
- Sessions 保存在其中一个快速且基于缓存的存储系统中。 -
array
- Sessions 保存在 PHP 数组中,不会被持久化。
数组驱动一般用于 测试,并防止存储在 Session 中的数据被持久化。
驱动之前
数据库
使用 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');
});
使用 Artisan 命令 session:table
命令为此生成迁移:
php artisan session:table
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 服务容器 自动注入 :
<?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 获取值时,你还可以传递一个默认值作为 get
方法的第二个参数。如果 Session 中不存在指定的键,便会返回这个默认值。若传递一个闭包作为 get
方法的默认值,并且所请求的键并不存在时,get
方法将执行闭包并返回其结果:
$value = $request->session()->get('key', 'default');
$value = $request->session()->get('key', function () {
return 'default';
});
全局辅助函数 Session
你也可以使用全局的 PHP 函数 session
来获取和存储 Session 数据。 使用单个字符串类型的值作为参数调用辅助函数 session
时,它会返回字该符串对应的 Session 键的值。当使用一个键值对数组作为参数调用辅助函数 session
时,传入的键值将会存储在 Session 中:
Route::get('home', function () {
// 获取 Session 中的一条数据...
$value = session('key');
// 指定一个默认值...
$value = session('key', 'default');
// 在 Session 中存储一条数据...
session(['key' => 'value']);
});
通过 HTTP 请求实例操作 Session 与使用全局辅助函数 session
两者之间并没有实质上的区别。这两种方法都可以通过所有测试用例中可用的 assertSessionHas
方法进行 测试。
获取所有 Session 数据
如果你想要获取所有的 Session 数据,可以使用 all
方法:
$data = $request->session()->all();
判断 Session 中是否存在某个值
要确定 Session 中是否存在某个值,可以使用 has
方法。如果该值存在且不为 null
,那么 has
方法会返回 true
:
if ($request->session()->has('users')) {
//
}
要确定 Session 中是否存在某个值,即使其值为 null
,也可以使用 exists
方法。如果值存在,则 exists
方法返回 true
:
if ($request->session()->exists('users')) {
//
}
存储数据
要存储数据到 Session,你可以使用 put
方法,或者辅助函数 session
。
// 通过 HTTP 请求实例...
$request->session()->put('key', 'value');
// 通过全局辅助函数
session(['key' => 'value']);