nginx内置變量

為了友善配置和使用nginx，nginx核心子產品ngx_http_core_module自帶有許多内置的人性化變量，這極大的友善了系統管理者對nginx維護和管理。下面我們詳解注解内置變量的含義（當然，如果你懂點HTTP知識的話，就更好了解了）：

$arg_name：請求中的的參數名，即“?”後面的arg_name=arg_value形式的arg_name。

$args：請求中的參數值。

$binary_remote_addr：用戶端位址的二進制形式, 固定長度為4個位元組。

$body_bytes_sent：傳輸給用戶端的位元組數，響應頭不計算在内；這個變量和Apache的mod_log_config子產品中的“%B”參數保持相容。

$bytes_sent：傳輸給用戶端的位元組數。

$connection：TCP連接配接的序列号。

$connection_requests：TCP連接配接目前的請求數量。

$content_length：“Content-Length”請求頭字段。

$content_type：“Content-Type”請求頭字段。

$cookie_name：cookie名稱。

$document_root：目前請求的文檔根目錄或别名。

d o c u m e n t u r i ： 同 下 面 的 document_uri：同下面的 documentu​ri：同下面的uri。

$host：優先級如下：HTTP請求行的主機名>”HOST”請求頭字段>符合請求的伺服器名。

$hostname：主機名。

h t t p n a m e ： 匹 配 任 意 請 求 頭 字 段 ； 變 量 名 中 的 後 半 部 分 “ n a m e ” 可 以 替 換 成 任 意 請 求 頭 字 段 ， 如 在 配 置 文 件 中 需 要 獲 取 h t t p 請 求 頭 ： “ A c c e p t − L a n g u a g e ” ， 那 麼 将 “ － ” 替 換 為 下 劃 線 ， 大 寫 字 母 替 換 為 小 寫 ， 形 如 ： http_name：比對任意請求頭字段； 變量名中的後半部分“name”可以替換成任意請求頭字段，如在配置檔案中需要擷取http請求頭：“Accept-Language”，那麼将“－”替換為下劃線，大寫字母替換為小寫，形如： httpn​ame：比對任意請求頭字段；變量名中的後半部分“name”可以替換成任意請求頭字段，如在配置檔案中需要擷取http請求頭：“Accept−Language”，那麼将“－”替換為下劃線，大寫字母替換為小寫，形如：http_accept_language即可。

$https：如果開啟了SSL安全模式，值為“on”，否則為空字元串。

$is_args：如果請求中有參數，值為“?”，否則為空字元串。

$limit_rate：用于設定響應的速度限制，詳見limit_rate。

$msec：目前的Unix時間戳。

$nginx_version：nginx版本。

$pid：工作程序的PID。

$pipe：如果請求來自管道通信，值為“p”，否則為“.”。

$proxy_protocol_addr：擷取代理通路伺服器的用戶端位址，如果是直接通路，該值為空字元串。

q u e r y s t r i n g ： 同 query_string：同 querys​tring：同args。

$realpath_root：目前請求的文檔根目錄或别名的真實路徑，會将所有符号連接配接轉換為真實路徑。

$remote_addr：用戶端位址。

$remote_port：用戶端端口。

$remote_user：用于HTTP基礎認證服務的使用者名。

$request：代表用戶端的請求位址。

$request_body：用戶端的請求主體。此變量可在location中使用，将請求主體通過proxy_pass, fastcgi_pass, uwsgi_pass, 和 scgi_pass傳遞給下一級的代理伺服器。

$request_body_file：将用戶端請求主體儲存在臨時檔案中。檔案處理結束後，此檔案需删除。如果需要之一開啟此功能，需要設定client_body_in_file_only。如果将次檔案傳遞給後端的代理伺服器，需要禁用request body，即設定proxy_pass_request_body off，fastcgi_pass_request_body off, uwsgi_pass_request_body off, or scgi_pass_request_body off 。

$request_completion：如果請求成功，值為”OK”，如果請求未完成或者請求不是一個範圍請求的最後一部分，則為空。

$request_filename：目前連接配接請求的檔案路徑，由root或alias指令與URI請求生成。

$request_length：請求的長度 (包括請求的位址, http請求頭和請求主體) 。

$request_method：HTTP請求方法，通常為“GET”或“POST”。

$request_time：處理用戶端請求使用的時間 (1.3.9, 1.2.6); 從讀取用戶端的第一個位元組開始計時。

r e q u e s t u r i ： 這 個 變 量 等 于 包 含 一 些 客 戶 端 請 求 參 數 的 原 始 U R I ， 它 無 法 修 改 ， 請 查 看 request_uri：這個變量等于包含一些用戶端請求參數的原始URI，它無法修改，請檢視 requestu​ri：這個變量等于包含一些用戶端請求參數的原始URI，它無法修改，請檢視uri更改或重寫URI，不包含主機名，例如：”/cnphp/test.php?arg=freemouse”。

$scheme：請求使用的Web協定,“http”或“https”。

s e n t h t t p n a m e ： 可 以 設 置 任 意 h t t p 響 應 頭 字 段 ； 變 量 名 中 的 後 半 部 分 “ n a m e ” 可 以 替 換 成 任 意 響 應 頭 字 段 ， 如 需 要 設 置 響 應 頭 C o n t e n t − l e n g t h ， 那 麼 将 “ － ” 替 換 為 下 劃 線 ， 大 寫 字 母 替 換 為 小 寫 ， 形 如 ： sent_http_name：可以設定任意http響應頭字段； 變量名中的後半部分“name”可以替換成任意響應頭字段，如需要設定響應頭Content-length，那麼将“－”替換為下劃線，大寫字母替換為小寫，形如： senth​ttpn​ame：可以設定任意http響應頭字段；變量名中的後半部分“name”可以替換成任意響應頭字段，如需要設定響應頭Content−length，那麼将“－”替換為下劃線，大寫字母替換為小寫，形如：sent_http_content_length 4096即可。

$server_addr：伺服器端位址，需要注意的是：為了避免通路linux系統核心，應将ip位址提前設定在配置檔案中。

$server_name：伺服器名，如www.baidu.com。

$server_port：伺服器端口。

$server_protocol：伺服器的HTTP版本, 通常為“HTTP/1.0”或“HTTP/1.1”。

$status：HTTP響應代碼。

$tcpinfo_rtt, $tcpinfo_rttvar, $tcpinfo_snd_cwnd, $tcpinfo_rcv_space：用戶端TCP連接配接的具體資訊。

$time_iso8601：伺服器時間的ISO 8610格式。

$time_local：伺服器時間（LOG Format 格式）。

u r i ： 請 求 中 的 當 前 U R I ( 不 帶 請 求 參 數 ， 參 數 位 于 uri：請求中的目前URI(不帶請求參數，參數位于 uri：請求中的目前URI(不帶請求參數，參數位于args)，可以不同于浏覽器傳遞的 r e q u e s t u r i 的 值 ， 它 可 以 通 過 内 部 重 定 向 ， 或 者 使 用 i n d e x 指 令 進 行 修 改 ， request_uri的值，它可以通過内部重定向，或者使用index指令進行修改， requestu​ri的值，它可以通過内部重定向，或者使用index指令進行修改，uri不包含主機名，如”/foo/bar.html”。

寫在最後

這些變量可以在配置檔案中使用，友善你做各種nginx頁面代理，轉換，重寫，重定向等操作；而且還可以對nginx日志做自定義的日志配置，友善你對nginx日志的收集和分析（例如使用json格式的nginx配置，隻選取你想要的字段收集到elasticsearch服務中，友善日後檢視和分析）如下