soulbird commented on code in PR #7794: URL: https://github.com/apache/apisix/pull/7794#discussion_r955796770
##########
docs/zh/latest/plugins/response-rewrite.md:
##########
@@ -44,18 +44,22 @@ description: 本文介绍了关于 Apache APISIX `response-rewrite` 插件的基
## 属性
-| 名称 | 类型 | 必选项 | 默认值 | 有效值 | 描述
|
-|-----------------|---------|-----|--------|-----------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------|
-| status_code | integer | 否 | | [200, 598] |
修改上游返回状态码，默认保留原始响应代码。
|
-| body | string | 否 | | | 修改上游返回的 `body`
内容，如果设置了新内容，header 里面的 content-length 字段也会被去掉。
|
-| body_base64 | boolean | 否 | false | | 描述 `body` 字段是否需要
base64 解码之后再返回给客户端，用在某些图片和 Protobuffer 场景。
|
-| headers | object | 否 | | | 返回给客户端的
`headers`，这里可以设置多个。头信息如果存在将重写，不存在则添加。想要删除某个 header 的话，把对应的值设置为空字符串即可。这个值能够以
`$var` 的格式包含 NGINX 变量，比如 `$remote_addr $balancer_ip`。 |
-| vars | array[] | 否 | | | `vars`
是一个表达式列表，只有满足条件的请求和响应才会修改 body 和 header 信息，来自
[lua-resty-expr](https://github.com/api7/lua-resty-expr#operator-list)。如果
`vars` 字段为空，那么所有的重写动作都会被无条件的执行。 |
-| filters | array[] | 否 | | |
一组过滤器，采用指定字符串表达式修改响应体。
|
-| filters.regex | string | 是 | | | 用于匹配响应体正则表达式。
|
-| filters.scope | string | 否 | "once" | "once","global" | 替换范围，"once" 表达式
`filters.regex` 仅替换首次匹配上响应体的内容，"global" 则进行全局替换。
|
-| filters.replace | string | 是 | | | 替换后的内容。
|
-| filters.options | string | 否 | "jo" | | 正则匹配有效参数，可选项见
[ngx.re.match](https://github.com/openresty/lua-nginx-module#ngxrematch)。
|
+| 名称 | 类型 | 必选项 | 默认值 | 有效值 | 描述
|
+|-----------------|---------|--------|--------|-----------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| status_code | integer | 否 | | [200, 598] |
修改上游返回状态码，默认保留原始响应代码。
|
+| body | string | 否 | | | 修改上游返回的
`body` 内容，如果设置了新内容，header 里面的 content-length 字段也会被去掉。
|
+| body_base64 | boolean | 否 | false | | 描述 `body`
字段是否需要 base64 解码之后再返回给客户端，用在某些图片和 Protobuffer 场景。
|
+| headers | object | 否 | | |
|
+| headers.add | array | 否 | | | 添加新的响应头。格式为
`["name: value", ...]`。这个值能够以 `$var` 的格式包含 NGINX 变量，比如 `$remote_addr
$balancer_ip`。
|
+| headers.set | object | 否 | | | 改写响应头。格式为
`{"name": "value", ...}`。这个值能够以 `$var` 的格式包含 NGINX 变量，比如 `$remote_addr
$balancer_ip`。
|
+| headers.remove | array | 否 | | | 移除响应头。格式为
`["name", ...]`。
|
+| headers | object | 否 | | | 返回给客户端的
`headers`，这里可以设置多个。头信息如果存在将重写，不存在则添加。想要删除某个 header 的话，把对应的值设置为空字符串即可。
|
Review Comment:
repeated?
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: [email protected]
For queries about this service, please contact Infrastructure at:
[email protected]
