Mercurial > hg > nginx-site
comparison xml/en/docs/http/ngx_http_fastcgi_module.xml @ 506:657848837328
Documented how nginx processes proxied server's response header fields
(X-Accel-*, Expires, Cache-Control, Set-Cookie) that can be ignored.
author | Ruslan Ermilov <ru@nginx.com> |
---|---|
date | Tue, 24 Apr 2012 07:32:41 +0000 |
parents | 837bcf62b628 |
children | 5e332fafd228 |
comparison
equal
deleted
inserted
replaced
505:837bcf62b628 | 506:657848837328 |
---|---|
331 fastcgi_cache_valid 301 1h; | 331 fastcgi_cache_valid 301 1h; |
332 fastcgi_cache_valid any 1m; | 332 fastcgi_cache_valid any 1m; |
333 </example> | 333 </example> |
334 </para> | 334 </para> |
335 | 335 |
336 <para> | |
337 Parameters of caching can also be set directly | |
338 in the response header. | |
339 This has a higher precedence than setting of caching time using the directive. | |
340 The <header>X-Accel-Expires</header> header field sets caching time of a | |
341 response in seconds. | |
342 The value 0 disables to cache a response. | |
343 If a value starts with the prefix <literal>@</literal>, it sets an absolute | |
344 time in seconds since Epoch, up to which the response may be cached. | |
345 If header does not include the <header>X-Accel-Expires</header> field, | |
346 parameters of caching may be set in the header fields | |
347 <header>Expires</header> or <header>Cache-Control</header>. | |
348 If a header includes the <header>Set-Cookie</header> field, such a | |
349 response will not be cached. | |
350 Processing of one or more of these response header fields can be disabled | |
351 using the <link id="fastcgi_ignore_headers"/> directive. | |
352 </para> | |
353 | |
336 </directive> | 354 </directive> |
337 | 355 |
338 | 356 |
339 <directive name="fastcgi_connect_timeout"> | 357 <directive name="fastcgi_connect_timeout"> |
340 <syntax><value>time</value></syntax> | 358 <syntax><value>time</value></syntax> |
400 The following fields can be ignored: <header>X-Accel-Redirect</header>, | 418 The following fields can be ignored: <header>X-Accel-Redirect</header>, |
401 <header>X-Accel-Expires</header>, <header>X-Accel-Limit-Rate</header> (1.1.6), | 419 <header>X-Accel-Expires</header>, <header>X-Accel-Limit-Rate</header> (1.1.6), |
402 <header>X-Accel-Buffering</header> (1.1.6), | 420 <header>X-Accel-Buffering</header> (1.1.6), |
403 <header>X-Accel-Charset</header> (1.1.6), <header>Expires</header>, | 421 <header>X-Accel-Charset</header> (1.1.6), <header>Expires</header>, |
404 <header>Cache-Control</header>, and <header>Set-Cookie</header> (0.8.44). | 422 <header>Cache-Control</header>, and <header>Set-Cookie</header> (0.8.44). |
423 </para> | |
424 | |
425 <para> | |
426 If not disabled, processing of these header fields has the following effect: | |
427 <list type="bullet" compact="no"> | |
428 | |
429 <listitem> | |
430 <header>X-Accel-Expires</header>, <header>Expires</header>, | |
431 <header>Cache-Control</header>, and <header>Set-Cookie</header> | |
432 set parameters of response <link id="fastcgi_cache_valid">caching</link>; | |
433 </listitem> | |
434 | |
435 <listitem> | |
436 <header>X-Accel-Redirect</header> performs an | |
437 <link doc="ngx_http_core_module.xml" id="internal">internal | |
438 redirect</link> to the specified URI; | |
439 </listitem> | |
440 | |
441 <listitem> | |
442 <header>X-Accel-Limit-Rate</header> sets a | |
443 <link doc="ngx_http_core_module.xml" id="limit_rate">rate | |
444 limit</link> for transmission of a response to a client; | |
445 </listitem> | |
446 | |
447 <listitem> | |
448 <header>X-Accel-Buffering</header> enables or disables | |
449 buffering of a response; | |
450 </listitem> | |
451 | |
452 <listitem> | |
453 <header>X-Accel-Charset</header> sets the desired | |
454 <link doc="ngx_http_charset_module.xml" id="charset"/> | |
455 of a response. | |
456 </listitem> | |
457 | |
458 </list> | |
405 </para> | 459 </para> |
406 | 460 |
407 </directive> | 461 </directive> |
408 | 462 |
409 | 463 |