Mercurial > hg > nginx-site

comparison xml/en/docs/http/ngx_http_fastcgi_module.xml @ 506:657848837328

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
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