PHP中间件使用与原理详解

时间：2026-04-17

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

PHP中间件怎么用_PHP_Web开发中间件原理应用

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

中间件的工作原理

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

基本流程如下：

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

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

在Laravel中使用中间件

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

1. 创建中间件

使用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);
}

2. 注册中间件

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

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

3. 绑定到路由

在路由定义中使用：

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访问行为。