PHP中间件使用与原理详解

中间件是在请求进入业务逻辑前后执行的代码层，用于处理身份验证、日志记录等通用任务。它形成请求与应用间的管道，按注册顺序依次执行，支持修改或终止请求，并在Laravel等框架中通过创建、注册和绑定到路由实现灵活控制，提升代码复用与系统清晰度。

PHP中间件是一种在请求进入实际业务逻辑之前或之后执行的代码层，它能对HTTP请求和响应进行预处理或后处理。中间件常用于身份验证、日志记录、跨域处理、输入过滤等通用任务，广泛应用于现代PHP框架如Laravel、Slim、Symfony等。

中间件的工作原理

中间件位于客户端请求与应用程序之间，形成一条“管道”。每个中间件负责特定功能，可以决定是否将请求传递给下一个环节。

基本流程如下：

• 用户发起HTTP请求
• 请求依次经过注册的中间件
• 每个中间件可修改请求、拒绝请求或添加逻辑
• 最终到达目标控制器或路由处理函数
• 响应沿中间件链反向返回

这种机制实现了关注点分离，使核心业务逻辑更简洁。

在Laravel中使用中间件

Laravel提供了清晰的中间件系统。创建和使用步骤如下：

使用Artisan命令生成中间件：

php artisan make:middleware CheckAge

生成的文件位于app/Http/Middleware/CheckAge.php，示例内容：

public function handle($request, Closure $next)
{
    if ($request->age < 18) {
        return redirect('home');
    }
    return $next($request);
}

在app/Http/Kernel.php中注册：

• 全局中间件：所有请求都会经过
• 路由中间件：通过别名绑定到特定路由

在路由定义中使用：

Route::get('/profile', function () {
    //
})->middleware('auth');

也可以传参：

->middleware('role:admin,editor')

自定义中间件实战示例

以实现API请求日志记录为例：

class LogRequest
{
    public function handle($request, Closure $next)
    {
        \Log::info('Request received: ' . $request->fullUrl(), [
            'method' => $request->method(),
            'ip' => $request->ip(),
            'user_id' => $request->user() ? $request->user()->id : null
        ]);

        $response = $next($request);

        \Log::info('Response sent', ['status' => $response->status()]);

        return $response;
    }
}

注册后应用到API路由组即可自动记录所有API访问行为。

中间件的执行顺序

中间件按注册顺序执行，但要注意层级：

• 全局中间件最先运行
• 然后是分组中间件（如web、api）
• 最后是路由上单独指定的中间件

合理安排顺序很重要，例如认证中间件应在日志记录之后，以便获取用户信息。

基本上就这些。掌握中间件的使用能让Web开发更高效、结构更清晰。关键是理解其“环绕式”执行模型和灵活的组合能力。不复杂但容易忽略细节，比如终止请求或正确传递参数。