Mercurial > hg > nginx-site

comparison xml/ru/docs/http/ngx_http_core_module.xml @ 1826:da6a3e401b26

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Slightly reformatted the error_page description. Information about directives inheritance was moved to the end. Blocks describing various syntaxes of the "uri" argument were put in the following order: - internal redirect to the specified /uri; - internal redirect to a named location; - URL redirection.
author Ruslan Ermilov <ru@nginx.com>
date Mon, 24 Oct 2016 11:57:46 +0300
parents ae46e57cecba
children 64e2b8c5200d
comparison
equal deleted inserted replaced
1825:56b6244ddadb 1826:da6a3e401b26
8 <!DOCTYPE module SYSTEM "../../../../dtd/module.dtd"> 8 <!DOCTYPE module SYSTEM "../../../../dtd/module.dtd">
9 9
10 <module name="Модуль ngx_http_core_module" 10 <module name="Модуль ngx_http_core_module"
11 link="/ru/docs/http/ngx_http_core_module.html" 11 link="/ru/docs/http/ngx_http_core_module.html"
12 lang="ru" 12 lang="ru"
13 rev="61"> 13 rev="62">
14 14
15 <section id="directives" name="Директивы"> 15 <section id="directives" name="Директивы">
16 16
17 <directive name="aio"> 17 <directive name="aio">
18 <syntax> 18 <syntax>
606 <context>location</context> 606 <context>location</context>
607 <context>if в location</context> 607 <context>if в location</context>
608 608
609 <para> 609 <para>
610 Задаёт URI, который будет показываться для указанных ошибок. 610 Задаёт URI, который будет показываться для указанных ошибок.
611 Директивы <literal>error_page</literal> наследуются с предыдущего уровня 611 В значении <value>uri</value> можно использовать переменные.
612 при условии, что на данном уровне не заданы свои директивы
613 <literal>error_page</literal>.
614 В значении <literal>uri</literal> можно использовать переменные.
615 </para> 612 </para>
616 613
617 <para> 614 <para>
618 Пример: 615 Пример:
619 <example> 616 <example>
638 error_page 404 = /404.php; 635 error_page 404 = /404.php;
639 </example> 636 </example>
640 </para> 637 </para>
641 638
642 <para> 639 <para>
643 Также существует возможность использовать перенаправления для обработки 640 Если при внутреннем перенаправлении не нужно менять URI, то можно передать
641 обработку ошибки в именованный location:
642 <example>
643 location / {
644 error_page 404 = @fallback;
645 }
646
647 location @fallback {
648 proxy_pass http://backend;
649 }
650 </example>
651 </para>
652
653 <para>
654 <note>
655 Если при обработке <value>uri</value> происходит ошибка,
656 клиенту возвращается ответ с кодом последней случившейся ошибки.
657 </note>
658 </para>
659
660 <para>
661 Также существует возможность использовать перенаправления URL для обработки
644 ошибок: 662 ошибок:
645 <example> 663 <example>
646 error_page 403 http://example.com/forbidden.html; 664 error_page 403 http://example.com/forbidden.html;
647 error_page 404 =301 http://example.com/notfound.html; 665 error_page 404 =301 http://example.com/notfound.html;
648 </example> 666 </example>
650 Его можно изменить только на один из кодов ответа, относящихся к 668 Его можно изменить только на один из кодов ответа, относящихся к
651 перенаправлениям (301, 302, 303 и 307). 669 перенаправлениям (301, 302, 303 и 307).
652 </para> 670 </para>
653 671
654 <para> 672 <para>
655 Если при внутреннем перенаправлении не нужно менять URI, то можно передать 673 Директивы наследуются с предыдущего уровня при условии, что на данном уровне
656 обработку ошибки в именованный location: 674 не описаны свои директивы <literal>error_page</literal>.
657 <example>
658 location / {
659 error_page 404 = @fallback;
660 }
661
662 location @fallback {
663 proxy_pass http://backend;
664 }
665 </example>
666 </para>
667
668 <para>
669 <note>
670 Если при обработке <literal>uri</literal> происходит ошибка,
671 клиенту возвращается ответ с кодом последней случившейся ошибки.
672 </note>
673 </para> 675 </para>
674 676
675 </directive> 677 </directive>
676 678
677 679