Slim4中间件使用教程详解

Slim 4 的中间件机制严格遵循 PSR-15 标准，彻底摒弃了 Slim 3 的函数式写法，要求所有中间件必须是实现 `MiddlewareInterface` 的类，`process()` 方法必须显式返回 `ResponseInterface` 实例——任何偏差（如使用闭包、返回数组/字符串、遗漏 `return`、复用不可变响应对象）都会立即触发 `TypeError`；其执行逻辑依赖精准的注册顺序构成“洋葱模型”，全局、分组或单路由级的 `add()` 调用直接决定作用域与包裹层级，尤其关键的是 CORS 中间件必须在 `addRoutingMiddleware()` 之前注册才能正确处理 OPTIONS 预检请求；这是一套零容忍、强契约、高可控的中间件体系，理解并遵守这些硬性约束，才是写出健壮、可维护 Slim 4 应用的前提。

Slim 4 中间件不是“加了就能用”，必须是类、实现 MiddlewareInterface、返回 ResponseInterface，否则直接 TypeError 报错。

中间件必须是类，不能是闭包或函数

Slim 4 彻底弃用 Slim 3 风格的 function ($request, $response, $next) 写法。任何非类形式的中间件（包括匿名函数、静态方法、全局函数）传给 $app->add() 都会触发 TypeError: Argument 1 passed to Slim\App::add() must be an instance of Psr\Http\Server\MiddlewareInterface。

• 必须用 class MyMiddleware implements Psr\Http\Server\MiddlewareInterface
• process() 方法签名严格为：public function process(ServerRequestInterface $request, RequestHandlerInterface $handler): ResponseInterface
• 别在构造函数里做 heavy 初始化——容器可能还没 ready，依赖注入应走 ContainerInterface 而非 $app

process() 里必须调用 $handler->handle($request)，不能 return 数组或字符串

常见错误是把中间件当控制器写：return ['error' => 'forbidden'] 或 echo '403'，结果抛出 TypeError: Return value of MyMiddleware::process() must be an instance of Psr\Http\Message\ResponseInterface。

• 所有响应都得是 ResponseInterface 实例，例如用 $responseFactory->createResponse(403) 创建
• 要写 JSON？先 $response->withHeader('Content-Type', 'application/json')，再 $response->getBody()->write(json_encode([...]))
• 别复用参数里的 $response——它只是占位符；PSR-7 不可变，必须用工厂新建
• 想中断流程？直接返回响应对象即可，$handler->handle($request) 就不执行了

注册位置决定作用域和执行顺序

中间件不是“全局生效”或“自动扫描”，add() 的调用位置和顺序直接决定洋葱模型的包裹层级。

• 全局：$app->add(new AuthMiddleware()) → 包裹所有路由，包括 404
• 路由组：$app->group('/api', ...)->add(new JwtMiddleware()) → 只对 /api/** 生效
• 单个路由：$app->get('/admin', ...)->add(new AdminOnlyMiddleware()) → 最内层，最后进、最先出
• 多个 add() 按代码顺序从上到下执行，不是倒序

CORS 中间件必须在 $app->addRoutingMiddleware() 之前注册

如果 CorsMiddleware 没生效，大概率是因为它被加在了路由解析之后，导致 OPTIONS 预检请求根本没走到它那里。

• 正确顺序：$app->add(new Tuupola\Middleware\CorsMiddleware([...])) → $app->addRoutingMiddleware()
• 别用 Slim\Middleware\CorsMiddleware——Slim 官方没这个类；必须装 tuupola/cors-middleware
• 生产环境禁用 "origin" => ["*"]；若设 "credentials" => true，"origin" 必须是单个具体域名
• 测试预检：用 curl -I -X OPTIONS https://yoursite.com/api/user 看响应头有没有 Access-Control-Allow-Origin

最易忽略的一点：Slim 4 的中间件链不接受任何“隐式返回”。每个 process() 都必须显式返回 ResponseInterface，哪怕只是透传；少一个 return，或返回了 null，整个管道就崩在那儿了。

以上就是《Slim4中间件使用教程详解》的详细内容，更多关于的资料请关注golang学习网公众号！