# HG changeset patch # User Vladimir Homutov # Date 1397642153 -14400 # Node ID 07402a11fd8dc0b8583de1f1594570494dec1b3f # Parent b0e56cc57867b7a820ace26acee48185e705049e Assigned IDs to tags describing variables. diff --git a/xml/en/docs/http/ngx_http_browser_module.xml b/xml/en/docs/http/ngx_http_browser_module.xml --- a/xml/en/docs/http/ngx_http_browser_module.xml +++ b/xml/en/docs/http/ngx_http_browser_module.xml @@ -10,7 +10,7 @@ + rev="2">
@@ -20,19 +20,19 @@ whose values depend on the value of the request header field: -$modern_browser +$modern_browser equals the value set by the directive, if a browser was identified as modern; -$ancient_browser +$ancient_browser equals the value set by the directive, if a browser was identified as ancient; -$msie +$msie equals “1” if a browser was identified as MSIE of any version. diff --git a/xml/en/docs/http/ngx_http_fastcgi_module.xml b/xml/en/docs/http/ngx_http_fastcgi_module.xml --- a/xml/en/docs/http/ngx_http_fastcgi_module.xml +++ b/xml/en/docs/http/ngx_http_fastcgi_module.xml @@ -10,7 +10,7 @@ + rev="14">
@@ -1237,7 +1237,8 @@ variables that can be used to set parame directive: -$fastcgi_script_name +$fastcgi_script_name + request URI or, if a URI ends with a slash, request URI with an index file name configured by the directive appended to it. @@ -1260,7 +1261,7 @@ the first capture set by the directive. -$fastcgi_path_info +$fastcgi_path_info the value of the second capture set by the directive. This variable can be used to set the diff --git a/xml/en/docs/http/ngx_http_geoip_module.xml b/xml/en/docs/http/ngx_http_geoip_module.xml --- a/xml/en/docs/http/ngx_http_geoip_module.xml +++ b/xml/en/docs/http/ngx_http_geoip_module.xml @@ -10,7 +10,7 @@ + rev="5">
@@ -68,19 +68,20 @@ depending on the client IP address. The following variables are available when using this database: -$geoip_country_code +$geoip_country_code two-letter country code, for example, “RU”, “US”. -$geoip_country_code3 +$geoip_country_code3 + three-letter country code, for example, “RUS”, “USA”. -$geoip_country_name +$geoip_country_name country name, for example, “Russian Federation”, “United States”. @@ -103,7 +104,7 @@ depending on the client IP address. The following variables are available when using this database: -$geoip_area_code +$geoip_area_code telephone area code (US only). This variable may contain outdated information since @@ -111,63 +112,67 @@ the corresponding database field is depr -$geoip_city_continent_code + +$geoip_city_continent_code two-letter continent code, for example, “EU”, “NA”. -$geoip_city_country_code +$geoip_city_country_code + two-letter country code, for example, “RU”, “US”. -$geoip_city_country_code3 +$geoip_city_country_code3 + three-letter country code, for example, “RUS”, “USA”. -$geoip_city_country_name +$geoip_city_country_name + country name, for example, “Russian Federation”, “United States”. -$geoip_dma_code +$geoip_dma_code DMA region code in US (also known as “metro code”), according to the geotargeting in Google AdWords API. -$geoip_latitude +$geoip_latitude latitude. -$geoip_longitude +$geoip_longitude longitude. -$geoip_region +$geoip_region two-symbol country region code (region, territory, state, province, federal land and the like), for example, “48”, “DC”. -$geoip_region_name +$geoip_region_name country region name (region, territory, state, province, federal land and the like), for example, “Moscow City”, “District of Columbia”. -$geoip_city +$geoip_city city name, for example, “Moscow”, “Washington”. -$geoip_postal_code +$geoip_postal_code postal code. @@ -190,7 +195,7 @@ depending on the client IP address. The following variable is available when using this database: -$geoip_org +$geoip_org organization name, for example, “The University of Melbourne”. diff --git a/xml/en/docs/http/ngx_http_log_module.xml b/xml/en/docs/http/ngx_http_log_module.xml --- a/xml/en/docs/http/ngx_http_log_module.xml +++ b/xml/en/docs/http/ngx_http_log_module.xml @@ -10,7 +10,7 @@ + rev="11">
@@ -268,55 +268,56 @@ The log format can contain common variab exist only at the time of a log write: -$bytes_sent +$bytes_sent the number of bytes sent to a client -$connection +$connection connection serial number -$connection_requests +$connection_requests + the current number of requests made through a connection (1.1.18) -$msec +$msec time in seconds with a milliseconds resolution at the time of the log write -$pipe +$pipe p” if request was pipelined, “.” otherwise -$request_length +$request_length request length (including request line, header, and request body) -$request_time +$request_time request processing time in seconds with a milliseconds resolution; time elapsed between the first bytes were read from the client and the log write after the last bytes were sent to the client -$status +$status response status -$time_iso8601 +$time_iso8601 local time in the ISO 8601 standard format -$time_local +$time_local local time in the Common Log Format diff --git a/xml/en/docs/http/ngx_http_proxy_module.xml b/xml/en/docs/http/ngx_http_proxy_module.xml --- a/xml/en/docs/http/ngx_http_proxy_module.xml +++ b/xml/en/docs/http/ngx_http_proxy_module.xml @@ -10,7 +10,7 @@ + rev="18">
@@ -1658,13 +1658,14 @@ that can be used to compose headers usin directive: -$proxy_host +$proxy_host name and port of a proxied server; -$proxy_port +$proxy_port port of a proxied server; -$proxy_add_x_forwarded_for + +$proxy_add_x_forwarded_for the
X-Forwarded-For
client request header field with the $remote_addr variable appended to it, separated by a comma. If the
X-Forwarded-For
field is not present in the client diff --git a/xml/en/docs/http/ngx_http_secure_link_module.xml b/xml/en/docs/http/ngx_http_secure_link_module.xml --- a/xml/en/docs/http/ngx_http_secure_link_module.xml +++ b/xml/en/docs/http/ngx_http_secure_link_module.xml @@ -10,7 +10,7 @@ + rev="3">
@@ -226,13 +226,14 @@ echo -n 'linksecret' | openssl md5 -hex -$secure_link +$secure_link The status of a link check. The specific value depends on the selected operation mode. -$secure_link_expires +$secure_link_expires + The lifetime of a link passed in a request; intended to be used only in the diff --git a/xml/en/docs/http/ngx_http_session_log_module.xml b/xml/en/docs/http/ngx_http_session_log_module.xml --- a/xml/en/docs/http/ngx_http_session_log_module.xml +++ b/xml/en/docs/http/ngx_http_session_log_module.xml @@ -9,7 +9,7 @@ + rev="2">
@@ -142,12 +142,13 @@ two embedded variables: -$session_log_id +$session_log_id current session ID; -$session_log_binary_id +$session_log_binary_id + current session ID in binary form (16 bytes). diff --git a/xml/en/docs/http/ngx_http_ssi_module.xml b/xml/en/docs/http/ngx_http_ssi_module.xml --- a/xml/en/docs/http/ngx_http_ssi_module.xml +++ b/xml/en/docs/http/ngx_http_ssi_module.xml @@ -10,7 +10,7 @@ + rev="5">
@@ -414,14 +414,14 @@ The ngx_http_ssi_module -$date_local +$date_local current time in the local time zone. The format is set by the config command with the timefmt parameter. -$date_gmt +$date_gmt current time in GMT. The format is set by the config command diff --git a/xml/en/docs/http/ngx_http_ssl_module.xml b/xml/en/docs/http/ngx_http_ssl_module.xml --- a/xml/en/docs/http/ngx_http_ssl_module.xml +++ b/xml/en/docs/http/ngx_http_ssl_module.xml @@ -10,7 +10,7 @@ + rev="13">
@@ -661,13 +661,13 @@ The ngx_http_ssl_module -$ssl_cipher +$ssl_cipher returns the string of ciphers used for an established SSL connection; -$ssl_client_cert +$ssl_client_cert returns the client certificate in the PEM format for an established SSL connection, with each line except the first @@ -676,48 +676,49 @@ this is intended for the use in the directive; -$ssl_client_raw_cert +$ssl_client_raw_cert + returns the client certificate in the PEM format for an established SSL connection; -$ssl_client_serial +$ssl_client_serial returns the serial number of the client certificate for an established SSL connection; -$ssl_client_s_dn +$ssl_client_s_dn returns the “subject DN” string of the client certificate for an established SSL connection; -$ssl_client_i_dn +$ssl_client_i_dn returns the “issuer DN” string of the client certificate for an established SSL connection; -$ssl_client_verify +$ssl_client_verify returns the result of client certificate verification: “SUCCESS”, “FAILED”, and “NONE” if a certificate was not present; -$ssl_protocol +$ssl_protocol returns the protocol of an established SSL connection; -$ssl_session_id +$ssl_session_id returns the session identifier of an established SSL connection; -$ssl_session_reused +$ssl_session_reused returns “r” if an SSL session was reused, or “.” otherwise (1.5.11). diff --git a/xml/en/docs/http/ngx_http_upstream_module.xml b/xml/en/docs/http/ngx_http_upstream_module.xml --- a/xml/en/docs/http/ngx_http_upstream_module.xml +++ b/xml/en/docs/http/ngx_http_upstream_module.xml @@ -10,7 +10,7 @@ + rev="20">
@@ -1168,7 +1168,7 @@ The ngx_http_upstream_module -$upstream_addr +$upstream_addr keeps the IP address and port of the server, or the path to the UNIX-domain socket. @@ -1183,7 +1183,8 @@ then the server addresses from different “192.168.1.1:80, 192.168.1.2:80, unix:/tmp/sock : 192.168.10.1:80, 192.168.10.2:80”. -$upstream_cache_status +$upstream_cache_status + keeps the status of accessing a response cache (0.8.3). The status can be either “MISS”, @@ -1192,7 +1193,8 @@ The status can be either “MISS”, “REVALIDATED” or “HIT”. -$upstream_response_length +$upstream_response_length + keeps the lengths of responses obtained from the upstream servers (0.7.27); lengths are kept in bytes. @@ -1200,7 +1202,8 @@ Several response lengths are separated b like addresses in the $upstream_addr variable. -$upstream_response_time +$upstream_response_time + keeps times of responses obtained from upstream servers; times are kept in seconds with a milliseconds resolution. @@ -1208,14 +1211,14 @@ Several response times are separated by like addresses in the $upstream_addr variable. -$upstream_status +$upstream_status keeps codes of responses obtained from upstream servers. Several response codes are separated by commas and colons like addresses in the $upstream_addr variable. -$upstream_http_... +$upstream_http_... keep server response header fields. For example, the
Server
response header field diff --git a/xml/ru/docs/http/ngx_http_browser_module.xml b/xml/ru/docs/http/ngx_http_browser_module.xml --- a/xml/ru/docs/http/ngx_http_browser_module.xml +++ b/xml/ru/docs/http/ngx_http_browser_module.xml @@ -10,7 +10,7 @@ + rev="2">
@@ -20,19 +20,19 @@ в заголовке запроса: -$modern_browser +$modern_browser равна значению, заданному директивой , если браузер опознан как современный; -$ancient_browser +$ancient_browser равна значению, заданному директивой , если браузер опознан как устаревший; -$msie +$msie равна “1”, если браузер опознан как MSIE любой версии. diff --git a/xml/ru/docs/http/ngx_http_fastcgi_module.xml b/xml/ru/docs/http/ngx_http_fastcgi_module.xml --- a/xml/ru/docs/http/ngx_http_fastcgi_module.xml +++ b/xml/ru/docs/http/ngx_http_fastcgi_module.xml @@ -10,7 +10,7 @@ + rev="14">
@@ -1228,7 +1228,8 @@ fastcgi_temp_path /spool/nginx/fastcgi_t : -$fastcgi_script_name +$fastcgi_script_name + URI запроса или же, если URI заканчивается слэшом, то URI запроса, дополненное именем индексного файла, задаваемого директивой @@ -1252,7 +1253,7 @@ fastcgi_param SCRIPT_FILENAME /home/www/ -$fastcgi_path_info +$fastcgi_path_info значение второго выделения, задаваемого директивой . Эту переменную можно использовать для задания параметра diff --git a/xml/ru/docs/http/ngx_http_geoip_module.xml b/xml/ru/docs/http/ngx_http_geoip_module.xml --- a/xml/ru/docs/http/ngx_http_geoip_module.xml +++ b/xml/ru/docs/http/ngx_http_geoip_module.xml @@ -10,7 +10,7 @@ + rev="5">
@@ -68,19 +68,20 @@ http { При использовании этой базы данных доступны следующие переменные: -$geoip_country_code +$geoip_country_code двухбуквенный код страны, например, “RU”, “US”. -$geoip_country_code3 +$geoip_country_code3 + трёхбуквенный код страны, например, “RUS”, “USA”. -$geoip_country_name +$geoip_country_name название страны, например, “Russian Federation”, “United States”. @@ -103,7 +104,7 @@ http { При использовании этой базы данных доступны следующие переменные: -$geoip_area_code +$geoip_area_code телефонный код области (только для США). Данная переменная может содержать неактуальную информацию, т.к. @@ -111,63 +112,68 @@ http { -$geoip_city_continent_code + +$geoip_city_continent_code + двухбуквенный код континента, например, “EU”, “NA”. -$geoip_city_country_code +$geoip_city_country_code + двухбуквенный код страны, например, “RU”, “US”. -$geoip_city_country_code3 +$geoip_city_country_code3 + трёхбуквенный код страны, например, “RUS”, “USA”. -$geoip_city_country_name +$geoip_city_country_name + название страны, например, “Russian Federation”, “United States”. -$geoip_dma_code +$geoip_dma_code DMA-код региона в США (также известный как “код агломерации”), согласно геотаргетингу Google AdWords API. -$geoip_latitude +$geoip_latitude широта. -$geoip_longitude +$geoip_longitude долгота. -$geoip_region +$geoip_region двухсимвольный код региона страны (область, край, штат, провинция, федеральная земля и тому подобное), например, “48”, “DC”. -$geoip_region_name +$geoip_region_name название региона страны (область, край, штат, провинция, федеральная земля и тому подобное), например, “Moscow City”, “District of Columbia”. -$geoip_city +$geoip_city название города, например, “Moscow”, “Washington”. -$geoip_postal_code +$geoip_postal_code почтовый индекс. @@ -190,7 +196,7 @@ Google AdWords API. При использовании этой базы данных доступна следующая переменная: -$geoip_org +$geoip_org название организации, например, “The University of Melbourne”. diff --git a/xml/ru/docs/http/ngx_http_log_module.xml b/xml/ru/docs/http/ngx_http_log_module.xml --- a/xml/ru/docs/http/ngx_http_log_module.xml +++ b/xml/ru/docs/http/ngx_http_log_module.xml @@ -10,7 +10,7 @@ + rev="10">
@@ -190,54 +190,55 @@ server { существующие только на момент записи в лог: -$bytes_sent +$bytes_sent число байт, переданное клиенту -$connection +$connection порядковый номер соединения -$connection_requests +$connection_requests + текущее число запросов в соединении (1.1.18) -$msec +$msec время в секундах с точностью до миллисекунд на момент записи в лог -$pipe +$pipe p” если запрос был pipelined, иначе “. -$request_length +$request_length длина запроса (включая строку запроса, заголовок и тело запроса) -$request_time +$request_time время обработки запроса в секундах с точностью до миллисекунд; время, прошедшее с момента чтения первых байт от клиента до момента записи в лог после отправки последних байт клиенту -$status +$status статус ответа -$time_iso8601 +$time_iso8601 локальное время в формате по стандарту ISO 8601 -$time_local +$time_local локальное время в Common Log Format diff --git a/xml/ru/docs/http/ngx_http_proxy_module.xml b/xml/ru/docs/http/ngx_http_proxy_module.xml --- a/xml/ru/docs/http/ngx_http_proxy_module.xml +++ b/xml/ru/docs/http/ngx_http_proxy_module.xml @@ -10,7 +10,7 @@ + rev="18">
@@ -1653,13 +1653,14 @@ proxy_temp_path /spool/nginx/proxy_temp : -$proxy_host +$proxy_host имя проксируемого хоста и порт; -$proxy_port +$proxy_port порт проксируемого хоста; -$proxy_add_x_forwarded_for + +$proxy_add_x_forwarded_for поле заголовка запроса клиента
X-Forwarded-For
и добавленная к нему через запятую переменная $remote_addr. Если же поля
X-Forwarded-For
в заголовке запроса клиента нет, diff --git a/xml/ru/docs/http/ngx_http_secure_link_module.xml b/xml/ru/docs/http/ngx_http_secure_link_module.xml --- a/xml/ru/docs/http/ngx_http_secure_link_module.xml +++ b/xml/ru/docs/http/ngx_http_secure_link_module.xml @@ -10,7 +10,7 @@ + rev="3">
@@ -226,13 +226,14 @@ echo -n 'linksecret' | openssl md5 -hex -$secure_link +$secure_link Результат проверки ссылки. Конкретное значение зависит от выбранного режима работы. -$secure_link_expires +$secure_link_expires + Время действия ссылки, переданное в запросе. Предназначено исключительно для использования в директиве diff --git a/xml/ru/docs/http/ngx_http_ssi_module.xml b/xml/ru/docs/http/ngx_http_ssi_module.xml --- a/xml/ru/docs/http/ngx_http_ssi_module.xml +++ b/xml/ru/docs/http/ngx_http_ssi_module.xml @@ -10,7 +10,7 @@ + rev="5">
@@ -418,14 +418,14 @@ SSI, например: две встроенные переменные: -$date_local +$date_local текущее время в локальной временной зоне. Формат задаётся командой config с параметром timefmt. -$date_gmt +$date_gmt текущее время в GMT. Формат задаётся командой config diff --git a/xml/ru/docs/http/ngx_http_ssl_module.xml b/xml/ru/docs/http/ngx_http_ssl_module.xml --- a/xml/ru/docs/http/ngx_http_ssl_module.xml +++ b/xml/ru/docs/http/ngx_http_ssl_module.xml @@ -10,7 +10,7 @@ + rev="13">
@@ -661,12 +661,12 @@ ssl_stapling_responder http://ocsp.examp несколько встроенных переменных: -$ssl_cipher +$ssl_cipher возвращает строку используемых шифров для установленного SSL-соединения; -$ssl_client_cert +$ssl_client_cert возвращает клиентский сертификат для установленного SSL-соединения в формате PEM @@ -675,48 +675,49 @@ ssl_stapling_responder http://ocsp.examp ; -$ssl_client_raw_cert +$ssl_client_raw_cert + возвращает клиентский сертификат для установленного SSL-соединения в формате PEM; -$ssl_client_serial +$ssl_client_serial возвращает серийный номер клиентского сертификата для установленного SSL-соединения; -$ssl_client_s_dn +$ssl_client_s_dn возвращает строку “subject DN” клиентского сертификата для установленного SSL-соединения; -$ssl_client_i_dn +$ssl_client_i_dn возвращает строку “issuer DN” клиентского сертификата для установленного SSL-соединения; -$ssl_client_verify +$ssl_client_verify возвращает результат проверки клиентского сертификата: “SUCCESS”, “FAILED” и, если сертификат не был предоставлен — “NONE”; -$ssl_protocol +$ssl_protocol возвращает протокол установленного SSL-соединения; -$ssl_session_id +$ssl_session_id возвращает идентификатор сессии установленного SSL-соединения; -$ssl_session_reused +$ssl_session_reused возвращает “r”, если сессия была использована повторно, иначе “.” (1.5.11). diff --git a/xml/ru/docs/http/ngx_http_upstream_module.xml b/xml/ru/docs/http/ngx_http_upstream_module.xml --- a/xml/ru/docs/http/ngx_http_upstream_module.xml +++ b/xml/ru/docs/http/ngx_http_upstream_module.xml @@ -10,7 +10,7 @@ + rev="6">
@@ -470,7 +470,7 @@ server { поддерживает следующие встроенные переменные: -$upstream_addr +$upstream_addr хранит IP-адрес и порт сервера или путь к UNIX-сокету. Если при обработке запроса были сделаны обращения к нескольким серверам, @@ -485,7 +485,8 @@ server { “192.168.1.1:80, 192.168.1.2:80, unix:/tmp/sock : 192.168.10.1:80, 192.168.10.2:80”. -$upstream_cache_status +$upstream_cache_status + хранит статус доступа к кэшу ответов (0.8.3). Статус может быть одним из “MISS”, @@ -494,7 +495,8 @@ server { “REVALIDATED” или “HIT”. -$upstream_response_length +$upstream_response_length + хранит длины ответов, полученных от серверов группы (0.7.27); длины хранятся в байтах. @@ -502,7 +504,8 @@ server { подобно адресам в переменной $upstream_addr. -$upstream_response_time +$upstream_response_time + хранит времена ответов, полученных от серверов группы; времена хранятся в секундах с точностью до миллисекунд. @@ -510,14 +513,14 @@ server { подобно адресам в переменной $upstream_addr. -$upstream_status +$upstream_status хранит коды ответов, полученных от серверов группы. Коды нескольких ответов разделяются запятыми и двоеточиями подобно адресам в переменной $upstream_addr. -$upstream_http_... +$upstream_http_... хранят поля заголовка ответа сервера. Например, поле заголовка ответа
Server