函数

格式：concat(String | Integer | Bytes | Array elements):String。

处理逻辑：函数的操作对象是一个采用逗号分隔的值列表，作用是将所有的参数值连接到一个字符串中。

示例： 

• concat("String1"," ","String",2)将会返回"String1 String2"。

• concat("/archive",http.request.uri.path)，在URI的路径前面插入一段新的路径"/archive"。

• concat("userid=123&",http.request.uri.query)，在URI的查询字符串前面插入一个新的键值对"userid=123"。

• concat("https://www.example.com",http.request.uri.path)，将新的主机名与原始请求中的路径拼接在一起，生成一个新的URL。

格式：ends_with(source String,substring String):Boolean。

处理逻辑：

• 当source String以substring String结尾时返回true。否则返回false。

• source String必须是字段，不能直接使用固定字符串。例如：不能直接写成ends_with("foo.html",".html")。

示例：如果http.request.uri.path是"/welcome.html"，则ends_with(http.request.uri.path,".html")返回true。

格式：lower(String):String

处理逻辑：将字段输出的字符串转换为小写，仅转换大写ASCII字符，所有其他字符不受影响。

示例：如果http.host是"WWW.example.com",则lower(http.host)=="www.example.com"返回true。

格式：regex_replace(source String,regular_expression String,replacement String):String。

处理逻辑：

• 将与正则表达式匹配的源字符串的一部分替换为替换字符串，并返回替换结果。

• 默认情况下，字符串的匹配区分大小写。

• 当源字符串中存在多个匹配时，只会替换第一个匹配值。

• 可以在替换字符串中的$符号前加上另一个$符号来进行转义。

• 替换字符串可以包含对正则表达式捕获组的引用（使用格式${<NUMBER>}来引用一个捕获组，其中<NUMBER>是捕获组的编号），例如：${1}和${2}，最多八个替换引用。

示例：

• 静态字符匹配替换：

  • 字符串匹配上：regex_replace("/animal/cat","/cat$","/dog")=="/animal/dog"。

  • 假如没有匹配上，源字符串不会有变化：

    • 字符串不同：regex_replace("/x","^/y$","/z")=="/x"。

    • 字符串区分大小写：regex_replace("/cat","^/CAT$","/dog")=="/cat"。

  • 存在多个匹配时，只对第一个进行替换：regex_replace("/a/a","/a","/b")=="/b/a"。

  • 对替换字符串中的$符号进行转义：regex_replace("/b","^/b$","/b$$")=="/b$"。

  • 替换字符串使用捕获组进行引用：regex_replace("/foo/a/path","^/foo/([^/]*)/(.*)$","/bar/${2}/${1}")=="/bar/path/a"。

• 动态字段匹配替换：

  • 源字符串使用了动态字段，用于提取客户端请求中的路径信息，将路径中的/cat/替换为/dog/：regex_replace(http.request.uri.path,"/cat/(.*)$","/dog/${1}")。

  • 复杂替换示例，将原始请求路径中的+符号替换为字符串%2B：regex_replace(http.request.uri.path, "^([^+]*)\\+([^+]*)\\+(.*)$", "${1}%2B${2}%2B${3}")。

格式：starts_with(source String,substrina String):Boolean

处理逻辑：

• 当source String以substring String开头时返回true。否则返回false。

• source String必须是字段，不能直接使用固定字符串。例如：不能直接写成starts_with("foo.html",".html")。

示例：如果http.request.uri.path是"/welcome.html",则starts_with(http.request.uri.path,".html")返回true。

格式：to_string(Integer | Boolean | IP address):String。

处理逻辑：返回Integer、Boolean或IP地址值的字符串表示形式。

示例：

• 假如ip.src.asnum的结果是15169，那么to_string(ip.src.asnum)将会返回"15169"。

• 假如ssl的结果是true，那么to_string(ssl)将会返回"true"。

• 假如ip.src的结果是192.168.0.1，那么to_string(ip.src)将会范围"192.168.0.1"。

格式：upper(String):String。

处理逻辑：将字段输出的字符串转换为大写，仅转换小写ASCII字符，所有其他字节不受影响。

示例：如果http.host是"www.example.com",则upper(http.host)返回"WWW.EXAMPLE.COM"。

格式：wildcard_replace(source Bytes,wildcard_pattern Bytes,replacement Bytes,flags Bytes optional):String

处理逻辑：

• 将零个或多个*通配符的源字符文字与source字符串匹配替换为替换字符串并返回结果。替换字符串可以包含对通配符捕获组的引用，例如：${1}和${2}，最多八个替换引用。

• 如果不匹配，函数将返回source字符串的原始内容。

• source参数必须是字段（不能是文字字符串）。此外，整个source值必须与wildcard_pattern参数匹配（它不能只匹配字段值的一部分）。

• 要在wildcard_pattern参数中输入文字*字符，必须使用\*转义它。此外，您还必须使用\\对\进行转义。此参数中一行**中的两个未转义的*字符被视为无效，无法使用。如果需要执行字符转义，建议对wildcard_pattern参数使用原始字符串语法。

• 如果要在replacement参数中输入文字$字符，必须使用$$转义它。

• 如果要执行区分大小写的通配符匹配，请将flags参数设置为s。

• 此函数使用延迟匹配，即它试图将每个*元字符与尽可能短的字符串进行匹配。

示例：

• 如果完整URI为https://apps.example.com/calendar/admin?expand=true，表达式wildcard_replace(http.request.full_uri,"https://*.example.com/*/*","https://example.com/${1}/${2}/${3}")将返回https://example.com/apps/calendar/admin?expand=true。

• 如果完整URI为https://example.com/applications/app1，表达式wildcard_replace(http.request.full_uri,"/applications/*","/apps/${1}")将返回https://example.com/applications/app1（值不变，因为通配符表达式没有与完整URI匹配，您应该使用http.request.uri.path字段进行URI路径匹配）。

• 如果URI路径为/calendar，表达式wildcard_replace(http.request.uri.path,"/*","/apps/${1}")将返回/apps/calendar。

• 如果URI路径为/Apps/calendar，表达式wildcard_replace(http.request.uri.path,"/apps/*","/${1}")将返回/calendar（默认情况下不区分大小写匹配）。

• 如果URI路径为/Apps/calendar，表达式wildcard_replace(http.request.uri.path,"/apps/*","/${1}","s")将返回/Apps/calendar（因为表达式包含了值为s的flags参数，表明启用了区分大小写的匹配模式，在这个模式下，通配符表达式没有匹配到原始URI路径，所以返回结果不变）。

• 如果URI路径为/apps/calendar/login，表达式wildcard_replace(http.request.uri.path,"/apps/*/login","/${1}/login")将返回/calendar/login。