diff options
Diffstat (limited to 'docs/manual/handler.html.en')
| -rw-r--r-- | docs/manual/handler.html.en | 167 |
1 files changed, 59 insertions, 108 deletions
diff --git a/docs/manual/handler.html.en b/docs/manual/handler.html.en index f937095dcd..48648277e0 100644 --- a/docs/manual/handler.html.en +++ b/docs/manual/handler.html.en @@ -1,59 +1,13 @@ -<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" - "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> - -<html xmlns="http://www.w3.org/1999/xhtml"> - <head> - <meta name="generator" content="HTML Tidy, see www.w3.org" /> - - <title>Apache's Handler Use</title> - </head> - <!-- Background white, links blue (unvisited), navy (visited), red (active) --> - - <body bgcolor="#FFFFFF" text="#000000" link="#0000FF" - vlink="#000080" alink="#FF0000"> - <!--#include virtual="header.html" --> - - <h1 align="center">Apache's Handler Use</h1> - - <ul> - <li><a href="#definition">What is a Handler</a></li> - - <li><a href="#examples">Examples</a></li> - - <li><a href="#programmer">Programmer's Note</a></li> - </ul> - <hr /> - - <h2><a id="definition" name="definition">What is a - Handler</a></h2> - - <table border="1"> - <tr> - <td valign="top"><strong>Related Modules</strong><br /> - <br /> - <a href="mod/mod_actions.html">mod_actions</a><br /> - <a href="mod/mod_asis.html">mod_asis</a><br /> - <a href="mod/mod_cgi.html">mod_cgi</a><br /> - <a href="mod/mod_imap.html">mod_imap</a><br /> - <a href="mod/mod_info.html">mod_info</a><br /> - <a href="mod/mod_mime.html">mod_mime</a><br /> - <a - href="mod/mod_negotiation.html">mod_negotiation</a><br /> - <a href="mod/mod_status.html">mod_status</a><br /> - </td> - - <td valign="top"><strong>Related Directives</strong><br /> - <br /> - <a href="mod/mod_actions.html#action">Action</a><br /> - <a - href="mod/mod_mime.html#addhandler">AddHandler</a><br /> - <a - href="mod/mod_mime.html#removehandler">RemoveHandler</a><br /> - <a - href="mod/mod_mime.html#sethandler">SetHandler</a><br /> - </td> - </tr> - </table> +<html xmlns="http://www.w3.org/TR/xhtml1/strict"><head><!-- + XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX + This file is generated from xml source: DO NOT EDIT + XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX + --><title>Apache's Handler Use- Apache HTTP Server</title><link href="./style/manual.css" type="text/css" rel="stylesheet"/></head><body><blockquote><div align="center"><img src="./images/sub.gif" alt="[APACHE DOCUMENTATION]"/><h3>Apache HTTP Server Version 2.0</h3></div><h1 align="center">Apache's Handler Use</h1> + <p>This document describes the use of Apache's Handlers.</p> + <ul><li><a href="#definition">What is a Handler</a></li><li><a href="#examples">Examples</a><ul><li><a href="#example1">Modifying static content using a CGI script</a></li><li><a href="#example2">Files with HTTP headers</a></li></ul></li><li><a href="#programmer">Programmer's Note</a></li></ul><hr/><h2><a name="definition">What is a Handler</a></h2> + + <table border="1"><tr><td valign="top"><strong>Related Modules</strong><br/><br/><code><a href="./mod/mod_actions.html">mod_actions</a></code>, <br/><code><a href="./mod/mod_asis.html">mod_asis</a></code>, <br/><code><a href="./mod/mod_cgi.html">mod_cgi</a></code>, <br/><code><a href="./mod/mod_imap.html">mod_imap</a></code>, <br/><code><a href="./mod/mod_info.html">mod_info</a></code>, <br/><code><a href="./mod/mod_mime.html">mod_mime</a></code>, <br/><code><a href="./mod/mod_negotiation.html">mod_negotiation</a></code>, <br/><code><a href="./mod/mod_status.html">mod_status</a></code><br/></td><td valign="top"><strong>Related Directives</strong><br/><br/><a href="./mod/mod_actions.html#action" class="directive"><code class="directive">Action</code></a><br/><a href="./mod/mod_mime.html#addhandler" class="directive"><code class="directive">AddHandler</code></a><br/><a href="./mod/mod_mime.html#removehandler" class="directive"><code class="directive">RemoveHandler</code></a><br/><a href="./mod/mod_mime.html#sethandler" class="directive"><code class="directive">SetHandler</code></a><br/></td></tr></table> + <p>A "handler" is an internal Apache representation of the action to be performed when a file is called. Generally, files @@ -66,13 +20,11 @@ can be specified without relation to file type. This is advantageous both because it is a more elegant solution, and because it also allows for both a type <strong>and</strong> a - handler to be associated with a file. (See also <a - href="mod/mod_mime.html#multipleext">Files with Multiple + handler to be associated with a file. (See also <a href="mod/mod_mime.html#multipleext">Files with Multiple Extensions</a>.)</p> <p>Handlers can either be built into the server or included in - a module, or they can be added with the <a - href="mod/mod_actions.html#action">Action</a> directive. The + a module, or they can be added with the <a href="./mod/mod_actions.html#action" class="directive"><code class="directive">Action</code></a> directive. The built-in handlers in the standard distribution are as follows:</p> @@ -82,61 +34,63 @@ default to handle static content. (core)</li> <li><strong>send-as-is</strong>: Send file with HTTP headers - as is. (<a href="mod/mod_asis.html">mod_asis</a>)</li> + as is. (<code><a href="./mod/mod_asis.html">mod_asis</a></code>)</li> <li><strong>cgi-script</strong>: Treat the file as a CGI - script. (<a href="mod/mod_cgi.html">mod_cgi</a>)</li> + script. (<code><a href="./mod/mod_cgi.html">mod_cgi</a></code>)</li> <li><strong>imap-file</strong>: Parse as an imagemap rule - file. (<a href="mod/mod_imap.html">mod_imap</a>)</li> + file. (<code><a href="./mod/mod_imap.html">mod_imap</a></code>)</li> <li><strong>server-info</strong>: Get the server's - configuration information. (<a - href="mod/mod_info.html">mod_info</a>)</li> + configuration information. (<code><a href="./mod/mod_info.html">mod_info</a></code>)</li> <li><strong>server-status</strong>: Get the server's status - report. (<a href="mod/mod_status.html">mod_status</a>)</li> + report. (<code><a href="./mod/mod_status.html">mod_status</a></code>)</li> <li><strong>type-map</strong>: Parse as a type map file for - content negotiation. (<a - href="mod/mod_negotiation.html">mod_negotiation</a>)</li> + content negotiation. (<code><a href="./mod/mod_negotiation.html">mod_negotiation</a></code>)</li> </ul> - <hr /> - - <h2><a id="examples" name="examples">Examples</a></h2> - - <h3>Modifying static content using a CGI script</h3> - - <p>The following directives will cause requests for files with - the <code>html</code> extension to trigger the launch of the - <code>footer.pl</code> CGI script.</p> -<pre> - Action add-footer /cgi-bin/footer.pl - AddHandler add-footer .html -</pre> - - <p>Then the CGI script is responsible for sending the - originally requested document (pointed to by the - <code>PATH_TRANSLATED</code> environment variable) and making - whatever modifications or additions are desired.</p> - - <h3>Files with HTTP headers</h3> - - <p>The following directives will enable the - <code>send-as-is</code> handler, which is used for files which - contain their own HTTP headers. All files in the - <code>/web/htdocs/asis/</code> directory will be processed by - the <code>send-as-is</code> handler, regardless of their - filename extensions.</p> -<pre> - <Directory /web/htdocs/asis> - SetHandler send-as-is - </Directory> -</pre> - <hr /> - - <h2><a id="programmer" name="programmer">Programmer's - Note</a></h2> + <h2><a name="examples">Examples</a></h2> + + + <h3><a name="example1">Modifying static content using a CGI script</a></h3> + + + <p>The following directives will cause requests for files with + the <code>html</code> extension to trigger the launch of the + <code>footer.pl</code> CGI script.</p> + + <blockquote><table cellpadding="10"><tr><td bgcolor="#eeeeee"><code><code> + Action add-footer /cgi-bin/footer.pl<br> + AddHandler add-footer .html + </code></code></td></tr></table></blockquote> + + <p>Then the CGI script is responsible for sending the + originally requested document (pointed to by the + <code>PATH_TRANSLATED</code> environment variable) and making + whatever modifications or additions are desired.</p> + + + <h3><a name="example2">Files with HTTP headers</a></h3> + + + <p>The following directives will enable the + <code>send-as-is</code> handler, which is used for files which + contain their own HTTP headers. All files in the + <code>/web/htdocs/asis/</code> directory will be processed by + the <code>send-as-is</code> handler, regardless of their + filename extensions.</p> + + <blockquote><table cellpadding="10"><tr><td bgcolor="#eeeeee"><code><code> + <Directory /web/htdocs/asis><br> + SetHandler send-as-is<br> + </Directory> + </code></code></td></tr></table></blockquote> + + + <h2><a name="programmer">Programmer's Note</a></h2> + <p>In order to implement the handler features, an addition has been made to the <a href="developer/API.html">Apache API</a> that @@ -154,7 +108,4 @@ type. While it is not necessary, the naming convention for handlers is to use a dash-separated word, with no slashes, so as to not invade the media type name-space.</p> - <!--#include virtual="footer.html" --> - </body> -</html> - + </blockquote><h3 align="center">Apache HTTP Server Version 2.0</h3><a href="./"><img src="./images/index.gif" alt="Index"/></a><a href="./"><img src="./images/home.gif" alt="Home"/></a></body></html>
\ No newline at end of file |