要定义一个php中间件，需创建实现middlewareinterface的类并实现process方法，该方法接收请求和处理器参数，可对请求进行处理或拦截；1. 在laravel中通过kernel.php注册全局或路由中间件，并在路由中用middleware()应用；2. 在symfony中通过服务配置监听kernel.request等事件实现中间件；3. 在slim中使用$app->add()注册中间件；中间件用于在请求前后执行逻辑，典型场景包括身份验证、日志记录、请求响应修改、缓存、csrf保护和速率限制；中间件执行顺序由注册顺序决定，应明确依赖、避免副作用、使用命名空间和单元测试来防止冲突；编写可测试中间件应遵循依赖注入、接口隔离和单一职责原则，使用phpunit模拟请求和处理器对象进行测试；在中间件中通过方法访问请求信息，并使用withattribute或withheader等方法创建新对象以安全修改请求和响应。
PHP框架使用中间件，就像高速公路上的收费站，每个请求都要经过，你可以检查车辆（请求），修改车辆（请求），或者直接拒绝车辆通过（阻止请求）。它提供了一种优雅的方式来在请求到达你的控制器之前或之后，对请求进行预处理或后处理。
使用中间件，其实就是定义一个类，实现特定的接口，然后在框架的配置中注册它。
中间件本质上就是一个可执行的管道，请求像水一样流过，中间件对它进行过滤、处理，最终到达目的地。
立即学习“PHP免费学习笔记（深入）”；
定义中间件，你需要创建一个类，这个类通常会实现一个接口（例如，
Psr\Http\Server\MiddlewareInterface
handle
namespace App\Middleware;
use Psr\Http\Message\ServerRequestInterface;
use Psr\Http\Server\RequestHandlerInterface;
use Psr\Http\Server\MiddlewareInterface;
use Slim\Psr7\Response; // 假设你使用Slim框架
class AuthMiddleware implements MiddlewareInterface
{
public function process(ServerRequestInterface $request, RequestHandlerInterface $handler): Response
{
// 在这里进行身份验证逻辑
$token = $request->getHeaderLine('Authorization');
if ($token !== 'valid_token') {
$response = new Response();
$response->getBody()->write('Unauthorized');
return $response->withStatus(401);
}
// 调用下一个中间件或路由处理程序
$response = $handler->handle($request);
return $response;
}
}这段代码展示了一个简单的身份验证中间件。它从请求头中获取
Authorization
不同的框架有不同的注册和应用中间件的方式。
Laravel: 在 Laravel 中，你可以在
app/Http/Kernel.php
middleware()
// app/Http/Kernel.php
protected $middleware = [
\App\Http\Middleware\TrustProxies::class,
\App\Http\Middleware\PreventRequestsDuringMaintenance::class,
\Illuminate\Foundation\Http\Middleware\ValidatePostSize::class,
\App\Http\Middleware\TrimStrings::class,
\Illuminate\Foundation\Http\Middleware\ConvertEmptyStringsToNull::class,
];
protected $routeMiddleware = [
'auth' => \App\Http\Middleware\Authenticate::class,
'auth.basic' => \Illuminate\Auth\Middleware\AuthenticateWithBasicAuth::class,
'cache.headers' => \Illuminate\Http\Middleware\SetCacheHeaders::class,
'can' => \Illuminate\Auth\Middleware\Authorize::class,
'guest' => \App\Http\Middleware\RedirectIfAuthenticated::class,
'signed' => \Illuminate\Routing\Middleware\ValidateSignature::class,
'throttle' => \Illuminate\Routing\Middleware\ThrottleRequests::class,
'verified' => \Illuminate\Auth\Middleware\EnsureEmailIsVerified::class,
];
// 在路由中使用
Route::get('/profile', function () {
// 只有经过身份验证的用户才能访问...
})->middleware('auth');Symfony: 在 Symfony 中，你可以创建服务并使用标签
kernel.event_listener
kernel.request
kernel.response
# config/services.yaml
services:
App\EventListener\RequestListener:
tags:
- { name: kernel.event_listener, event: kernel.request, method: onKernelRequest }Slim: 在 Slim 中，你可以使用
$app->add()
// index.php
use App\Middleware\AuthMiddleware;
$app = new \Slim\App();
$app->add(new AuthMiddleware());
$app->get('/hello/{name}', function ($request, $response, $args) {
$name = $args['name'];
$response->getBody()->write("Hello, $name");
return $response;
});
$app->run();中间件就像请求处理流程中的拦截器，允许你在请求到达控制器之前或之后执行代码。典型应用场景包括：
中间件的执行顺序通常取决于它们注册的顺序。一般来说，先注册的中间件先执行。为了避免冲突，你需要仔细设计中间件的逻辑，确保它们不会互相干扰。
编写可测试的中间件，你需要遵循一些最佳实践：
你可以使用 PHPUnit 或其他测试框架进行单元测试。你需要模拟请求对象和下一个中间件的闭包，然后断言中间件的行为是否符合预期。
// tests/Middleware/AuthMiddlewareTest.php
use PHPUnit\Framework\TestCase;
use App\Middleware\AuthMiddleware;
use Psr\Http\Message\ServerRequestInterface;
use Psr\Http\Server\RequestHandlerInterface;
use Slim\Psr7\Response;
class AuthMiddlewareTest extends TestCase
{
public function testUnauthorized()
{
$request = $this->createMock(ServerRequestInterface::class);
$request->method('getHeaderLine')->willReturn(''); // 没有token
$handler = $this->createMock(RequestHandlerInterface::class);
$middleware = new AuthMiddleware();
$response = $middleware->process($request, $handler);
$this->assertEquals(401, $response->getStatusCode());
$this->assertEquals('Unauthorized', (string) $response->getBody());
}
public function testAuthorized()
{
$request = $this->createMock(ServerRequestInterface::class);
$request->method('getHeaderLine')->willReturn('valid_token');
$handler = $this->createMock(RequestHandlerInterface::class);
$handler->method('handle')->willReturn(new Response()); // 模拟下一个中间件或路由处理程序
$middleware = new AuthMiddleware();
$response = $middleware->process($request, $handler);
$this->assertEquals(200, $response->getStatusCode()); // 假设下一个处理程序返回 200
}
}这段代码展示了如何测试
AuthMiddleware
中间件接收请求对象作为参数，你可以使用请求对象的方法来访问请求头、请求体、查询参数等。
public function process(ServerRequestInterface $request, RequestHandlerInterface $handler): Response
{
$method = $request->getMethod(); // 获取请求方法
$uri = $request->getUri(); // 获取 URI
$queryParams = $request->getQueryParams(); // 获取查询参数
$body = $request->getBody(); // 获取请求体
// 修改请求
$request = $request->withAttribute('user_id', 123); // 添加属性
// 调用下一个中间件或路由处理程序
$response = $handler->handle($request);
// 修改响应
$response = $response->withHeader('X-Custom-Header', 'value');
return $response;
}你可以使用
with*()
以上就是PHP框架如何使用中间件处理请求 PHP框架中间件应用的基础教程的详细内容，更多请关注php中文网其它相关文章！
PHP怎么学习？PHP怎么入门？PHP在哪学？PHP怎么学才快？不用担心，这里为大家提供了PHP速学教程(入门到精通)，有需要的小伙伴保存下载就能学习啦！
Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号
941
收藏
