# Apache module mod_actions

This module is contained in the `mod_actions.c` file, and is compiled in by default. It provides for executing CGI scripts based on media type or request method.

## Summary

This module lets you run CGI scripts whenever a file of a certain type is requested. This makes it much easier to execute scripts that process files.

## Directives

- Action
- Script

## Action

Syntax: Action mime-type cgi-script
Context: server config, virutal host, directory, .htaccess
Override: FileInfo
Status: Base
Module: mod_actions

This directive adds an action, which will activate cgi-script when a file of content type mime-type is requested. It sends the URL and file path of the requested document using the standard CGI PATH_INFO and PATH_TRANSLATED environment variables.

## Script

Syntax: Script method cgi-script
Context: server config, virutal host, directory
Status: Base
Module: mod_actions

This directive adds an action, which will activate cgi-script when a file is requested using the method of method, which can be one of `GET`, `POST`, `PUT` or `DELETE`. It sends the URL and file path of the requested document using the standard CGI PATH_INFO and PATH_TRANSLATED environment variables.

Note that the Script 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 that script with a method of `GET` will only be called if there are query arguments present (e.g. foo.html?hi). Otherwise, the request will proceed normally.

Examples:

        Script GET /cgi-bin/search     #e.g. for <ISINDEX>-style searching
        Script PUT /~bob/put.cgi