Edge Security Acceleration：函數

格式：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。

處理邏輯：

• 將與Regex匹配的源字串的一部分替換為替換字串，並返回替換結果。

• 預設情況下，字串的匹配區分大小寫。

• 當源字串中存在多個匹配時，只會替換第一個匹配值。

• 可以在替換字串中的$符號前加上另一個$符號來進行轉義。

• 替換字串可以包含對Regex擷取的群組的引用（使用格式${<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。