Mercurial > hg > nginx-site

comparison xml/en/docs/http/ngx_http_core_module.xml @ 83:e8ed74d3fa0e

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Sorted variables alphabetically.
author Ruslan Ermilov <ru@nginx.com>
date Thu, 13 Oct 2011 08:06:52 +0000
parents 89c31b453d40
children 341dc6392e8a
comparison
equal deleted inserted replaced
82:89c31b453d40 83:e8ed74d3fa0e
2139 fields, such as <var>$http_user_agent</var>, <var>$http_cookie</var>, 2139 fields, such as <var>$http_user_agent</var>, <var>$http_cookie</var>,
2140 and so on. 2140 and so on.
2141 It also supports other variables: 2141 It also supports other variables:
2142 <list type="tag"> 2142 <list type="tag">
2143 2143
2144 <tag-name><var>$arg_</var><argument>name</argument></tag-name>
2145 <tag-desc>
2146 argument <argument>name</argument> in the request line
2147 </tag-desc>
2148
2144 <tag-name><var>$args</var></tag-name> 2149 <tag-name><var>$args</var></tag-name>
2145 <tag-desc> 2150 <tag-desc>
2146 arguments in the request line 2151 arguments in the request line
2147 </tag-desc>
2148
2149 <tag-name><var>$arg_</var><argument>name</argument></tag-name>
2150 <tag-desc>
2151 argument <argument>name</argument> in the request line
2152 </tag-desc> 2152 </tag-desc>
2153 2153
2154 <tag-name><var>$binary_remote_addr</var></tag-name> 2154 <tag-name><var>$binary_remote_addr</var></tag-name>
2155 <tag-desc> 2155 <tag-desc>
2156 client address in a binary form, value's length is always 4 bytes 2156 client address in a binary form, value's length is always 4 bytes
2211 <tag-name><var>$pid</var></tag-name> 2211 <tag-name><var>$pid</var></tag-name>
2212 <tag-desc> 2212 <tag-desc>
2213 PID of the worker process 2213 PID of the worker process
2214 </tag-desc> 2214 </tag-desc>
2215 2215
2216 <tag-name><var>$request_method</var></tag-name> 2216 <tag-name><var>$query_string</var></tag-name>
2217 <tag-desc> 2217 <tag-desc>
2218 request method, usually 2218 same as <var>$args</var>
2219 <dq><code>GET</code></dq> or <dq><code>POST</code></dq>
2220 </tag-desc>
2221
2222 <tag-name><var>$remote_addr</var></tag-name>
2223 <tag-desc>
2224 client address
2225 </tag-desc>
2226
2227 <tag-name><var>$remote_port</var></tag-name>
2228 <tag-desc>
2229 client port
2230 </tag-desc>
2231
2232 <tag-name><var>$remote_user</var></tag-name>
2233 <tag-desc>
2234 user name supplied with the Basic authentication
2235 </tag-desc> 2219 </tag-desc>
2236 2220
2237 <tag-name><var>$realpath_root</var></tag-name> 2221 <tag-name><var>$realpath_root</var></tag-name>
2238 <tag-desc> 2222 <tag-desc>
2239 <link id="root">root</link> directive's value 2223 <link id="root">root</link> directive's value
2240 for the current request, with all symbolic links resolved to real paths 2224 for the current request, with all symbolic links resolved to real paths
2241 </tag-desc> 2225 </tag-desc>
2242 2226
2243 <tag-name><var>$request_filename</var></tag-name> 2227 <tag-name><var>$remote_addr</var></tag-name>
2244 <tag-desc> 2228 <tag-desc>
2245 file path for the current query, based on the 2229 client address
2246 <link id="root">root</link> and <link id="alias">alias</link> 2230 </tag-desc>
2247 directives, and the request URI 2231
2232 <tag-name><var>$remote_port</var></tag-name>
2233 <tag-desc>
2234 client port
2235 </tag-desc>
2236
2237 <tag-name><var>$remote_user</var></tag-name>
2238 <tag-desc>
2239 user name supplied with the Basic authentication
2248 </tag-desc> 2240 </tag-desc>
2249 2241
2250 <tag-name><var>$request_body</var></tag-name> 2242 <tag-name><var>$request_body</var></tag-name>
2251 <tag-desc> 2243 <tag-desc>
2252 request body 2244 request body
2278 id="fastcgi_pass_request_body">fastcgi_pass_request_body</link> 2270 id="fastcgi_pass_request_body">fastcgi_pass_request_body</link>
2279 directives, respectively. 2271 directives, respectively.
2280 </para> 2272 </para>
2281 </tag-desc> 2273 </tag-desc>
2282 2274
2275 <tag-name><var>$request_filename</var></tag-name>
2276 <tag-desc>
2277 file path for the current query, based on the
2278 <link id="root">root</link> and <link id="alias">alias</link>
2279 directives, and the request URI
2280 </tag-desc>
2281
2282 <tag-name><var>$request_method</var></tag-name>
2283 <tag-desc>
2284 request method, usually
2285 <dq><code>GET</code></dq> or <dq><code>POST</code></dq>
2286 </tag-desc>
2287
2283 <tag-name><var>$request_uri</var></tag-name> 2288 <tag-name><var>$request_uri</var></tag-name>
2284 <tag-desc> 2289 <tag-desc>
2285 full original request URI (with arguments) 2290 full original request URI (with arguments)
2286 </tag-desc> 2291 </tag-desc>
2287 2292
2288 <tag-name><var>$query_string</var></tag-name>
2289 <tag-desc>
2290 same as <var>$args</var>
2291 </tag-desc>
2292
2293 <tag-name><var>$scheme</var></tag-name> 2293 <tag-name><var>$scheme</var></tag-name>
2294 <tag-desc> 2294 <tag-desc>
2295 request scheme, <dq><code>http</code></dq> or <dq><code>https</code></dq> 2295 request scheme, <dq><code>http</code></dq> or <dq><code>https</code></dq>
2296 </tag-desc>
2297
2298 <tag-name><var>$server_addr</var></tag-name>
2299 <tag-desc>
2300 an address of the server which accepted a request
2301 <para>
2302 Computing a value of this variable usually requires one system call.
2303 To avoid a system call, the <link id="listen">listen</link> directives
2304 must specify addresses and use the <parameter>bind</parameter> parameter
2305 </para>
2306 </tag-desc>
2307
2308 <tag-name><var>$server_name</var></tag-name>
2309 <tag-desc>
2310 name of the server which accepted a request
2311 </tag-desc>
2312
2313 <tag-name><var>$server_port</var></tag-name>
2314 <tag-desc>
2315 port of the server which accepted a request
2296 </tag-desc> 2316 </tag-desc>
2297 2317
2298 <tag-name><var>$server_protocol</var></tag-name> 2318 <tag-name><var>$server_protocol</var></tag-name>
2299 <tag-desc> 2319 <tag-desc>
2300 request protocol, usually 2320 request protocol, usually
2301 <dq><code>HTTP/1.0</code></dq> 2321 <dq><code>HTTP/1.0</code></dq>
2302 or 2322 or
2303 <dq><code>HTTP/1.1</code></dq> 2323 <dq><code>HTTP/1.1</code></dq>
2304 </tag-desc> 2324 </tag-desc>
2305 2325
2306 <tag-name><var>$server_addr</var></tag-name>
2307 <tag-desc>
2308 an address of the server which accepted a request
2309 <para>
2310 Computing a value of this variable usually requires one system call.
2311 To avoid a system call, the <link id="listen">listen</link> directives
2312 must specify addresses and use the <parameter>bind</parameter> parameter
2313 </para>
2314 </tag-desc>
2315
2316 <tag-name><var>$server_name</var></tag-name>
2317 <tag-desc>
2318 name of the server which accepted a request
2319 </tag-desc>
2320
2321 <tag-name><var>$server_port</var></tag-name>
2322 <tag-desc>
2323 port of the server which accepted a request
2324 </tag-desc>
2325
2326 <tag-name><var>$uri</var></tag-name> 2326 <tag-name><var>$uri</var></tag-name>
2327 <tag-desc> 2327 <tag-desc>
2328 current URI in request 2328 current URI in request
2329 <para> 2329 <para>
2330 It may differ from an original, e.g. when doing internal redirects, 2330 It may differ from an original, e.g. when doing internal redirects,