Apache Module mod_actions

Summary

This module has two directives. TheAction directive lets you run CGI scripts whenever a file of a certainMIME content type is requested. TheScript directive lets you run CGI scripts whenever a particular method is used in a request. This makes it much easier to execute scripts that process files.

Directives

• Action
• Script

Bugfix checklist

• httpd changelog
• Known issues
• Report a bug

See also

• mod_cgi
• Dynamic Content with CGI
• Apache httpd's Handler Use
• Comments

ActionDirective

This directive adds an action, which will activatecgi-script whenaction-type is triggered by the request. Thecgi-script is the URL-path to a resource that has been designated as a CGI script usingScriptAlias orAddHandler. Theaction-type can be either ahandler or aMIME content type. It sends the URL and file path of the requested document using the standard CGIPATH_INFO andPATH_TRANSLATED environment variables. The handler used for the particular request is passed using theREDIRECT_HANDLER variable.

# Requests for files of a particular MIME content type:Action image/gif /cgi-bin/images.cgi

In this example, requests for files with a MIME content type ofimage/gif will be handled by the specified cgi script/cgi-bin/images.cgi.

# Files of a particular file extensionAddHandler my-file-type .xyzAction my-file-type "/cgi-bin/program.cgi"

In this example, requests for files with a file extension of.xyz are handled by the specified cgi script/cgi-bin/program.cgi.

The optionalvirtual modifier turns off the check whether the requested file really exists. This is useful, for example, if you want to use theAction directive in virtual locations.

<Location "/news">    SetHandler news-handler    Action news-handler "/cgi-bin/news.cgi" virtual</Location>

See also

• AddHandler

ScriptDirective

This directive adds an action, which will activatecgi-script when a file is requested using the method ofmethod. Thecgi-script is the URL-path to a resource that has been designated as a CGI script usingScriptAlias orAddHandler. The URL and file path of the requested document is sent using the standard CGIPATH_INFO andPATH_TRANSLATED environment variables.

Note that theScript command defines default actions only. If a CGI script is called, or some other resource that is capable of handling the requested method internally, it will do so. Also note thatScript with a method ofGET will only be called if there are query arguments present (e.g., foo.html?hi). Otherwise, the request will proceed normally.

# All GET requests go hereScript GET "/cgi-bin/search"# A CGI PUT handlerScript PUT "/~bob/put.cgi"