Mercurial > hg > nginx-site
changeset 674:c48c0936b4df
Documented internal redirections limit.
author | Vladimir Homutov <vl@nginx.com> |
---|---|
date | Fri, 07 Sep 2012 13:00:26 +0000 |
parents | f2d8603813b0 |
children | 08140f6b7964 |
files | xml/en/docs/http/ngx_http_core_module.xml xml/en/docs/http/ngx_http_rewrite_module.xml xml/ru/docs/http/ngx_http_core_module.xml xml/ru/docs/http/ngx_http_rewrite_module.xml |
diffstat | 4 files changed, 33 insertions(+), 8 deletions(-) [+] |
line wrap: on
line diff
--- a/xml/en/docs/http/ngx_http_core_module.xml +++ b/xml/en/docs/http/ngx_http_core_module.xml @@ -10,7 +10,7 @@ <module name="Module ngx_http_core_module" link="/en/docs/http/ngx_http_core_module.html" lang="en" - rev="3"> + rev="4"> <section id="directives" name="Directives"> @@ -774,6 +774,14 @@ location /404.html { internal; } </example> +<note> +There is a limit of 10 internal redirects per request to prevent +request processing cycles that can occur in incorrect configurations. +If this limit is reached, the error +<http-status code="500" text="Internal Server Error"/> is returned. +In such cases, the “rewrite or internal redirection cycle” message +can be seen in the error log. +</note> </para> </directive> @@ -1835,6 +1843,8 @@ FreeBSD 7 needs to be Enables or disables doing several redirects using the <link id="error_page"/> directive. +There is a <link doc="ngx_http_core_module.xml" id="internal"> +limit</link> on a number of such redirects. </para> </directive>
--- a/xml/en/docs/http/ngx_http_rewrite_module.xml +++ b/xml/en/docs/http/ngx_http_rewrite_module.xml @@ -10,7 +10,7 @@ <module name="Module ngx_http_rewrite_module" link="/en/docs/http/ngx_http_rewrite_module.html" lang="en" - rev="1"> + rev="2"> <section id="summary"> @@ -38,8 +38,10 @@ a location for a request is searched; the directives of this module specified in the selected <link doc="ngx_http_core_module.xml" id="location"/> are processed, and if they changed a URI, a new location is searched for the new URI. -This cycle may be repeated up to 10 times after which the error -<http-status code="500" text="Internal Server Error"/> is returned. +This cycle may be repeated up to +<link doc="ngx_http_core_module.xml" id="internal">10 times</link> +after which the error <http-status code="500" text="Internal Server Error"/> +is returned. </listitem> </list>
--- a/xml/ru/docs/http/ngx_http_core_module.xml +++ b/xml/ru/docs/http/ngx_http_core_module.xml @@ -10,7 +10,7 @@ <module name="Модуль ngx_http_core_module" link="/ru/docs/http/ngx_http_core_module.html" lang="ru" - rev="3"> + rev="4"> <section id="directives" name="Директивы"> @@ -759,6 +759,15 @@ location /404.html { internal; } </example> +<note> +Для предотвращения зацикливания, которое может возникнуть при +использовании некорректных конфигураций, количество внутренних +перенаправлений ограничено десятью. +По достижении этого ограничения будет возвращена ошибка +<http-status code="500" text="Internal Server Error"/>. +В таком случае в лог-файле ошибок можно увидеть сообщение +“rewrite or internal redirection cycle”. +</note> </para> </directive> @@ -1819,6 +1828,8 @@ open_file_cache_events on; <para> Разрешает или запрещает делать несколько перенаправлений через директиву <link id="error_page"/>. +Количество таких перенаправлений +<link doc="ngx_http_core_module.xml" id="internal">ограничено</link>. </para> </directive>
--- a/xml/ru/docs/http/ngx_http_rewrite_module.xml +++ b/xml/ru/docs/http/ngx_http_rewrite_module.xml @@ -10,7 +10,7 @@ <module name="Модуль ngx_http_rewrite_module" link="/ru/docs/http/ngx_http_rewrite_module.html" lang="ru" - rev="1"> + rev="2"> <section id="summary"> @@ -38,8 +38,10 @@ выполняются директивы этого модуля, описанные в выбранном <link doc="ngx_http_core_module.xml" id="location"/>, и если они изменяли URI, то ищется новый location для уже нового URI. -Этот цикл может повторяться до 10 раз, после чего возвращается -ошибка <http-status code="500" text="Internal Server Error"/>. +Этот цикл может повторяться до +<link doc="ngx_http_core_module.xml" id="internal">10 раз</link>, +после чего возвращается ошибка +<http-status code="500" text="Internal Server Error"/>. </listitem> </list>