Mercurial > hg > nginx-site

comparison xml/en/docs/http/ngx_http_perl_module.xml @ 760:f0e3d07c66d8

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
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>