全部產品
Search

搜尋本產品

    CDN：EdgeScript內建變數表

    文件中心

    CDN：EdgeScript內建變數表

    更新時間：Jun 30, 2024

    本文為您介紹EdgeScript指令碼中所有內建變數的含義和對應nginx原生變數。

    說明

    • 內建變數名前的特殊符號（$）是為了強調內建變數屬性，刪除後不影響使用。

    • 內建變數不允許擔當左值，即內建變數不允許被賦值。

    • 每條EdgeScript規則中最多支援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

    用戶端與CDN節點建聯使用的IP地址。

    $remote_addr