引言

在中间件（Middleware）中，我们可以执行一些全局性的任务，如日志记录、请求验证、认证和授权等。ThinkPHP 框架提供了便捷的方式来创建和使用中间件。

创建中间件

首先，我们需要创建一个中间件文件。在 ThinkPHP 项目中，中间件通常存放在 `app/middleware` 目录下。

// 文件路径: app/middleware/CheckAuth.php
namespace appmiddleware;

class CheckAuth
{
    public function handle($request, Closure $next)
    {
        // 假设我们有一个简单的认证逻辑
        if (!$request->header('auth-token')) {
            return json(['error' => '认证失败'], 401);
        }

        return $next($request);
    }
}
        

注册中间件

创建好中间件之后，我们需要在应用中注册它。这通常是通过 `app/middleware.php` 文件来实现的。

// 文件路径: app/middleware.php
return [
    appmiddlewareCheckAuth::class,
];
        

上面的代码会全局地应用 `CheckAuth` 中间件。如果需要对某些路由应用中间件，可以在路由定义中指定：

use thinkfacadeRoute;

Route::group(function () {
    Route::get('protected-route', 'ProtectedController@index');
})->middleware(appmiddlewareCheckAuth::class);
        

处理中间件中的错误

在中间件中处理错误是很常见的。如果中间件中的逻辑验证失败，我们可以返回一个响应。

// 示例: 错误处理
public function handle($request, Closure $next)
{
    if (!$request->header('auth-token')) {
        // 返回 JSON 响应
        return response()->json(['error' => '认证失败'], 401);
    }

    return $next($request);
}
        

案例讲解：实现一个简单的日志中间件

下面是一个中间件的例子，它会在每个请求到达时记录日志：

// 文件路径: app/middleware/LogRequests.php
namespace appmiddleware;

use thinkLog;

class LogRequests
{
    public function handle($request, Closure $next)
    {
        // 记录请求方法、URL 和 IP 地址
        Log::write('[' . date('Y-m-d H:i:s') . '] ' . $request->method() . ' ' . $request->url() . ' from ' . $request->ip());

        return $next($request);
    }
}
        

然后，注册这个中间件：

// 文件路径: app/middleware.php
return [
    appmiddlewareLogRequests::class,
    appmiddlewareCheckAuth::class,
];
        

总结

通过中间件，我们可以非常方便地实现一些全局性的操作。ThinkPHP 框架提供了简洁的 API 来创建和使用中间件，让我们能够灵活地控制 HTTP 请求的生命周期。

参考资料

• ThinkPHP 官方文档