在控制器中使用中间件来访问会话 - PHP

在一个 Web 应用中，会话（Session）对象是一个非常重要的概念。它以一个键值对形式，存储了在某些请求间需要保存的数据。在 PHP 中，我们可以通过 $_SESSION 超全局变量来访问会话数据。

不过，如果你在控制器中直接访问 $_SESSION，你需要在每个方法中手动打开和关闭会话。这会导致冗长的代码、不好维护和通用性差。所以，我们需要一种更好的方法。

在 PHP 中，我们可以使用中间件（Middleware）来简化访问会话。中间件是一种处理请求和响应的机制，每个中间件都可以对请求和响应进行一些处理。在本文中，我们将学习如何使用中间件来访问会话。

步骤一：创建会话中间件

首先，我们需要定义一个会话中间件类。这个类需要实现 Psr\Http\Server\MiddlewareInterface 接口，并在 process() 方法中打开会话：

<?php

namespace App\Http\Middleware;

use Psr\Http\Message\ResponseInterface;
use Psr\Http\Message\ServerRequestInterface;
use Psr\Http\Server\MiddlewareInterface;
use Psr\Http\Server\RequestHandlerInterface;

class SessionMiddleware implements MiddlewareInterface
{
    public function process(ServerRequestInterface $request, RequestHandlerInterface $handler): ResponseInterface
    {
        session_start();

        $response = $handler->handle($request);

        session_write_close();

        return $response;
    }
}

这里我们使用了 session_start() 函数来打开会话，使用 session_write_close() 函数来关闭会话。在 process() 方法中，我们还需要调用 $handler->handle($request) 来执行下一个中间件或控制器。

步骤二：将中间件注册到应用程序

接下来，我们需要将刚刚创建的中间件注册到应用程序。在 Laravel 中，我们可以通过 app/Http/Kernel.php 文件进行注册。在这个文件中，我们可以看到 $middleware 属性，它包含了所有全局中间件的列表：

protected $middleware = [
    \App\Http\Middleware\TrustProxies::class,
    \Fruitcake\Cors\HandleCors::class,
    \App\Http\Middleware\PreventRequestsDuringMaintenance::class,
    \Illuminate\Foundation\Http\Middleware\ValidatePostSize::class,
    \App\Http\Middleware\TrimStrings::class,
    \Illuminate\Foundation\Http\Middleware\ConvertEmptyStringsToNull::class,
    \App\Http\Middleware\SessionMiddleware::class,     // 将会话中间件添加到列表中
];

在这里，我们可以将刚刚创建的会话中间件添加到列表中。

请注意，这里将中间件添加到 $middleware 属性是将它注册为全局中间件。如果你只想将中间件应用于某些路由，可以将它添加到 $middlewareGroups 属性或 $routeMiddleware 属性中。这些属性将在后面的步骤中讲到。

步骤三：使用中间件来访问会话

现在我们已经创建并注册了会话中间件，我们可以在控制器中使用它来访问会话数据。这个过程和直接访问 $_SESSION 是几乎相同的，只是我们不再需要手动打开和关闭会话了。

<?php

namespace App\Http\Controllers;

use Illuminate\Http\Request;

class HomeController extends Controller
{
    public function index(Request $request)
    {
        $name = $request->session()->get('name');

        return view('home', ['name' => $name]);
    }

    public function store(Request $request)
    {
        $name = $request->input('name');

        $request->session()->put('name', $name);

        return redirect()->route('home');
    }
}

使用 $request->session()->get('name') 来获取会话数据，使用 $request->session()->put('name', $name) 来存储会话数据。这个过程和原生 PHP 中访问 $_SESSION 是类似的，只是我们不再需要手动打开和关闭会话了。

结论

在本文中，我们学习了如何使用中间件来访问会话数据。创建和注册中间件需要一些额外的代码，但是能大大降低代码的复杂度和提高代码的可读性和可维护性。希望你能从本文中受益，进一步提高你的 PHP 编程技能。