CDN边缘脚本EdgeScript内置变量_CDN(CDN)-阿里云帮助中心

本文为您介绍EdgeScript脚本中所有内置变量的含义和对应nginx原生变量。

说明

内置变量名前的特殊符号（$）是为了强调内置变量属性，删除后不影响使用。
内置变量不允许担当左值，即内置变量不允许被赋值。
每条EdgeScript规则中最多支持200个变量，如果变量超过200个，您可以参考函数拆分示例请将整体逻辑拆分为多个自定义函数，并且保证每个自定义函数中变量不超过200个。

EdgeScript内置变量。

内置变量名	含义	对应nginx原生变量
$arg_{name}	`Query String`中的参数`name`值。`Query String`表示HTTP请求中的请求参数。	$arg_ 说明 `{name}`中出现的连接号（-），需要使用`req_uri_arg`函数来取值（不使用变量`$arg_`），例如：用户请求`http://example.com/1.jpg?example-demo=123`，取值函数式为`req_uri_arg('example-demo')`。
$http_{name}	请求头中的name值。	$http_ 说明 `{name}`中出现的连接号（-），需要使用下划线（_）替代，例如：`X-USER-ID`对应为`$http_x_user_id`。
$cookie_{name}	请求cookie头中的name值。	$cookie_ 说明 `{name}`中出现的连接号（-），需要使用`req_cookie`函数来取值（不使用变量`$cookie_`），例如：用户请求`cookie:example-demo=123`，取值函数式为`req_cookie('example-demo')`。
$scheme	协议类型。	$scheme
$server_protocol	协议版本。	$server_protocol
$host	原始host。	$host
$uri	原始URI。	无
$args	`$args`表示当前HTTP请求的全部请求参数，但不包含问号（`?`）。例如：`http://example.aliyundoc.com/1k.file?k1=v1&k2=v2`。 `$arg_k1`可以获得对应的`v1`值。 `$args`可以获得整个请求参数字符串，即`k1=v1&k2=v2`，不包括问号（`?`）。	$args
$request_method	请求方法。	$request_method
$request_uri	`uri+'?'+args`的内容。	$request_uri
$remote_addr	客户的IP地址（即x-forwarded-for请求头携带的第一个IP）。	$remote_addr

函数拆分示例

当您的规则中变量超过200个时，需要您将整体逻辑拆分为多个自定义函数，并且保证每个自定义函数中变量不超过200个。

#如果变量超限制，可以这样拆分
def judeg_arg() {
  #参数判断相关逻辑
  x
  x
}

def judeg_time() {
  #时间判断相关逻辑
  x
  x
}

def judeg_token() {
  #加密判断相关逻辑
  x
  x
}

judeg_arg()
judeg_time()
judeg_token()