response-rewrite

该插件可以应用在以下场景中：

  • 通过设置 Access-Control-Allow-* 字段实现 CORS（跨域资源共享）的功能。
  • 通过设置标头中的 status_code 和 Location 字段实现重定向。
tip

如果你仅需要重定向功能，建议使用 redirect 插件。

response-rewrite - 图2note

body 和 filters 属性只能配置其中一个。

你可以通过如下命令在指定路由上启用 response-rewrite 插件：

除了 set 操作，你也可以像这样增加或移除响应头：

  1. "headers": {
  2.     "add": [
  3.     ],
  4.     "remove": [
  5.         "X-TO-BE-REMOVED"
  6.     ]
  7. }

这些操作的执行顺序为 [“add”, “set”, “remove”]。

我们不再对直接在 headers 下面设置响应头的方式提供支持。 如果你的配置是把响应头设置到 headers 的下一层，你需要将这些配置移到 headers.set。

通过上述命令启用插件后，可以使用如下命令测试插件是否启用成功：

  1. HTTP/1.1 200 OK
  2. Date: Sat, 16 Nov 2019 09:15:12 GMT
  3. Transfer-Encoding: chunked
  4. Connection: keep-alive
  5. X-Server-id: 3
  6. X-Server-status: on
  8. {"code":"ok","message":"new json body"}
IMPORTANT

ngx.exit 将会中断当前请求的执行并将其状态码返回给 NGINX。

如果你在 access 阶段执行了 ngx.exit，该操作只是中断了请求处理阶段，响应阶段仍然会处理。如果你配置了 response-rewrite 插件，它会强制覆盖你的响应信息（如响应代码）。

Phaserewriteaccessheader_filterbody_filter
rewritengx.exit√√√
access×ngx.exit√√
header_filter√√ngx.exit√
body_filter√√×ngx.exit

使用 filters 正则匹配将返回 body 的 X-Amzn-Trace-Id 替换为 X-Amzn-Trace-Id-Replace。

  1. curl -X GET -i  http://127.0.0.1:9080/get

当你需要禁用 response-rewrite 插件时，可以通过以下命令删除相应的 JSON 配置，APISIX 将会自动重新加载相关配置，无需重启服务：

  1. curl http://127.0.0.1:9180/apisix/admin/routes/1  \
  2. -H 'X-API-KEY: edd1c9f034335f136f87ad84b625c8f1' -X PUT -d '
  3. {
  4.     "methods": ["GET"],
  5.     "uri": "/test/index.html",
  6.     "upstream": {
  7.         "type": "roundrobin",
  8.         "nodes": {
  9.             "127.0.0.1:80": 1
  10.         }
  11. }'