Nginx 之 十一 內建變數
阿新 • • 發佈：2018-11-17
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…; |
| $http_host | 和$host相同，如果請求資訊中沒有Host行，則可能不同 |
| $http_cookie | 客戶端的cookies |
| $http_referer | 引用地址 |
| $http_user_agent | 客戶端代理的資訊 |
| $http_via | 最後一個訪問伺服器的IP地址 |
| $http_x_forwarded_for | 相當於網路訪問路徑 |
| $is_args | 如果$args設定，值為"?"，否則為""。 |
| $limit_rate | 這個變數可以限制連線速率。 |
| $nginx_version | 當前執行的nginx版本號。 |
| $pid | 當前Nginx伺服器主程序的程序ID |
| $query_string | 與$args相同。 |
| $remote_addr | 客戶端的IP地址。 |
| $remote_port | 客戶端的埠。 |
| $remote_user | 已經經過Auth Basic Module驗證的使用者名稱。 |
| $request | 客戶端請求 |
| $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 |
來源於資料《Nginx高效能Web伺服器詳解》資料