nginx-site: xml/ru/docs/http/ngx_http_perl

annotate xml/ru/docs/http/ngx_http_perl_module.xml @ 1580:c711a8a1a8f9

Changed ID from "bugs" to "issues" for http/2, perl, spdy.

author	Yaroslav Zhuravlev <yar@nginx.com>
date	Sat, 03 Oct 2015 16:08:24 +0300
parents	31f21c7956dd
children	c3f411040d24

rev	line source
222 bfe3eff81d04 Removed redundant encoding specification. Ruslan Ermilov <ru@nginx.com> parents: 110 diff changeset	1 <?xml version="1.0"?>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2
580 be54c443235a Added copyright markers to documentation sources. Ruslan Ermilov <ru@nginx.com> parents: 415 diff changeset	3 <!--
be54c443235a Added copyright markers to documentation sources. Ruslan Ermilov <ru@nginx.com> parents: 415 diff changeset	4 Copyright (C) Igor Sysoev
be54c443235a Added copyright markers to documentation sources. Ruslan Ermilov <ru@nginx.com> parents: 415 diff changeset	5 Copyright (C) Nginx, Inc.
be54c443235a Added copyright markers to documentation sources. Ruslan Ermilov <ru@nginx.com> parents: 415 diff changeset	6 -->
be54c443235a Added copyright markers to documentation sources. Ruslan Ermilov <ru@nginx.com> parents: 415 diff changeset	7
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	8 <!DOCTYPE module SYSTEM "../../../../dtd/module.dtd">
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	9
415 c640e00858ed Revision. Ruslan Ermilov <ru@nginx.com> parents: 304 diff changeset	10 <module name="Модуль ngx_http_perl_module"
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	11 link="/ru/docs/http/ngx_http_perl_module.html"
589 764fbac1b8b4 Added document revision. Ruslan Ermilov <ru@nginx.com> parents: 580 diff changeset	12 lang="ru"
1580 c711a8a1a8f9 Changed ID from "bugs" to "issues" for http/2, perl, spdy. Yaroslav Zhuravlev <yar@nginx.com> parents: 1578 diff changeset	13 rev="5">
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	14
110 40eec261c2a6 Added proper support for anonymous sections, notably for the summary. Ruslan Ermilov <ru@nginx.com> parents: 106 diff changeset	15 <section id="summary">
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	16
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	17 <para>
415 c640e00858ed Revision. Ruslan Ermilov <ru@nginx.com> parents: 304 diff changeset	18 Модуль <literal>ngx_http_perl_module</literal> позволяет писать обработчики
c640e00858ed Revision. Ruslan Ermilov <ru@nginx.com> parents: 304 diff changeset	19 location и переменных на Perl, а также вставлять вызовы Perl в SSI.
c640e00858ed Revision. Ruslan Ermilov <ru@nginx.com> parents: 304 diff changeset	20 </para>
c640e00858ed Revision. Ruslan Ermilov <ru@nginx.com> parents: 304 diff changeset	21
c640e00858ed Revision. Ruslan Ermilov <ru@nginx.com> parents: 304 diff changeset	22 <para>
c640e00858ed Revision. Ruslan Ermilov <ru@nginx.com> parents: 304 diff changeset	23 По умолчанию этот модуль не собирается, его сборку необходимо
c640e00858ed Revision. Ruslan Ermilov <ru@nginx.com> parents: 304 diff changeset	24 разрешить с помощью конфигурационного параметра
c640e00858ed Revision. Ruslan Ermilov <ru@nginx.com> parents: 304 diff changeset	25 <literal>--with-http_perl_module</literal>.
c640e00858ed Revision. Ruslan Ermilov <ru@nginx.com> parents: 304 diff changeset	26 <note>
c640e00858ed Revision. Ruslan Ermilov <ru@nginx.com> parents: 304 diff changeset	27 Для сборки этого модуля необходим Perl версии 5.6.1 и выше.
c640e00858ed Revision. Ruslan Ermilov <ru@nginx.com> parents: 304 diff changeset	28 Компилятор C должен быть совместим с тем, которым был собран Perl.
c640e00858ed Revision. Ruslan Ermilov <ru@nginx.com> parents: 304 diff changeset	29 </note>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	30 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	31
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	32 </section>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	33
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	34
1580 c711a8a1a8f9 Changed ID from "bugs" to "issues" for http/2, perl, spdy. Yaroslav Zhuravlev <yar@nginx.com> parents: 1578 diff changeset	35 <section id="issues" name="Известные проблемы">
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	36
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	37 <para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	38 Модуль экспериментальный, поэтому возможно всё.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	39 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	40
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	41 <para>
966 95c3c3bbf1ce Text review. Egor Nikitin <yegor.nikitin@gmail.com> parents: 760 diff changeset	42 Для того чтобы во время переконфигурации Perl перекомпилировал
415 c640e00858ed Revision. Ruslan Ermilov <ru@nginx.com> parents: 304 diff changeset	43 изменённые модули, его нужно собрать с параметрами
c640e00858ed Revision. Ruslan Ermilov <ru@nginx.com> parents: 304 diff changeset	44 <literal>-Dusemultiplicity=yes</literal> или
c640e00858ed Revision. Ruslan Ermilov <ru@nginx.com> parents: 304 diff changeset	45 <literal>-Dusethreads=yes</literal>.
966 95c3c3bbf1ce Text review. Egor Nikitin <yegor.nikitin@gmail.com> parents: 760 diff changeset	46 Кроме того, чтобы во время работы Perl терял меньше памяти,
415 c640e00858ed Revision. Ruslan Ermilov <ru@nginx.com> parents: 304 diff changeset	47 его нужно собрать с параметром
c640e00858ed Revision. Ruslan Ermilov <ru@nginx.com> parents: 304 diff changeset	48 <literal>-Dusemymalloc=no</literal>.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	49 Узнать значения этих параметров у уже собранного
415 c640e00858ed Revision. Ruslan Ermilov <ru@nginx.com> parents: 304 diff changeset	50 Perl можно так (в примере приведены желаемые значения параметров):
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	51 <example>
415 c640e00858ed Revision. Ruslan Ermilov <ru@nginx.com> parents: 304 diff changeset	52 $ perl -V:usemultiplicity -V:usemymalloc
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	53 usemultiplicity='define';
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	54 usemymalloc='n';
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	55 </example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	56 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	57
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	58 <para>
415 c640e00858ed Revision. Ruslan Ermilov <ru@nginx.com> parents: 304 diff changeset	59 Необходимо учитывать, что после пересборки Perl с новыми параметрами
c640e00858ed Revision. Ruslan Ermilov <ru@nginx.com> parents: 304 diff changeset	60 <literal>-Dusemultiplicity=yes</literal> или
c640e00858ed Revision. Ruslan Ermilov <ru@nginx.com> parents: 304 diff changeset	61 <literal>-Dusethreads=yes</literal>
966 95c3c3bbf1ce Text review. Egor Nikitin <yegor.nikitin@gmail.com> parents: 760 diff changeset	62 придётся также пересобрать и все бинарные модули Perl, так как они
415 c640e00858ed Revision. Ruslan Ermilov <ru@nginx.com> parents: 304 diff changeset	63 просто перестанут работать с новым Perl.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	64 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	65
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	66 <para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	67 Возможно, основной процесс, а вслед за ним и рабочие процессы,
415 c640e00858ed Revision. Ruslan Ermilov <ru@nginx.com> parents: 304 diff changeset	68 будут увеличиваться в размерах при каждой переконфигурации.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	69 Когда основной процесс вырастет до неприемлемых размеров, можно
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	70 воспользоваться процедурой
415 c640e00858ed Revision. Ruslan Ermilov <ru@nginx.com> parents: 304 diff changeset	71 <link doc="../control.xml" id="upgrade">обновления сервера на лету</link>,
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	72 не меняя при этом сам исполняемый файл.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	73 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	74
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	75 <para>
415 c640e00858ed Revision. Ruslan Ermilov <ru@nginx.com> parents: 304 diff changeset	76 Если модуль Perl выполняет длительную операцию, например, определяет
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	77 адрес по имени, соединяется с другим сервером, делает запрос к базе данных,
415 c640e00858ed Revision. Ruslan Ermilov <ru@nginx.com> parents: 304 diff changeset	78 то на это время все остальные запросы, обслуживаемые данным рабочим процессом,
c640e00858ed Revision. Ruslan Ermilov <ru@nginx.com> parents: 304 diff changeset	79 не будут обрабатываться. Поэтому рекомендуется ограничиться операциями,
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	80 время исполнения которых короткое и предсказуемое, например, обращение
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	81 к локальной файловой системе.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	82 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	83
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	84 </section>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	85
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	86
415 c640e00858ed Revision. Ruslan Ermilov <ru@nginx.com> parents: 304 diff changeset	87 <section id="example" name="Пример конфигурации">
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	88
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	89 <para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	90 <example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	91 http {
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	92
415 c640e00858ed Revision. Ruslan Ermilov <ru@nginx.com> parents: 304 diff changeset	93 perl_modules perl/lib;
c640e00858ed Revision. Ruslan Ermilov <ru@nginx.com> parents: 304 diff changeset	94 perl_require hello.pm;
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	95
415 c640e00858ed Revision. Ruslan Ermilov <ru@nginx.com> parents: 304 diff changeset	96 perl_set $msie6 '
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	97
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	98 sub {
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	99 my $r = shift;
415 c640e00858ed Revision. Ruslan Ermilov <ru@nginx.com> parents: 304 diff changeset	100 my $ua = $r->header_in("User-Agent");
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	101
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	102 return "" if $ua =~ /Opera/;
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	103 return "1" if $ua =~ / MSIE [6-9]\.\d+/;
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	104 return "";
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	105 }
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	106
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	107 ';
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	108
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	109 server {
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	110 location / {
415 c640e00858ed Revision. Ruslan Ermilov <ru@nginx.com> parents: 304 diff changeset	111 perl hello::handler;
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	112 }
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	113 }
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	114 </example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	115 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	116
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	117 <para>
415 c640e00858ed Revision. Ruslan Ermilov <ru@nginx.com> parents: 304 diff changeset	118 Модуль <path>perl/lib/hello.pm</path>:
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	119 <example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	120 package hello;
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	121
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	122 use nginx;
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	123
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	124 sub handler {
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	125 my $r = shift;
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	126
415 c640e00858ed Revision. Ruslan Ermilov <ru@nginx.com> parents: 304 diff changeset	127 $r->send_http_header("text/html");
c640e00858ed Revision. Ruslan Ermilov <ru@nginx.com> parents: 304 diff changeset	128 return OK if $r->header_only;
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	129
415 c640e00858ed Revision. Ruslan Ermilov <ru@nginx.com> parents: 304 diff changeset	130 $r->print("hello!\n<br/>");
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	131
415 c640e00858ed Revision. Ruslan Ermilov <ru@nginx.com> parents: 304 diff changeset	132 if (-f $r->filename or -d _) {
c640e00858ed Revision. Ruslan Ermilov <ru@nginx.com> parents: 304 diff changeset	133 $r->print($r->uri, " exists!\n");
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	134 }
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	135
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	136 return OK;
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	137 }
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	138
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	139 1;
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	140 __END__
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	141 </example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	142 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	143
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	144 </section>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	145
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	146
415 c640e00858ed Revision. Ruslan Ermilov <ru@nginx.com> parents: 304 diff changeset	147 <section id="directives" name="Директивы">
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	148
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	149 <directive name="perl">
415 c640e00858ed Revision. Ruslan Ermilov <ru@nginx.com> parents: 304 diff changeset	150 <syntax><value>модуль</value>::<value>функция</value>\|'sub { ... }'</syntax>
99 1d315ef37215 The case <default/> is now language-agnostic. Ruslan Ermilov <ru@nginx.com> parents: 79 diff changeset	151 <default/>
415 c640e00858ed Revision. Ruslan Ermilov <ru@nginx.com> parents: 304 diff changeset	152 <context>location</context>
c640e00858ed Revision. Ruslan Ermilov <ru@nginx.com> parents: 304 diff changeset	153 <context>limit_except</context>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	154
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	155 <para>
415 c640e00858ed Revision. Ruslan Ermilov <ru@nginx.com> parents: 304 diff changeset	156 Устанавливает обработчик Perl для данного location.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	157 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	158
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	159 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	160
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	161
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	162 <directive name="perl_modules">
102 c76a257f3fd4 The directive name is now automatically printed in <default> and <syntax>. Ruslan Ermilov <ru@nginx.com> parents: 99 diff changeset	163 <syntax><value>путь</value></syntax>
99 1d315ef37215 The case <default/> is now language-agnostic. Ruslan Ermilov <ru@nginx.com> parents: 79 diff changeset	164 <default/>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	165 <context>http</context>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	166
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	167 <para>
415 c640e00858ed Revision. Ruslan Ermilov <ru@nginx.com> parents: 304 diff changeset	168 Задаёт дополнительный путь для модулей Perl.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	169 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	170
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	171 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	172
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	173
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	174 <directive name="perl_require">
102 c76a257f3fd4 The directive name is now automatically printed in <default> and <syntax>. Ruslan Ermilov <ru@nginx.com> parents: 99 diff changeset	175 <syntax><value>модуль</value></syntax>
99 1d315ef37215 The case <default/> is now language-agnostic. Ruslan Ermilov <ru@nginx.com> parents: 79 diff changeset	176 <default/>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	177 <context>http</context>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	178
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	179 <para>
415 c640e00858ed Revision. Ruslan Ermilov <ru@nginx.com> parents: 304 diff changeset	180 Задаёт имя модуля, который будет подгружаться при каждой
c640e00858ed Revision. Ruslan Ermilov <ru@nginx.com> parents: 304 diff changeset	181 переконфигурации.
c640e00858ed Revision. Ruslan Ermilov <ru@nginx.com> parents: 304 diff changeset	182 Директив <literal>perl_require</literal> может быть несколько.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	183 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	184
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	185 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	186
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	187
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	188 <directive name="perl_set">
415 c640e00858ed Revision. Ruslan Ermilov <ru@nginx.com> parents: 304 diff changeset	189 <syntax>
c640e00858ed Revision. Ruslan Ermilov <ru@nginx.com> parents: 304 diff changeset	190 <value>$переменная</value>
c640e00858ed Revision. Ruslan Ermilov <ru@nginx.com> parents: 304 diff changeset	191 <value>модуль</value>::<value>функция</value>\|'sub { ... }'</syntax>
99 1d315ef37215 The case <default/> is now language-agnostic. Ruslan Ermilov <ru@nginx.com> parents: 79 diff changeset	192 <default/>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	193 <context>http</context>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	194
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	195 <para>
415 c640e00858ed Revision. Ruslan Ermilov <ru@nginx.com> parents: 304 diff changeset	196 Устанавливает обработчик Perl для указанной переменной.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	197 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	198
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	199 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	200
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	201 </section>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	202
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	203
415 c640e00858ed Revision. Ruslan Ermilov <ru@nginx.com> parents: 304 diff changeset	204 <section id="ssi" name="Вызов Perl из SSI">
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	205
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	206 <para>
415 c640e00858ed Revision. Ruslan Ermilov <ru@nginx.com> parents: 304 diff changeset	207 Формат команды SSI с вызовом Perl следующий:
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	208 <example>
415 c640e00858ed Revision. Ruslan Ermilov <ru@nginx.com> parents: 304 diff changeset	209 <!--# perl sub="<value>модуль</value>::<value>функция</value>" arg="<value>параметр1</value>" arg="<value>параметр2</value>" ...
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	210 -->
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	211 </example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	212 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	213
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	214 </section>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	215
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	216
415 c640e00858ed Revision. Ruslan Ermilov <ru@nginx.com> parents: 304 diff changeset	217 <section id="methods" name="Методы объекта запроса $r">
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	218
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	219 <para>
415 c640e00858ed Revision. Ruslan Ermilov <ru@nginx.com> parents: 304 diff changeset	220 <list type="tag">
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	221
415 c640e00858ed Revision. Ruslan Ermilov <ru@nginx.com> parents: 304 diff changeset	222 <tag-name><literal>$r->args</literal></tag-name>
c640e00858ed Revision. Ruslan Ermilov <ru@nginx.com> parents: 304 diff changeset	223 <tag-desc>
c640e00858ed Revision. Ruslan Ermilov <ru@nginx.com> parents: 304 diff changeset	224 возвращает аргументы запроса.
c640e00858ed Revision. Ruslan Ermilov <ru@nginx.com> parents: 304 diff changeset	225 </tag-desc>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	226
415 c640e00858ed Revision. Ruslan Ermilov <ru@nginx.com> parents: 304 diff changeset	227 <tag-name><literal>$r->filename</literal></tag-name>
c640e00858ed Revision. Ruslan Ermilov <ru@nginx.com> parents: 304 diff changeset	228 <tag-desc>
c640e00858ed Revision. Ruslan Ermilov <ru@nginx.com> parents: 304 diff changeset	229 возвращает имя файла, соответствующее URI запроса.
c640e00858ed Revision. Ruslan Ermilov <ru@nginx.com> parents: 304 diff changeset	230 </tag-desc>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	231
415 c640e00858ed Revision. Ruslan Ermilov <ru@nginx.com> parents: 304 diff changeset	232 <tag-name>
c640e00858ed Revision. Ruslan Ermilov <ru@nginx.com> parents: 304 diff changeset	233 <literal>$r->has_request_body(<value>обработчик</value>)</literal>
c640e00858ed Revision. Ruslan Ermilov <ru@nginx.com> parents: 304 diff changeset	234 </tag-name>
c640e00858ed Revision. Ruslan Ermilov <ru@nginx.com> parents: 304 diff changeset	235 <tag-desc>
c640e00858ed Revision. Ruslan Ermilov <ru@nginx.com> parents: 304 diff changeset	236 возвращает 0, если в запросе нет тела.
966 95c3c3bbf1ce Text review. Egor Nikitin <yegor.nikitin@gmail.com> parents: 760 diff changeset	237 Если же в запросе есть тело, то устанавливается
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	238 указанный обработчик и возвращается 1.
415 c640e00858ed Revision. Ruslan Ermilov <ru@nginx.com> parents: 304 diff changeset	239 По окончании чтения тела запроса nginx вызовет установленный обработчик.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	240 Обратите внимание, что нужно передавать ссылку на функцию обработчика.
415 c640e00858ed Revision. Ruslan Ermilov <ru@nginx.com> parents: 304 diff changeset	241 Пример:
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	242 <example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	243 package hello;
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	244
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	245 use nginx;
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	246
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	247 sub handler {
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	248 my $r = shift;
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	249
415 c640e00858ed Revision. Ruslan Ermilov <ru@nginx.com> parents: 304 diff changeset	250 if ($r->request_method ne "POST") {
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	251 return DECLINED;
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	252 }
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	253
415 c640e00858ed Revision. Ruslan Ermilov <ru@nginx.com> parents: 304 diff changeset	254 if ($r->has_request_body(<emphasis>\&post</emphasis>)) {
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	255 return OK;
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	256 }
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	257
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	258 return HTTP_BAD_REQUEST;
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	259 }
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	260
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	261 sub <emphasis>post</emphasis> {
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	262 my $r = shift;
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	263
415 c640e00858ed Revision. Ruslan Ermilov <ru@nginx.com> parents: 304 diff changeset	264 $r->send_http_header;
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	265
415 c640e00858ed Revision. Ruslan Ermilov <ru@nginx.com> parents: 304 diff changeset	266 $r->print("request_body: \"", $r->request_body, "\"<br/>");
c640e00858ed Revision. Ruslan Ermilov <ru@nginx.com> parents: 304 diff changeset	267 $r->print("request_body_file: \"", $r->request_body_file, "\"<br/>\n");
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	268
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	269 return OK;
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	270 }
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	271
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	272 1;
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	273
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	274 __END__
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	275 </example>
415 c640e00858ed Revision. Ruslan Ermilov <ru@nginx.com> parents: 304 diff changeset	276 </tag-desc>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	277
415 c640e00858ed Revision. Ruslan Ermilov <ru@nginx.com> parents: 304 diff changeset	278 <tag-name><literal>$r->allow_ranges</literal></tag-name>
c640e00858ed Revision. Ruslan Ermilov <ru@nginx.com> parents: 304 diff changeset	279 <tag-desc>
c640e00858ed Revision. Ruslan Ermilov <ru@nginx.com> parents: 304 diff changeset	280 разрешает использовать диапазоны байт (byte ranges) при передаче ответа.
c640e00858ed Revision. Ruslan Ermilov <ru@nginx.com> parents: 304 diff changeset	281 </tag-desc>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	282
415 c640e00858ed Revision. Ruslan Ermilov <ru@nginx.com> parents: 304 diff changeset	283 <tag-name><literal>$r->discard_request_body</literal></tag-name>
c640e00858ed Revision. Ruslan Ermilov <ru@nginx.com> parents: 304 diff changeset	284 <tag-desc>
c640e00858ed Revision. Ruslan Ermilov <ru@nginx.com> parents: 304 diff changeset	285 указывает nginx игнорировать тело запроса.
c640e00858ed Revision. Ruslan Ermilov <ru@nginx.com> parents: 304 diff changeset	286 </tag-desc>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	287
415 c640e00858ed Revision. Ruslan Ermilov <ru@nginx.com> parents: 304 diff changeset	288 <tag-name><literal>$r->header_in(<value>поле</value>)</literal></tag-name>
c640e00858ed Revision. Ruslan Ermilov <ru@nginx.com> parents: 304 diff changeset	289 <tag-desc>
c640e00858ed Revision. Ruslan Ermilov <ru@nginx.com> parents: 304 diff changeset	290 возвращает значение заданного поля в заголовке запроса клиента.
c640e00858ed Revision. Ruslan Ermilov <ru@nginx.com> parents: 304 diff changeset	291 </tag-desc>
c640e00858ed Revision. Ruslan Ermilov <ru@nginx.com> parents: 304 diff changeset	292
c640e00858ed Revision. Ruslan Ermilov <ru@nginx.com> parents: 304 diff changeset	293 <tag-name><literal>$r->header_only</literal></tag-name>
c640e00858ed Revision. Ruslan Ermilov <ru@nginx.com> parents: 304 diff changeset	294 <tag-desc>
c640e00858ed Revision. Ruslan Ermilov <ru@nginx.com> parents: 304 diff changeset	295 определяет, нужно ли передавать клиенту только заголовок ответа или весь ответ.
c640e00858ed Revision. Ruslan Ermilov <ru@nginx.com> parents: 304 diff changeset	296 </tag-desc>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	297
415 c640e00858ed Revision. Ruslan Ermilov <ru@nginx.com> parents: 304 diff changeset	298 <tag-name>
c640e00858ed Revision. Ruslan Ermilov <ru@nginx.com> parents: 304 diff changeset	299 <literal>$r->header_out(<value>поле</value>,
c640e00858ed Revision. Ruslan Ermilov <ru@nginx.com> parents: 304 diff changeset	300 <value>значение</value>)</literal>
c640e00858ed Revision. Ruslan Ermilov <ru@nginx.com> parents: 304 diff changeset	301 </tag-name>
c640e00858ed Revision. Ruslan Ermilov <ru@nginx.com> parents: 304 diff changeset	302 <tag-desc>
c640e00858ed Revision. Ruslan Ermilov <ru@nginx.com> parents: 304 diff changeset	303 устанавливает значение для заданного поля в заголовке ответа.
c640e00858ed Revision. Ruslan Ermilov <ru@nginx.com> parents: 304 diff changeset	304 </tag-desc>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	305
415 c640e00858ed Revision. Ruslan Ermilov <ru@nginx.com> parents: 304 diff changeset	306 <tag-name>
c640e00858ed Revision. Ruslan Ermilov <ru@nginx.com> parents: 304 diff changeset	307 <literal>$r->internal_redirect(<value>uri</value>)</literal>
c640e00858ed Revision. Ruslan Ermilov <ru@nginx.com> parents: 304 diff changeset	308 </tag-name>
c640e00858ed Revision. Ruslan Ermilov <ru@nginx.com> parents: 304 diff changeset	309 <tag-desc>
c640e00858ed Revision. Ruslan Ermilov <ru@nginx.com> parents: 304 diff changeset	310 делает внутреннее перенаправление на указанный <value>uri</value>.
c640e00858ed Revision. Ruslan Ermilov <ru@nginx.com> parents: 304 diff changeset	311 Перенаправление происходит уже после завершения обработчика Perl.
760 f0e3d07c66d8 Documented $r->log_error method, redirection limitation, removed outdated info. Vladimir Homutov <vl@nginx.com> parents: 589 diff changeset	312 <note>
f0e3d07c66d8 Documented $r->log_error method, redirection limitation, removed outdated info. Vladimir Homutov <vl@nginx.com> parents: 589 diff changeset	313 На данный момент перенаправления в именованные location’ы не поддерживаются.
f0e3d07c66d8 Documented $r->log_error method, redirection limitation, removed outdated info. Vladimir Homutov <vl@nginx.com> parents: 589 diff changeset	314 </note>
f0e3d07c66d8 Documented $r->log_error method, redirection limitation, removed outdated info. Vladimir Homutov <vl@nginx.com> parents: 589 diff changeset	315 </tag-desc>
f0e3d07c66d8 Documented $r->log_error method, redirection limitation, removed outdated info. Vladimir Homutov <vl@nginx.com> parents: 589 diff changeset	316
f0e3d07c66d8 Documented $r->log_error method, redirection limitation, removed outdated info. Vladimir Homutov <vl@nginx.com> parents: 589 diff changeset	317 <tag-name><literal>$r->log_error(<value>код_ошибки</value>,
f0e3d07c66d8 Documented $r->log_error method, redirection limitation, removed outdated info. Vladimir Homutov <vl@nginx.com> parents: 589 diff changeset	318 <value>сообщение</value>)</literal></tag-name>
f0e3d07c66d8 Documented $r->log_error method, redirection limitation, removed outdated info. Vladimir Homutov <vl@nginx.com> parents: 589 diff changeset	319 <tag-desc>
f0e3d07c66d8 Documented $r->log_error method, redirection limitation, removed outdated info. Vladimir Homutov <vl@nginx.com> parents: 589 diff changeset	320 записывает указанное <value>сообщение</value> в
f0e3d07c66d8 Documented $r->log_error method, redirection limitation, removed outdated info. Vladimir Homutov <vl@nginx.com> parents: 589 diff changeset	321 <link doc="../ngx_core_module.xml" id="error_log"/>.
f0e3d07c66d8 Documented $r->log_error method, redirection limitation, removed outdated info. Vladimir Homutov <vl@nginx.com> parents: 589 diff changeset	322 Если <value>код_ошибки</value> ненулевой, то к сообщению будет добавлен
f0e3d07c66d8 Documented $r->log_error method, redirection limitation, removed outdated info. Vladimir Homutov <vl@nginx.com> parents: 589 diff changeset	323 код ошибки и её описание.
415 c640e00858ed Revision. Ruslan Ermilov <ru@nginx.com> parents: 304 diff changeset	324 </tag-desc>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	325
415 c640e00858ed Revision. Ruslan Ermilov <ru@nginx.com> parents: 304 diff changeset	326 <tag-name><literal>$r->print(<value>текст</value>, ...)</literal></tag-name>
c640e00858ed Revision. Ruslan Ermilov <ru@nginx.com> parents: 304 diff changeset	327 <tag-desc>
c640e00858ed Revision. Ruslan Ermilov <ru@nginx.com> parents: 304 diff changeset	328 метод передаёт клиенту данные.
c640e00858ed Revision. Ruslan Ermilov <ru@nginx.com> parents: 304 diff changeset	329 </tag-desc>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	330
415 c640e00858ed Revision. Ruslan Ermilov <ru@nginx.com> parents: 304 diff changeset	331 <tag-name><literal>$r->request_body</literal></tag-name>
c640e00858ed Revision. Ruslan Ermilov <ru@nginx.com> parents: 304 diff changeset	332 <tag-desc>
c640e00858ed Revision. Ruslan Ermilov <ru@nginx.com> parents: 304 diff changeset	333 возвращает тело запроса клиента при условии,
c640e00858ed Revision. Ruslan Ermilov <ru@nginx.com> parents: 304 diff changeset	334 что тело не записано во временный файл.
966 95c3c3bbf1ce Text review. Egor Nikitin <yegor.nikitin@gmail.com> parents: 760 diff changeset	335 Для того чтобы тело запроса клиента гарантированно находилось в памяти,
79 0a45870d0160 Fixed cross-document links to use doc and id. Maxim Dounin <mdounin@mdounin.ru> parents: 76 diff changeset	336 нужно ограничить его размер с помощью
106 56457a474903 If text of the link is not provided, the @id is used. Ruslan Ermilov <ru@nginx.com> parents: 102 diff changeset	337 <link doc="ngx_http_core_module.xml" id="client_max_body_size"/>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	338 и задать достаточной размер для буфера
106 56457a474903 If text of the link is not provided, the @id is used. Ruslan Ermilov <ru@nginx.com> parents: 102 diff changeset	339 <link doc="ngx_http_core_module.xml" id="client_body_buffer_size"/>.
415 c640e00858ed Revision. Ruslan Ermilov <ru@nginx.com> parents: 304 diff changeset	340 </tag-desc>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	341
415 c640e00858ed Revision. Ruslan Ermilov <ru@nginx.com> parents: 304 diff changeset	342 <tag-name><literal>$r->request_body_file</literal></tag-name>
c640e00858ed Revision. Ruslan Ermilov <ru@nginx.com> parents: 304 diff changeset	343 <tag-desc>
c640e00858ed Revision. Ruslan Ermilov <ru@nginx.com> parents: 304 diff changeset	344 возвращает имя файла, в котором хранится тело запроса клиента.
c640e00858ed Revision. Ruslan Ermilov <ru@nginx.com> parents: 304 diff changeset	345 По завершению обработки файл необходимо удалить.
966 95c3c3bbf1ce Text review. Egor Nikitin <yegor.nikitin@gmail.com> parents: 760 diff changeset	346 Для того чтобы тело запроса клиента всегда записывалось в файл,
415 c640e00858ed Revision. Ruslan Ermilov <ru@nginx.com> parents: 304 diff changeset	347 следует включить
c640e00858ed Revision. Ruslan Ermilov <ru@nginx.com> parents: 304 diff changeset	348 <link doc="ngx_http_core_module.xml" id="client_body_in_file_only"/>.
c640e00858ed Revision. Ruslan Ermilov <ru@nginx.com> parents: 304 diff changeset	349 </tag-desc>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	350
415 c640e00858ed Revision. Ruslan Ermilov <ru@nginx.com> parents: 304 diff changeset	351 <tag-name><literal>$r->request_method</literal></tag-name>
c640e00858ed Revision. Ruslan Ermilov <ru@nginx.com> parents: 304 diff changeset	352 <tag-desc>
c640e00858ed Revision. Ruslan Ermilov <ru@nginx.com> parents: 304 diff changeset	353 возвращает HTTP-метод запроса клиента.
c640e00858ed Revision. Ruslan Ermilov <ru@nginx.com> parents: 304 diff changeset	354 </tag-desc>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	355
415 c640e00858ed Revision. Ruslan Ermilov <ru@nginx.com> parents: 304 diff changeset	356 <tag-name><literal>$r->remote_addr</literal></tag-name>
c640e00858ed Revision. Ruslan Ermilov <ru@nginx.com> parents: 304 diff changeset	357 <tag-desc>
c640e00858ed Revision. Ruslan Ermilov <ru@nginx.com> parents: 304 diff changeset	358 возвращает IP-адрес клиента.
c640e00858ed Revision. Ruslan Ermilov <ru@nginx.com> parents: 304 diff changeset	359 </tag-desc>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	360
415 c640e00858ed Revision. Ruslan Ermilov <ru@nginx.com> parents: 304 diff changeset	361 <tag-name><literal>$r->flush</literal></tag-name>
c640e00858ed Revision. Ruslan Ermilov <ru@nginx.com> parents: 304 diff changeset	362 <tag-desc>
c640e00858ed Revision. Ruslan Ermilov <ru@nginx.com> parents: 304 diff changeset	363 немедленно передаёт данные клиенту.
c640e00858ed Revision. Ruslan Ermilov <ru@nginx.com> parents: 304 diff changeset	364 </tag-desc>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	365
415 c640e00858ed Revision. Ruslan Ermilov <ru@nginx.com> parents: 304 diff changeset	366 <tag-name>
c640e00858ed Revision. Ruslan Ermilov <ru@nginx.com> parents: 304 diff changeset	367 <literal>$r->sendfile(<value>имя</value>[,
c640e00858ed Revision. Ruslan Ermilov <ru@nginx.com> parents: 304 diff changeset	368 <value>смещение</value>[,
c640e00858ed Revision. Ruslan Ermilov <ru@nginx.com> parents: 304 diff changeset	369 <value>длина</value>]])</literal>
c640e00858ed Revision. Ruslan Ermilov <ru@nginx.com> parents: 304 diff changeset	370 </tag-name>
c640e00858ed Revision. Ruslan Ermilov <ru@nginx.com> parents: 304 diff changeset	371 <tag-desc>
c640e00858ed Revision. Ruslan Ermilov <ru@nginx.com> parents: 304 diff changeset	372 передаёт клиенту содержимое указанного файла.
c640e00858ed Revision. Ruslan Ermilov <ru@nginx.com> parents: 304 diff changeset	373 Необязательные параметры
c640e00858ed Revision. Ruslan Ermilov <ru@nginx.com> parents: 304 diff changeset	374 задают начальное смещение и длину передаваемых данных.
c640e00858ed Revision. Ruslan Ermilov <ru@nginx.com> parents: 304 diff changeset	375 Непосредственно передача данных происходит уже после завершения
c640e00858ed Revision. Ruslan Ermilov <ru@nginx.com> parents: 304 diff changeset	376 обработчика Perl.
c640e00858ed Revision. Ruslan Ermilov <ru@nginx.com> parents: 304 diff changeset	377 </tag-desc>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	378
415 c640e00858ed Revision. Ruslan Ermilov <ru@nginx.com> parents: 304 diff changeset	379 <tag-name>
c640e00858ed Revision. Ruslan Ermilov <ru@nginx.com> parents: 304 diff changeset	380 <literal>$r->send_http_header([<value>тип</value>])</literal>
c640e00858ed Revision. Ruslan Ermilov <ru@nginx.com> parents: 304 diff changeset	381 </tag-name>
c640e00858ed Revision. Ruslan Ermilov <ru@nginx.com> parents: 304 diff changeset	382 <tag-desc>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	383 передаёт клиенту заголовок ответа.
415 c640e00858ed Revision. Ruslan Ermilov <ru@nginx.com> parents: 304 diff changeset	384 Необязательный параметр <value>тип</value> устанавливает значение поля
c640e00858ed Revision. Ruslan Ermilov <ru@nginx.com> parents: 304 diff changeset	385 <header>Content-Type</header> в заголовке ответа.
c640e00858ed Revision. Ruslan Ermilov <ru@nginx.com> parents: 304 diff changeset	386 Пустая строка в качестве типа запрещает передачу поля
c640e00858ed Revision. Ruslan Ermilov <ru@nginx.com> parents: 304 diff changeset	387 <header>Content-Type</header>.
c640e00858ed Revision. Ruslan Ermilov <ru@nginx.com> parents: 304 diff changeset	388 </tag-desc>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	389
415 c640e00858ed Revision. Ruslan Ermilov <ru@nginx.com> parents: 304 diff changeset	390 <tag-name><literal>$r->status(<value>код</value>)</literal></tag-name>
c640e00858ed Revision. Ruslan Ermilov <ru@nginx.com> parents: 304 diff changeset	391 <tag-desc>
c640e00858ed Revision. Ruslan Ermilov <ru@nginx.com> parents: 304 diff changeset	392 устанавливает код ответа.
c640e00858ed Revision. Ruslan Ermilov <ru@nginx.com> parents: 304 diff changeset	393 </tag-desc>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	394
415 c640e00858ed Revision. Ruslan Ermilov <ru@nginx.com> parents: 304 diff changeset	395 <tag-name>
c640e00858ed Revision. Ruslan Ermilov <ru@nginx.com> parents: 304 diff changeset	396 <literal>$r->sleep(<value>миллисекунды</value>,
c640e00858ed Revision. Ruslan Ermilov <ru@nginx.com> parents: 304 diff changeset	397 <value>обработчик</value>)</literal>
c640e00858ed Revision. Ruslan Ermilov <ru@nginx.com> parents: 304 diff changeset	398 </tag-name>
c640e00858ed Revision. Ruslan Ermilov <ru@nginx.com> parents: 304 diff changeset	399 <tag-desc>
c640e00858ed Revision. Ruslan Ermilov <ru@nginx.com> parents: 304 diff changeset	400 устанавливает указанный обработчик
c640e00858ed Revision. Ruslan Ermilov <ru@nginx.com> parents: 304 diff changeset	401 и останавливает обработку запроса на заданное время.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	402 nginx в это время продолжает обрабатывать другие запросы.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	403 По истечении указанного времени nginx вызовет установленный обработчик.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	404 Обратите внимание, что нужно передавать ссылку на функцию обработчика.
415 c640e00858ed Revision. Ruslan Ermilov <ru@nginx.com> parents: 304 diff changeset	405 Для передачи данных между обработчиками следует использовать
c640e00858ed Revision. Ruslan Ermilov <ru@nginx.com> parents: 304 diff changeset	406 <literal>$r->variable()</literal>.
c640e00858ed Revision. Ruslan Ermilov <ru@nginx.com> parents: 304 diff changeset	407 Пример:
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	408 <example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	409 package hello;
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	410
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	411 use nginx;
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	412
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	413 sub handler {
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	414 my $r = shift;
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	415
415 c640e00858ed Revision. Ruslan Ermilov <ru@nginx.com> parents: 304 diff changeset	416 $r->discard_request_body;
c640e00858ed Revision. Ruslan Ermilov <ru@nginx.com> parents: 304 diff changeset	417 $r->variable("var", "OK");
c640e00858ed Revision. Ruslan Ermilov <ru@nginx.com> parents: 304 diff changeset	418 $r->sleep(1000, <emphasis>\&next</emphasis>);
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	419
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	420 return OK;
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	421 }
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	422
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	423 sub <emphasis>next</emphasis> {
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	424 my $r = shift;
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	425
415 c640e00858ed Revision. Ruslan Ermilov <ru@nginx.com> parents: 304 diff changeset	426 $r->send_http_header;
c640e00858ed Revision. Ruslan Ermilov <ru@nginx.com> parents: 304 diff changeset	427 $r->print($r->variable("var"));
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	428
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	429 return OK;
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	430 }
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	431
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	432 1;
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	433
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	434 __END__
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	435 </example>
415 c640e00858ed Revision. Ruslan Ermilov <ru@nginx.com> parents: 304 diff changeset	436 </tag-desc>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	437
415 c640e00858ed Revision. Ruslan Ermilov <ru@nginx.com> parents: 304 diff changeset	438 <tag-name><literal>$r->unescape(<value>текст</value>)</literal></tag-name>
c640e00858ed Revision. Ruslan Ermilov <ru@nginx.com> parents: 304 diff changeset	439 <tag-desc>
c640e00858ed Revision. Ruslan Ermilov <ru@nginx.com> parents: 304 diff changeset	440 декодирует текст, заданный в виде “%XX”.
c640e00858ed Revision. Ruslan Ermilov <ru@nginx.com> parents: 304 diff changeset	441 </tag-desc>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	442
415 c640e00858ed Revision. Ruslan Ermilov <ru@nginx.com> parents: 304 diff changeset	443 <tag-name><literal>$r->uri</literal></tag-name>
c640e00858ed Revision. Ruslan Ermilov <ru@nginx.com> parents: 304 diff changeset	444 <tag-desc>
c640e00858ed Revision. Ruslan Ermilov <ru@nginx.com> parents: 304 diff changeset	445 возвращает URI запроса.
c640e00858ed Revision. Ruslan Ermilov <ru@nginx.com> parents: 304 diff changeset	446 </tag-desc>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	447
415 c640e00858ed Revision. Ruslan Ermilov <ru@nginx.com> parents: 304 diff changeset	448 <tag-name>
c640e00858ed Revision. Ruslan Ermilov <ru@nginx.com> parents: 304 diff changeset	449 <literal>$r->variable(<value>имя</value>[,
c640e00858ed Revision. Ruslan Ermilov <ru@nginx.com> parents: 304 diff changeset	450 <value>значение</value>])</literal>
c640e00858ed Revision. Ruslan Ermilov <ru@nginx.com> parents: 304 diff changeset	451 </tag-name>
c640e00858ed Revision. Ruslan Ermilov <ru@nginx.com> parents: 304 diff changeset	452 <tag-desc>
c640e00858ed Revision. Ruslan Ermilov <ru@nginx.com> parents: 304 diff changeset	453 возвращает или устанавливает значение указанной переменной.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	454 Переменные локальны для каждого запроса.
415 c640e00858ed Revision. Ruslan Ermilov <ru@nginx.com> parents: 304 diff changeset	455 </tag-desc>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	456
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	457 </list>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	458 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	459
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	460 </section>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	461
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	462 </module>

Mercurial > hg > nginx-site

annotate xml/ru/docs/http/ngx_http_perl_module.xml @ 1580:c711a8a1a8f9