2 <!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">
3 <?xml-stylesheet type="text/xsl" href="../style/manual.en.xsl"?>
4 <!-- $Revision: 1.17 $ -->
7 Copyright 2002-2004 The Apache Software Foundation
9 Licensed under the Apache License, Version 2.0 (the "License");
10 you may not use this file except in compliance with the License.
11 You may obtain a copy of the License at
13 http://www.apache.org/licenses/LICENSE-2.0
15 Unless required by applicable law or agreed to in writing, software
16 distributed under the License is distributed on an "AS IS" BASIS,
17 WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
18 See the License for the specific language governing permissions and
19 limitations under the License.
22 <modulesynopsis metafile="mod_actions.xml.meta">
24 <name>mod_actions</name>
26 <description>This module provides for executing CGI scripts based on
27 media type or request method.</description>
30 <sourcefile>mod_actions.c</sourcefile>
31 <identifier>actions_module</identifier>
34 <p>This module has two directives. The <directive
35 module="mod_actions">Action</directive> directive lets you run CGI
36 scripts whenever a file of a certain MIME content type is requested. The
37 <directive module="mod_actions">Script</directive> directive lets
38 you run CGI scripts whenever a particular method is used in a
39 request. This makes it much easier to execute scripts that process
43 <seealso><module>mod_cgi</module></seealso>
44 <seealso><a href="../howto/cgi.html">Dynamic Content with CGI</a></seealso>
45 <seealso><a href="../handler.html">Apache's Handler Use</a></seealso>
49 <description>Activates a CGI script for a particular handler or
50 content-type</description>
51 <syntax>Action <var>action-type</var> <var>cgi-script</var> [virtual]</syntax>
53 <context>server config</context><context>virtual host</context>
54 <context>directory</context><context>.htaccess</context>
56 <override>FileInfo</override>
57 <compatibility>The <code>virtual</code> modifier and handler passing were
58 introduced in Apache 2.1</compatibility>
61 <p>This directive adds an action, which will activate
62 <var>cgi-script</var> when <var>action-type</var> is triggered by the
63 request. The <var>cgi-script</var> is the URL-path to a resource
64 that has been designated as a CGI script using <directive
65 module="mod_alias">ScriptAlias</directive> or <directive
66 module="mod_mime">AddHandler</directive>. The
67 <var>action-type</var> can be either a <a
68 href="../handler.html">handler</a> or a MIME content type. It
69 sends the URL and file path of the requested document using the
70 standard CGI <code>PATH_INFO</code> and <code>PATH_TRANSLATED</code>
71 environment variables. The handler used for the particular request is
72 passed using the <code>REDIRECT_HANDLER</code> variable.</p>
74 <example><title>Examples</title>
75 # Requests for files of a particular MIME content type:<br />
76 Action image/gif /cgi-bin/images.cgi<br />
78 # Files of a particular file extension<br />
79 AddHandler my-file-type .xyz<br />
80 Action my-file-type /cgi-bin/program.cgi<br />
83 <p>In the first example, requests for files with a MIME content
84 type of <code>image/gif</code> will be handled by the
85 specified cgi script <code>/cgi-bin/images.cgi</code>.</p>
87 <p>In the second example, requests for files with a file extension of
88 <code>.xyz</code> are handled by the specified cgi script
89 <code>/cgi-bin/program.cgi</code>.</p>
91 <p>The optional <code>virtual</code> modifier turns off the check
92 whether the requested file really exists. This is useful, for example,
93 if you want to use the <directive>Action</directive> directive in
94 virtual locations.</p>
96 <example><title>Example</title>
97 <Location /news><br />
99 SetHandler news-handler<br />
100 Action news-handler /cgi-bin/news.cgi virtual<br />
106 <seealso><directive module="mod_mime">AddHandler</directive></seealso>
111 <description>Activates a CGI script for a particular request
112 method.</description>
113 <syntax>Script <var>method</var> <var>cgi-script</var></syntax>
115 <context>server config</context><context>virtual host</context>
116 <context>directory</context></contextlist>
118 <p>This directive adds an action, which will activate
119 <var>cgi-script</var> when a file is requested using the method of
120 <var>method</var>. The <var>cgi-script</var> is the URL-path to a
121 resource that has been designated as a CGI script using <directive
122 module="mod_alias">ScriptAlias</directive> or <directive
123 module="mod_mime">AddHandler</directive>. The URL and
124 file path of the requested document is sent using the standard CGI
125 <code>PATH_INFO</code> and <code>PATH_TRANSLATED</code> environment
129 Any arbitrary method name may be used. <strong>Method names are
130 case-sensitive</strong>, so <code>Script PUT</code> and
131 <code>Script put</code> have two entirely different
135 <p>Note that the <directive>Script</directive> command defines default
136 actions only. If a CGI script is called, or some other resource that is
137 capable of handling the requested method internally, it will do
138 so. Also note that <directive>Script</directive> with a method of
139 <code>GET</code> will only be called if there are query arguments present
140 (<em>e.g.</em>, foo.html?hi). Otherwise, the request will
141 proceed normally.</p>
143 <example><title>Examples</title>
144 # For <ISINDEX>-style searching<br />
145 Script GET /cgi-bin/search<br />
147 # A CGI PUT handler<br />
148 Script PUT /~bob/put.cgi<br />