Mercurial > hg > nginx-site

comparison xml/en/docs/http/ngx_http_core_module.xml @ 1827:64e2b8c5200d

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Documented request method change by error_page in /uri redirection.
author Ruslan Ermilov <ru@nginx.com>
date Mon, 24 Oct 2016 11:57:50 +0300
parents da6a3e401b26
children 5cd4964fbc5f
comparison
equal deleted inserted replaced
1826:da6a3e401b26 1827:64e2b8c5200d
8 <!DOCTYPE module SYSTEM "../../../../dtd/module.dtd"> 8 <!DOCTYPE module SYSTEM "../../../../dtd/module.dtd">
9 9
10 <module name="Module ngx_http_core_module" 10 <module name="Module ngx_http_core_module"
11 link="/en/docs/http/ngx_http_core_module.html" 11 link="/en/docs/http/ngx_http_core_module.html"
12 lang="en" 12 lang="en"
13 rev="62"> 13 rev="63">
14 14
15 <section id="directives" name="Directives"> 15 <section id="directives" name="Directives">
16 16
17 <directive name="aio"> 17 <directive name="aio">
18 <syntax> 18 <syntax>
621 error_page 500 502 503 504 /50x.html; 621 error_page 500 502 503 504 /50x.html;
622 </example> 622 </example>
623 </para> 623 </para>
624 624
625 <para> 625 <para>
626 This causes an internal redirect to the specified <value>uri</value>
627 with the client request method changed to “<literal>GET</literal>”
628 (for all methods other than
629 “<literal>GET</literal>” and “<literal>HEAD</literal>”).
630 </para>
631
632 <para>
626 Furthermore, it is possible to change the response code to another 633 Furthermore, it is possible to change the response code to another
627 using the “<literal>=</literal><value>response</value>” syntax, for example: 634 using the “<literal>=</literal><value>response</value>” syntax, for example:
628 <example> 635 <example>
629 error_page 404 =200 /empty.gif; 636 error_page 404 =200 /empty.gif;
630 </example> 637 </example>
639 error_page 404 = /404.php; 646 error_page 404 = /404.php;
640 </example> 647 </example>
641 </para> 648 </para>
642 649
643 <para> 650 <para>
644 If there is no need to change URI during internal redirection it is 651 If there is no need to change URI and method during internal redirection
645 possible to pass error processing into a named location: 652 it is possible to pass error processing into a named location:
646 <example> 653 <example>
647 location / { 654 location / {
648 error_page 404 = @fallback; 655 error_page 404 = @fallback;
649 } 656 }
650 657