第 5 章 将策略链与 APIcast 原生部署集成

一些 第 4.1 节 “APIcast 标准策略” 支持 Liquid 模板，它允许使用纯文本值，还包括在请求上下文中存在的变量。

要使用上下文变量，将其名称打包在 {{ 和 }} 中，例如： {{ uri }}。如果变量是对象，您也可以访问其属性，例如： {{ somevar.attr }}。

以下是所有策略中的标准变量：

这些变量可在请求 的上下文中 找到。策略可以向上下文添加额外变量。这些变量可由策略链中相同的其他策略使用，只要使用它们的阶段在添加变量的阶段之后执行它们。如果变量在添加变量的策略后显示的策略中使用了同一阶段，则也可以是同一阶段。

以下是标准 3scale APIcast 策略添加到上下文中的变量示例：

有关上下文中可用对象和值的完整列表，请查看 第 4.1.9 节 “liquid Context Debug 策略”。

变量配合 Liquid 模板使用。示例： {{ remote_addr }}、{{ headers['Some-Header'] }}、{{ jwt.aud }}.支持值变量的策略具有一个特殊参数，通常带有 _type 后缀（例如： value_type、name_type 等等），它接受两个值："plain"表示纯文本，"liquid"用于 liquid 模板。

APIcast 还支持 Liquid 过滤器，可应用于变量的值。过滤器将 NGINX 功能应用到 Liquid 变量的值。

过滤器在变量输出标签 {{ }} 中放置，紧随变量的名称或通过竖线字符 | 和过滤器的名称来排列的字面值。示例：{ { 'username:password' | encode_base64 }}, {{ uri | escape_uri }}.

有些过滤器不需要参数，因此您可以使用空字符串而不是 变量。示例： {{ '' | utctime }} 将以 UTC 时区返回当前时间。

过滤器可以按如下所示链接：{{ variable | function1 | function2 }}。示例： {{ '' | utctime |scap_uri }}.

以下是可用功能列表：