mod_actions.html revision 1e895b30bf4833c928334fad80fac8be169ab877
4ab980a06412fd86f52a6d054fb7e26de155c530erikabele<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
4ab980a06412fd86f52a6d054fb7e26de155c530erikabele<HTML>
4ab980a06412fd86f52a6d054fb7e26de155c530erikabele<HEAD>
4ab980a06412fd86f52a6d054fb7e26de155c530erikabele<TITLE>Module mod_actions</TITLE>
4ab980a06412fd86f52a6d054fb7e26de155c530erikabele</HEAD>
4ab980a06412fd86f52a6d054fb7e26de155c530erikabele
4ab980a06412fd86f52a6d054fb7e26de155c530erikabele<!-- Background white, links blue (unvisited), navy (visited), red (active) -->
4ab980a06412fd86f52a6d054fb7e26de155c530erikabele<BODY
4ab980a06412fd86f52a6d054fb7e26de155c530erikabele BGCOLOR="#FFFFFF"
4ab980a06412fd86f52a6d054fb7e26de155c530erikabele TEXT="#000000"
4ab980a06412fd86f52a6d054fb7e26de155c530erikabele LINK="#0000FF"
4ab980a06412fd86f52a6d054fb7e26de155c530erikabele VLINK="#000080"
4ab980a06412fd86f52a6d054fb7e26de155c530erikabele ALINK="#FF0000"
4ab980a06412fd86f52a6d054fb7e26de155c530erikabele>
4ab980a06412fd86f52a6d054fb7e26de155c530erikabele<!--#include virtual="header.html" -->
4ab980a06412fd86f52a6d054fb7e26de155c530erikabele<H1 ALIGN="CENTER">Module mod_actions</h1>
4ab980a06412fd86f52a6d054fb7e26de155c530erikabele
4ab980a06412fd86f52a6d054fb7e26de155c530erikabeleThis module is contained in the <code>mod_actions.c</code> file, and
4ab980a06412fd86f52a6d054fb7e26de155c530erikabeleis compiled in by default. It provides for
4ab980a06412fd86f52a6d054fb7e26de155c530erikabeleexecuting CGI scripts based on media type or request method. It is not
4ab980a06412fd86f52a6d054fb7e26de155c530erikabelepresent in versions prior to Apache 1.1.
4ab980a06412fd86f52a6d054fb7e26de155c530erikabele
4ab980a06412fd86f52a6d054fb7e26de155c530erikabele<h2>Summary</h2>
4ab980a06412fd86f52a6d054fb7e26de155c530erikabele
4ab980a06412fd86f52a6d054fb7e26de155c530erikabeleThis module lets you run CGI scripts whenever a file of a certain type
4ab980a06412fd86f52a6d054fb7e26de155c530erikabeleis requested. This makes it much easier to execute scripts that
4ab980a06412fd86f52a6d054fb7e26de155c530erikabeleprocess files.
4ab980a06412fd86f52a6d054fb7e26de155c530erikabele
4ab980a06412fd86f52a6d054fb7e26de155c530erikabele<h2>Directives</h2>
4ab980a06412fd86f52a6d054fb7e26de155c530erikabele<ul>
4ab980a06412fd86f52a6d054fb7e26de155c530erikabele<li><A HREF="#action">Action</A>
4ab980a06412fd86f52a6d054fb7e26de155c530erikabele<li><A HREF="#script">Script</A>
4ab980a06412fd86f52a6d054fb7e26de155c530erikabele</ul>
4ab980a06412fd86f52a6d054fb7e26de155c530erikabele
4ab980a06412fd86f52a6d054fb7e26de155c530erikabele<hr>
4ab980a06412fd86f52a6d054fb7e26de155c530erikabele
4ab980a06412fd86f52a6d054fb7e26de155c530erikabele<A name="action"><h2>Action</h2></A>
4ab980a06412fd86f52a6d054fb7e26de155c530erikabele<strong>Syntax:</strong> Action <em>mime-type cgi-script</em><br>
4ab980a06412fd86f52a6d054fb7e26de155c530erikabele<strong>Context:</strong> server config, virtual host, directory, .htaccess<br>
4ab980a06412fd86f52a6d054fb7e26de155c530erikabele<strong>Override:</strong> FileInfo<br>
4ab980a06412fd86f52a6d054fb7e26de155c530erikabele<strong>Status:</strong> Base<br>
4ab980a06412fd86f52a6d054fb7e26de155c530erikabele<strong>Module:</strong> mod_actions<br>
4ab980a06412fd86f52a6d054fb7e26de155c530erikabele<strong>Compatibility:</strong> Action is only available in Apache 1.1
4ab980a06412fd86f52a6d054fb7e26de155c530erikabeleand later<p>
4ab980a06412fd86f52a6d054fb7e26de155c530erikabele
4ab980a06412fd86f52a6d054fb7e26de155c530erikabeleThis directive adds an action, which will activate <em>cgi-script</em> when
4ab980a06412fd86f52a6d054fb7e26de155c530erikabelea file of content type <em>mime-type</em> is requested. It sends the
4ab980a06412fd86f52a6d054fb7e26de155c530erikabeleURL and file path of the requested document using the standard
4ab980a06412fd86f52a6d054fb7e26de155c530erikabeleCGI PATH_INFO and PATH_TRANSLATED environment variables.
4ab980a06412fd86f52a6d054fb7e26de155c530erikabele
4ab980a06412fd86f52a6d054fb7e26de155c530erikabele<hr>
4ab980a06412fd86f52a6d054fb7e26de155c530erikabele
4ab980a06412fd86f52a6d054fb7e26de155c530erikabele<A name="script"><h2>Script</h2></A>
4ab980a06412fd86f52a6d054fb7e26de155c530erikabele<strong>Syntax:</strong> Script <em>method cgi-script</em><br>
4ab980a06412fd86f52a6d054fb7e26de155c530erikabele<strong>Context:</strong> server config, virtual host, directory<br>
4ab980a06412fd86f52a6d054fb7e26de155c530erikabele<strong>Status:</strong> Base<br>
4ab980a06412fd86f52a6d054fb7e26de155c530erikabele<strong>Module:</strong> mod_actions<br>
4ab980a06412fd86f52a6d054fb7e26de155c530erikabele<strong>Compatibility:</strong> Script is only available in Apache 1.1
4ab980a06412fd86f52a6d054fb7e26de155c530erikabeleand later<p>
4ab980a06412fd86f52a6d054fb7e26de155c530erikabele
4ab980a06412fd86f52a6d054fb7e26de155c530erikabele<p>This directive adds an action, which will activate <em>cgi-script</em> when
4ab980a06412fd86f52a6d054fb7e26de155c530erikabelea file is requested using the method of <em>method</em>, which can be
4ab980a06412fd86f52a6d054fb7e26de155c530erikabeleone of <code>GET</code>, <code>POST</code>, <code>PUT</code> or
4ab980a06412fd86f52a6d054fb7e26de155c530erikabele<code>DELETE</code>. It sends the
4ab980a06412fd86f52a6d054fb7e26de155c530erikabeleURL and file path of the requested document using the standard
4ab980a06412fd86f52a6d054fb7e26de155c530erikabeleCGI PATH_INFO and PATH_TRANSLATED environment variables.
4ab980a06412fd86f52a6d054fb7e26de155c530erikabele
4ab980a06412fd86f52a6d054fb7e26de155c530erikabele<p>Note that the Script command defines default actions only. If a CGI
4ab980a06412fd86f52a6d054fb7e26de155c530erikabelescript is called, or some other resource that is capable of handling
4ab980a06412fd86f52a6d054fb7e26de155c530erikabelethe requested method internally, it will do so. Also note that script
4ab980a06412fd86f52a6d054fb7e26de155c530erikabelewith a method of <code>GET</code> will only be called if there are
4ab980a06412fd86f52a6d054fb7e26de155c530erikabelequery arguments present (e.g. foo.html?hi). Otherwise, the request
4ab980a06412fd86f52a6d054fb7e26de155c530erikabelewill proceed normally.
4ab980a06412fd86f52a6d054fb7e26de155c530erikabele
4ab980a06412fd86f52a6d054fb7e26de155c530erikabele<p>Examples:
4ab980a06412fd86f52a6d054fb7e26de155c530erikabele<pre>
4ab980a06412fd86f52a6d054fb7e26de155c530erikabele Script GET /cgi-bin/search #e.g. for &lt;ISINDEX&gt;-style searching
4ab980a06412fd86f52a6d054fb7e26de155c530erikabele Script PUT /~bob/put.cgi
4ab980a06412fd86f52a6d054fb7e26de155c530erikabele
4ab980a06412fd86f52a6d054fb7e26de155c530erikabele</pre>
4ab980a06412fd86f52a6d054fb7e26de155c530erikabele
4ab980a06412fd86f52a6d054fb7e26de155c530erikabele<!--#include virtual="footer.html" -->
4ab980a06412fd86f52a6d054fb7e26de155c530erikabele</BODY>
4ab980a06412fd86f52a6d054fb7e26de155c530erikabele</HTML>
4ab980a06412fd86f52a6d054fb7e26de155c530erikabele
4ab980a06412fd86f52a6d054fb7e26de155c530erikabele