Mercurial > hg > nginx-site
diff xml/ru/docs/http/ngx_http_perl_module.xml @ 966:95c3c3bbf1ce
Text review.
author | Egor Nikitin <yegor.nikitin@gmail.com> |
---|---|
date | Wed, 14 Aug 2013 12:03:41 +0400 |
parents | f0e3d07c66d8 |
children | ac1b01d37929 |
line wrap: on
line diff
--- a/xml/ru/docs/http/ngx_http_perl_module.xml Wed Aug 14 17:21:19 2013 +0400 +++ b/xml/ru/docs/http/ngx_http_perl_module.xml Wed Aug 14 12:03:41 2013 +0400 @@ -39,11 +39,11 @@ </para> <para> -Для того, чтобы во время переконфигурации Perl перекомпилировал +Для того чтобы во время переконфигурации Perl перекомпилировал изменённые модули, его нужно собрать с параметрами <literal>-Dusemultiplicity=yes</literal> или <literal>-Dusethreads=yes</literal>. -Кроме того, чтобы во время работы Perl меньше терял память, +Кроме того, чтобы во время работы Perl терял меньше памяти, его нужно собрать с параметром <literal>-Dusemymalloc=no</literal>. Узнать значения этих параметров у уже собранного @@ -59,7 +59,7 @@ Необходимо учитывать, что после пересборки Perl с новыми параметрами <literal>-Dusemultiplicity=yes</literal> или <literal>-Dusethreads=yes</literal> -придётся также пересобрать и все бинарные модули Perl — они +придётся также пересобрать и все бинарные модули Perl, так как они просто перестанут работать с новым Perl. </para> @@ -89,8 +89,8 @@ имеют только текстовое значение, причём само значение хранится в памяти, выделяемой не Perl, а nginx из собственных пулов. Это позволяет уменьшить число операций копирования в большинстве случаев, -однако в некоторых ситуациях это приводит к ошибке, -например, при попытке использования таких значений в численном контексте +однако в некоторых ситуациях это приводит к ошибке. +Например, при попытке использования таких значений в числовом контексте рабочий процесс выходит с ошибкой (FreeBSD): <example> nginx in realloc(): warning: pointer to wrong page @@ -103,7 +103,7 @@ Out of memory! Callback called exit. </example> -Обход такой ситуации простой — нужно присвоить значение метода +Обойти такую ситуацию просто: нужно присвоить значение метода переменной, например, такой код <example> my $i = $r->variable('counter') + 1; @@ -117,14 +117,14 @@ <note> Так как строки внутри nginx в большинстве случаев хранятся без -завершающего нуля, то они в таком же виде возвращаются методами +завершающего нуля, то они в таком же виде возвращаются и методами объекта запроса <literal>$r</literal> (исключения составляют методы <literal>$r->filename</literal> и <literal>$r->request_body_file</literal>). Поэтому такие значения нельзя использовать -в качестве имени файла и тому подобном. -Обход такой же, как и предыдущей ситуации — присвоение значения +в качестве имени файла и тому подобного. +Обойти это можно так же, как в предыдущей ситуации: присвоив значение переменной (при этом происходит копирование данных и добавление необходимого -нуля) или же использование в выражении, например: +нуля) или же использовав его в выражении, например: <example> open FILE, '/path/' . $r->variable('name'); </example> @@ -285,7 +285,7 @@ </tag-name> <tag-desc> возвращает 0, если в запросе нет тела. -Если же тело запроса есть, то устанавливается +Если же в запросе есть тело, то устанавливается указанный обработчик и возвращается 1. По окончании чтения тела запроса nginx вызовет установленный обработчик. Обратите внимание, что нужно передавать ссылку на функцию обработчика. @@ -383,7 +383,7 @@ <tag-desc> возвращает тело запроса клиента при условии, что тело не записано во временный файл. -Для того, чтобы тело запроса клиента гарантированно находилось в памяти, +Для того чтобы тело запроса клиента гарантированно находилось в памяти, нужно ограничить его размер с помощью <link doc="ngx_http_core_module.xml" id="client_max_body_size"/> и задать достаточной размер для буфера @@ -394,7 +394,7 @@ <tag-desc> возвращает имя файла, в котором хранится тело запроса клиента. По завершению обработки файл необходимо удалить. -Для того, чтобы тело запроса клиента всегда записывалось в файл, +Для того чтобы тело запроса клиента всегда записывалось в файл, следует включить <link doc="ngx_http_core_module.xml" id="client_body_in_file_only"/>. </tag-desc>