Mercurial > hg > nginx-site
changeset 760:f0e3d07c66d8
Documented $r->log_error method, redirection limitation, removed outdated info.
author | Vladimir Homutov <vl@nginx.com> |
---|---|
date | Mon, 12 Nov 2012 07:45:20 +0000 |
parents | 1f58eb09aa8c |
children | 84740807c806 |
files | xml/en/docs/http/ngx_http_perl_module.xml xml/ru/docs/http/ngx_http_perl_module.xml |
diffstat | 2 files changed, 26 insertions(+), 17 deletions(-) [+] |
line wrap: on
line diff
--- a/xml/en/docs/http/ngx_http_perl_module.xml +++ b/xml/en/docs/http/ngx_http_perl_module.xml @@ -10,7 +10,7 @@ <module name="Module ngx_http_perl_module" link="/en/docs/http/ngx_http_perl_module.html" lang="en" - rev="1"> + rev="2"> <section id="summary"> @@ -359,6 +359,18 @@ sets a value for the specified response <tag-desc> does an internal redirect to the specified <value>uri</value>. An actual redirect happens after the Perl handler has completed. +<note> +Redirections to named locations are not currently supported. +</note> +</tag-desc> + +<tag-name><literal>$r->log_error(<value>errno</value>, +<value>message</value>)</literal></tag-name> +<tag-desc> +writes the specified <value>message</value> into the +<link doc="../ngx_core_module.xml" id="error_log"/>. +If <value>errno</value> is non-zero, an error code and its description +will be appended to the message. </tag-desc> <tag-name><literal>$r->print(<value>text</value>, ...)</literal></tag-name> @@ -412,13 +424,6 @@ Optional parameters specify an initial offset and length of data to be transmitted. The actual data transmission happens after the Perl handler has completed. -It should be noted that when using this method in a subrequest, -and <link doc="ngx_http_core_module.xml" id="sendfile"/> -is enabled, the file content will not be passed through the -<link doc="ngx_http_gzip_module.xml">gzip</link>, -<link doc="ngx_http_ssi_module.xml">SSI</link>, and -<link doc="ngx_http_charset_module.xml">charset</link> -filters. </tag-desc> <tag-name>
--- a/xml/ru/docs/http/ngx_http_perl_module.xml +++ b/xml/ru/docs/http/ngx_http_perl_module.xml @@ -10,7 +10,7 @@ <module name="Модуль ngx_http_perl_module" link="/ru/docs/http/ngx_http_perl_module.html" lang="ru" - rev="1"> + rev="2"> <section id="summary"> @@ -360,6 +360,18 @@ 1; <tag-desc> делает внутреннее перенаправление на указанный <value>uri</value>. Перенаправление происходит уже после завершения обработчика Perl. +<note> +На данный момент перенаправления в именованные location’ы не поддерживаются. +</note> +</tag-desc> + +<tag-name><literal>$r->log_error(<value>код_ошибки</value>, +<value>сообщение</value>)</literal></tag-name> +<tag-desc> +записывает указанное <value>сообщение</value> в +<link doc="../ngx_core_module.xml" id="error_log"/>. +Если <value>код_ошибки</value> ненулевой, то к сообщению будет добавлен +код ошибки и её описание. </tag-desc> <tag-name><literal>$r->print(<value>текст</value>, ...)</literal></tag-name> @@ -413,14 +425,6 @@ 1; задают начальное смещение и длину передаваемых данных. Непосредственно передача данных происходит уже после завершения обработчика Perl. -Необходимо учитывать, что при использовании -этого метода в подзапросе и включённой директиве -<link doc="ngx_http_core_module.xml" id="sendfile"/> -содержимое файла не будет проходить через -<link doc="ngx_http_gzip_module.xml">gzip</link>, -<link doc="ngx_http_ssi_module.xml">SSI</link> и -<link doc="ngx_http_charset_module.xml">charset</link> -фильтры. </tag-desc> <tag-name>