comparison xml/en/docs/http/ngx_http_proxy_module.xml @ 942:ba3d6ade3513

Elaborate on upstream server failures. Documented that {proxy,fastcgi,memcached}_next_upstream directives define what is considered an unsuccessful attempt of communication with a server.
author Ruslan Ermilov <ru@nginx.com>
date Fri, 05 Jul 2013 10:40:38 +0400
parents e26a18eb5ccd
children fbb4cc6f8c3d
comparison
equal deleted inserted replaced
941:7d1d53d4d293 942:ba3d6ade3513
8 <!DOCTYPE module SYSTEM "../../../../dtd/module.dtd"> 8 <!DOCTYPE module SYSTEM "../../../../dtd/module.dtd">
9 9
10 <module name="Module ngx_http_proxy_module" 10 <module name="Module ngx_http_proxy_module"
11 link="/en/docs/http/ngx_http_proxy_module.html" 11 link="/en/docs/http/ngx_http_proxy_module.html"
12 lang="en" 12 lang="en"
13 rev="11"> 13 rev="12">
14 14
15 <section id="summary"> 15 <section id="summary">
16 16
17 <para> 17 <para>
18 The <literal>ngx_http_proxy_module</literal> module allows to pass 18 The <literal>ngx_http_proxy_module</literal> module allows to pass
881 only possible if a client was not sent anything yet. 881 only possible if a client was not sent anything yet.
882 That is, if an error or a timeout occurs in the middle of 882 That is, if an error or a timeout occurs in the middle of
883 transferring a response, fixing this is impossible. 883 transferring a response, fixing this is impossible.
884 </para> 884 </para>
885 885
886 <para>
887 The directive also defines what is considered an unsuccessful attempt
888 of communication with a
889 <link doc="ngx_http_upstream_module.xml" id="server"/>.
890 The cases of <literal>error</literal>, <literal>timeout</literal> and
891 <literal>invalid_header</literal> are always considered unsuccessful attempts,
892 even if they are not specified in the directive.
893 The cases of <literal>http_500</literal>, <literal>http_502</literal>,
894 <literal>http_503</literal> and <literal>http_504</literal> are
895 considered unsuccessful attempts only if they are specified in the directive.
896 The cases of <literal>http_403</literal> and <literal>http_404</literal>
897 are never considered unsuccessful attempts.
898 </para>
899
886 </directive> 900 </directive>
887 901
888 902
889 <directive name="proxy_no_cache"> 903 <directive name="proxy_no_cache">
890 <syntax><value>string</value> ...</syntax> 904 <syntax><value>string</value> ...</syntax>