在 laravel 中,中间件是处理请求和响应的强有力工具。你可以在请求到达控制器之前修改请求内容,也可以在响应返回给客户端之前修改响应内容。下面介绍如何在中间件中实现这两项操作。
修改请求内容
有时你需要在请求进入控制器前动态修改某些参数,比如添加、删除或更改请求字段。
方法:通过继承 IlluminatehttpRequest 实例并调用其 merge、replace 或直接设置值的方式修改请求数据。
示例:添加一个额外字段到请求中
public function handle($request, Closure $next) { // 修改请求参数 $request->merge([ 'user_type' => 'api_user' ]); // 也可以替换全部输入 // $request->replace(['name' => 'John']); return $next($request); }
这样后续的控制器就能通过 $request->user_type 获取该字段。
修改响应内容
如果你想在响应返回前修改其内容(如添加头信息、修改响应体等),可以在中间件中对响应对象进行操作。
注意:必须在 $next($request) 执行后才能获取响应实例。
示例:修改响应头并包装返回数据
public function handle($request, Closure $next) { $response = $next($request); // 添加自定义头 $response->headers->set('X-app-Version', '1.0'); // 如果是 json 响应,可以修改响应体 if ($response->isJson()) { $originalData = json_decode($response->getContent(), true); $modifiedData = [ 'data' => $originalData, 'status' => 'success', 'code' => 200 ]; // 创建新的响应 $response = response()->json($modifiedData, $response->status()) ->withHeaders($response->headers->all()); } return $response; }
注意事项与技巧
- 修改请求时,merge 是追加或覆盖已有字段,不会影响其他原始数据。
- 修改响应体时要小心,尤其是流式响应或文件下载,避免破坏原始结构。
- 中间件执行顺序很重要,确保你的中间件在正确的位置(如放在 api 组中)。
- 不要在中间件中做耗时操作,以免影响整体性能。
基本上就这些。Laravel 的中间件机制足够灵活,只要掌握请求和响应对象的操作方式,就能自由定制处理逻辑。