|Description:||Execute CGI scripts based on media type or request method.|
This module has two directives. The
Action directive lets you run CGI scripts whenever a file of a certain MIME content type is requested. The
Script 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.
|Description:||Activates a CGI script for a particular handler or content-type|
Action action-type cgi-script [virtual]
|Context:||server config, virtual host, directory, .htaccess|
This directive adds an action, which will activate cgi-script when action-type is triggered by the request. The cgi-script is the URL-path to a resource that has been designated as a CGI script using
AddHandler. The action-type can be either a handler or a MIME content type. It sends the URL and file path of the requested document using the standard CGI
PATH_TRANSLATED environment variables. The handler used for the particular request is passed using the
# 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 of
image/gif will be handled by the specified cgi script
# Files of a particular file extension AddHandler my-file-type .xyz Action 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
virtual modifier turns off the check whether the requested file really exists. This is useful, for example, if you want to use the
Action directive in virtual locations.
<Location "/news"> SetHandler news-handler Action news-handler "/cgi-bin/news.cgi" virtual </Location>
|Description:||Activates a CGI script for a particular request method.|
Script method cgi-script
|Context:||server config, virtual host, directory|
This directive adds an action, which will activate cgi-script when a file is requested using the method of method. The cgi-script is the URL-path to a resource that has been designated as a CGI script using
AddHandler. The URL and file path of the requested document is sent using the standard CGI
PATH_TRANSLATED environment variables.
Script puthave two entirely different effects.
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.
# All GET requests go here Script GET "/cgi-bin/search" # A CGI PUT handler Script PUT "/~bob/put.cgi"
© 2017 The Apache Software Foundation
Licensed under the Apache License, Version 2.0.