Mercurial > hg > nginx-site
comparison xml/en/docs/http/ngx_http_perl_module.xml @ 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 | ddec437b692b |
children | 95c3c3bbf1ce |
comparison
equal
deleted
inserted
replaced
759:1f58eb09aa8c | 760:f0e3d07c66d8 |
---|---|
8 <!DOCTYPE module SYSTEM "../../../../dtd/module.dtd"> | 8 <!DOCTYPE module SYSTEM "../../../../dtd/module.dtd"> |
9 | 9 |
10 <module name="Module ngx_http_perl_module" | 10 <module name="Module ngx_http_perl_module" |
11 link="/en/docs/http/ngx_http_perl_module.html" | 11 link="/en/docs/http/ngx_http_perl_module.html" |
12 lang="en" | 12 lang="en" |
13 rev="1"> | 13 rev="2"> |
14 | 14 |
15 <section id="summary"> | 15 <section id="summary"> |
16 | 16 |
17 <para> | 17 <para> |
18 The <literal>ngx_http_perl_module</literal> module allows to implement | 18 The <literal>ngx_http_perl_module</literal> module allows to implement |
357 <literal>$r->internal_redirect(<value>uri</value>)</literal> | 357 <literal>$r->internal_redirect(<value>uri</value>)</literal> |
358 </tag-name> | 358 </tag-name> |
359 <tag-desc> | 359 <tag-desc> |
360 does an internal redirect to the specified <value>uri</value>. | 360 does an internal redirect to the specified <value>uri</value>. |
361 An actual redirect happens after the Perl handler has completed. | 361 An actual redirect happens after the Perl handler has completed. |
362 <note> | |
363 Redirections to named locations are not currently supported. | |
364 </note> | |
365 </tag-desc> | |
366 | |
367 <tag-name><literal>$r->log_error(<value>errno</value>, | |
368 <value>message</value>)</literal></tag-name> | |
369 <tag-desc> | |
370 writes the specified <value>message</value> into the | |
371 <link doc="../ngx_core_module.xml" id="error_log"/>. | |
372 If <value>errno</value> is non-zero, an error code and its description | |
373 will be appended to the message. | |
362 </tag-desc> | 374 </tag-desc> |
363 | 375 |
364 <tag-name><literal>$r->print(<value>text</value>, ...)</literal></tag-name> | 376 <tag-name><literal>$r->print(<value>text</value>, ...)</literal></tag-name> |
365 <tag-desc> | 377 <tag-desc> |
366 passes data to a client. | 378 passes data to a client. |
410 sends the specified file content to a client. | 422 sends the specified file content to a client. |
411 Optional parameters | 423 Optional parameters |
412 specify an initial offset and length of data to be transmitted. | 424 specify an initial offset and length of data to be transmitted. |
413 The actual data transmission happens after the Perl handler | 425 The actual data transmission happens after the Perl handler |
414 has completed. | 426 has completed. |
415 It should be noted that when using this method in a subrequest, | |
416 and <link doc="ngx_http_core_module.xml" id="sendfile"/> | |
417 is enabled, the file content will not be passed through the | |
418 <link doc="ngx_http_gzip_module.xml">gzip</link>, | |
419 <link doc="ngx_http_ssi_module.xml">SSI</link>, and | |
420 <link doc="ngx_http_charset_module.xml">charset</link> | |
421 filters. | |
422 </tag-desc> | 427 </tag-desc> |
423 | 428 |
424 <tag-name> | 429 <tag-name> |
425 <literal>$r->send_http_header([<value>type</value>])</literal> | 430 <literal>$r->send_http_header([<value>type</value>])</literal> |
426 </tag-name> | 431 </tag-name> |