nginx內建預定義變數

工程師WWW發表於2015-06-26

nginx的配置檔案中可以使用的內建變數以美元符$開始,也有人叫全域性變數。其中,部分預定義的變數的值是可以改變的。

$arg_PARAMETER 這個變數值為:GET請求中變數名PARAMETER引數的值。

$args 這個變數等於GET請求中的引數。例如,foo=123&bar=blahblah;這個變數只可以被修改

$binary_remote_addr 二進位制碼形式的客戶端地址。

$body_bytes_sent 傳送頁面的位元組數

$content_length 請求頭中的Content-length欄位。

$content_type 請求頭中的Content-Type欄位。

$cookie_COOKIE cookie COOKIE的值。

$document_root 當前請求在root指令中指定的值。

$document_uri 與$uri相同。

$host 請求中的主機頭(Host)欄位,如果請求中的主機頭不可用或者空,則為處理請求的server名稱(處理請求的server的server_name指令的值)。值為小寫,不包含埠。

$hostname  機器名使用 gethostname系統呼叫的值

$http_HEADER   HTTP請求頭中的內容,HEADER為HTTP請求中的內容轉為小寫,-變為_(破折號變為下劃線),例如:$http_user_agent(Uaer-Agent的值), $http_referer...;

$sent_http_HEADER  HTTP響應頭中的內容,HEADER為HTTP響應中的內容轉為小寫,-變為_(破折號變為下劃線),例如: $sent_http_cache_control, $sent_http_content_type...;

$is_args 如果$args設定,值為"?",否則為""。

$limit_rate 這個變數可以限制連線速率。

$nginx_version 當前執行的nginx版本號。

$query_string 與$args相同。

$remote_addr 客戶端的IP地址。

$remote_port 客戶端的埠。

$remote_user 已經經過Auth Basic Module驗證的使用者名稱。

$request_filename 當前連線請求的檔案路徑,由root或alias指令與URI請求生成。

$request_body 這個變數(0.7.58+)包含請求的主要資訊。在使用proxy_pass或fastcgi_pass指令的location中比較有意義。

$request_body_file 客戶端請求主體資訊的臨時檔名。

$request_completion 如果請求成功,設為"OK";如果請求未完成或者不是一系列請求中最後一部分則設為空。

$request_method 這個變數是客戶端請求的動作,通常為GET或POST。
包括0.8.20及之前的版本中,這個變數總為main request中的動作,如果當前請求是一個子請求,並不使用這個當前請求的動作。

$request_uri 這個變數等於包含一些客戶端請求引數的原始URI,它無法修改,請檢視$uri更改或重寫URI。

$scheme 所用的協議,比如http或者是https,比如rewrite ^(.+)$ $scheme://example.com$1 redirect;

$server_addr 伺服器地址,在完成一次系統呼叫後可以確定這個值,如果要繞開系統呼叫,則必須在listen中指定地址並且使用bind引數。

$server_name 伺服器名稱。

$server_port 請求到達伺服器的埠號。

$server_protocol 請求使用的協議,通常是HTTP/1.0或HTTP/1.1。

$uri 請求中的當前URI(不帶請求引數,引數位於$args),不同於瀏覽器傳遞的$request_uri的值,它可以通過內部重定向,或者使用index指令進行修改。不包括協議和主機名,例如/foo/bar.html

相關文章