在配置基于nginx服務(wù)器的網(wǎng)站時(shí)，必然會(huì)使用到nginx內(nèi)置變量配置相關(guān)信息，下面將根據(jù)網(wǎng)上的相關(guān)資料進(jìn)行整理，以方便在配置Nginx時(shí)查詢。

nginx內(nèi)置變量

Nginx內(nèi)置變量存放在ngx_http_core_module模塊中，變量的命名方式和apache 服務(wù)器變量是一致的?？偠灾?，這些變量代表著客戶端請求頭的內(nèi)容，例如$http_user_agent, $http_cookie等等。

下面是nginx支持的所有內(nèi)置變量：

• $arg_name

  請求中的的參數(shù)名，即“?”后面的arg_name=arg_value形式的arg_name

• $args

  請求中的參數(shù)值

• $binary_remote_addr

  客戶端地址的二進(jìn)制形式, 固定長度為4個(gè)字節(jié)

• $body_bytes_sent

  傳輸給客戶端的字節(jié)數(shù)，響應(yīng)頭不計(jì)算在內(nèi)；這個(gè)變量和Apache的mod_log_config模塊中的“%B”參數(shù)保持兼容

• $bytes_sent

  傳輸給客戶端的字節(jié)數(shù) (1.3.8, 1.2.5)

• $connection

  TCP連接的序列號 (1.3.8, 1.2.5)

• $connection_requests

  TCP連接當(dāng)前的請求數(shù)量 (1.3.8, 1.2.5)

• $content_length

  “Content-Length” 請求頭字段

• $content_type

  “Content-Type” 請求頭字段

• $cookie_name

  Cookie名稱

• $document_root

  當(dāng)前請求的文檔根目錄或別名

• $document_uri

  同 $uri

• $host

  優(yōu)先級如下：HTTP請求行的主機(jī)名>”HOST”請求頭字段>符合請求的服務(wù)器名

• $hostname

  主機(jī)名

• $http_name

  • 匹配任意請求頭字段；
  • 變量名中的后半部分“name”可以替換成任意請求頭字段，如在配置文件中需要獲取http請求頭：“Accept-Language”，那么將“－”替換為下劃線，大寫字母替換為小寫，形如：$http_accept_language即可。

• $https

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

• $is_args

  如果請求中有參數(shù)，值為“?”，否則為空字符串。

• $limit_rate

  用于設(shè)置響應(yīng)的速度限制，詳見 limit_rate。

• $msec

  當(dāng)前的Unix時(shí)間戳 (1.3.9, 1.2.6)

• $nginx_version

  nginx版本

• $pid

  工作進(jìn)程的PID

• $pipe

  如果請求來自管道通信，值為“p”，否則為“.” (1.3.12, 1.2.7)

• $proxy_protocol_addr

  獲取代理訪問服務(wù)器的客戶端地址，如果是直接訪問，該值為空字符串。(1.5.12)

• $query_string

  同 $args

• $realpath_root

  當(dāng)前請求的文檔根目錄或別名的真實(shí)路徑，會(huì)將所有符號連接轉(zhuǎn)換為真實(shí)路徑。

• $remote_addr

  客戶端地址

• $remote_port

  客戶端端口

• $remote_user

  用于HTTP基礎(chǔ)認(rèn)證服務(wù)的用戶名

• $request

  代表客戶端的請求地址

• $request_body

  • 客戶端的請求主體

  • 此變量可在location中使用，將請求主體通過proxy_pass, fastcgi_pass, uwsgi_pass, 和 scgi_pass傳遞給下一級的代理服務(wù)器。

• $request_body_file

  將客戶端請求主體保存在臨時(shí)文件中。文件處理結(jié)束后，此文件需刪除。如果需要之一開啟此功能，需要設(shè)置client_body_in_file_only。如果將次文件傳遞給后端的代理服務(wù)器，需要禁用request body，即設(shè)置proxy_pass_request_body off，fastcgi_pass_request_body off, uwsgi_pass_request_body off, or scgi_pass_request_body off 。

• $request_completion

  如果請求成功，值為”O(jiān)K”，如果請求未完成或者請求不是一個(gè)范圍請求的最后一部分，則為空。

• $request_filename

  當(dāng)前連接請求的文件路徑，由root或alias指令與URI請求生成。

• $request_length

  請求的長度 (包括請求的地址, http請求頭和請求主體) (1.3.12, 1.2.7)

• $request_method

  HTTP請求方法，通常為“GET”或“POST”

• $request_time

  • 處理客戶端請求使用的時(shí)間 (1.3.9, 1.2.6);
  • 從讀取客戶端的第一個(gè)字節(jié)開始計(jì)時(shí)。

• $request_uri

  這個(gè)變量等于包含一些客戶端請求參數(shù)的原始URI，它無法修改，請查看$uri更改或重寫URI，不包含主機(jī)名，例如：”/cnphp/test.php?arg=freemouse”。

• $scheme

  請求使用的Web協(xié)議, “http” 或 “https”

• $sent_http_name

  • 可以設(shè)置任意http響應(yīng)頭字段；
  • 變量名中的后半部分“name”可以替換成任意響應(yīng)頭字段，如需要設(shè)置響應(yīng)頭Content-length，那么將“－”替換為下劃線，大寫字母替換為小寫，形如：$sent_http_content_length 4096即可。

• $server_addr

  服務(wù)器端地址，需要注意的是：為了避免訪問linux系統(tǒng)內(nèi)核，應(yīng)將ip地址提前設(shè)置在配置文件中。

• $server_name

  服務(wù)器名，www.cnphp.info

• $server_port

  服務(wù)器端口

• $server_protocol

  服務(wù)器的HTTP版本, 通常為 “HTTP/1.0” 或 “HTTP/1.1”

• $status

  HTTP響應(yīng)代碼 (1.3.2, 1.2.2)

• $tcpinfo_rtt, $tcpinfo_rttvar, $tcpinfo_snd_cwnd, $tcpinfo_rcv_space

  客戶端TCP連接的具體信息

• $time_iso8601

  服務(wù)器時(shí)間的ISO 8610格式 (1.3.12, 1.2.7)

• $time_local

  服務(wù)器時(shí)間（LOG Format 格式） (1.3.12, 1.2.7)

• $uri

  請求中的當(dāng)前URI(不帶請求參數(shù)，參數(shù)位于$args)，可以不同于瀏覽器傳遞的$request_uri的值，它可以通過內(nèi)部重定向，或者使用index指令進(jìn)行修改，$uri不包含主機(jī)名，如”/foo/bar.html”。