Apache模塊 mod_actions · Apache 2.2 中文官方文檔

# Apache模塊 mod_actions | [說明](#calibre_link-11) | 基于媒體類型或請求方法，為執行CGI腳本而提供 | | --- | --- | | [狀態](#calibre_link-12) | 基本(B) | | [模塊名](#calibre_link-13) | actions_module | | [源文件](#calibre_link-14) | mod_actions.c | ### 概述此模塊有兩個指令。`Action`指令讓你可以在對特定[MIME類型](#calibre_link-223 "see glossary")文件請求的時候運行CGI腳本。`Script`指令讓你能夠在使用特定請求方法的時候運行CGI腳本。這使得執行處理文件的CGI腳本更加容易。 ## Action 指令 | [說明](#calibre_link-18) | 針對特定的處理器或內容類型激活一個CGI腳本 | | --- | --- | | [語法](#calibre_link-19) | `Action action-type cgi-script [virtual]` | | [作用域](#calibre_link-20) | server config, virtual host, directory, .htaccess | | [覆蓋項](#calibre_link-66) | FileInfo | | [狀態](#calibre_link-21) | 基本(B) | | [模塊](#calibre_link-22) | mod_actions | | [兼容性](#calibre_link-137) | `virtual`修飾詞僅在 Apache 2.1 及之后的版本中可用 | 這條指令添加一個當action-type被請求觸發時會執行cgi-script的動作。cgi-script是一個URL路徑，指向一個已經被用`ScriptAlias`或`AddHandler`指令指定為CGI腳本的資源。action-type可以是一個[處理器](#calibre_link-253)或一個[MIME內容類型](#calibre_link-223 "see glossary")。它使用標準的`PATH_INFO`和`PATH_TRANSLATED`環境變量來發送此URL和被請求內容的文件路徑。用于該請求的處理器通過`REDIRECT_HANDLER`變量傳遞。 ### 例子 ``` # 對特定MIME內容類型文件的請求 Action image/gif /cgi-bin/images.cgi # 對于具有特定擴展名的文件 AddHandler my-file-type .xyz Action my-file-type /cgi-bin/program.cgi ``` 在第一個例子中，對于所有對MIME類型"`image/gif`"的請求都將被指定的CGI腳本`/cgi-bin/images.cgi`進行處理。在第二個例子中，對于所有對具有擴展名"`.xyz`"的文件的請求都將被指定的CGI腳本`/cgi-bin/program.cgi`進行處理。可選的`virtual`修飾詞關閉了對所請求的文件是否真實存在的檢查。這個修飾詞很有用，比如希望將`Action`使用于虛擬位置的時候： ### 示例 ``` <Location /news> SetHandler news-handler Action news-handler /cgi-bin/news.cgi virtual </Location> ``` ### 參見 * `AddHandler` ## Script 指令 | [說明](#calibre_link-18) | 對特定的請求方法激活一個CGI腳本 | | --- | --- | | [語法](#calibre_link-19) | `Script method cgi-script` | | [作用域](#calibre_link-20) | server config, virtual host, directory | | [狀態](#calibre_link-21) | 基本(B) | | [模塊](#calibre_link-22) | mod_actions | 該指令添加一個當文件被method方法請求時會激活腳本cgi-script的動作。cgi-script是一個URL路徑，指向一個已用`ScriptAlias`或`AddHandler`指令指定為CGI腳本的資源。它使用標準的`PATH_INFO`和`PATH_TRANSLATED`環境變量來發送此URL和被請求內容的文件路徑。可以使用任意的方法名稱。**方法名大小寫敏感**，因此 `Script PUT` 和 `Script put` 具有完全不同的結果。注意，`Script`命令只定義了默認的動作。如果一個CGI腳本或其他能夠內部處理此請求的資源被調用，就將這樣做。同時注意對應`GET`方法的腳本只有在提供了查詢參數的時候才會被調用(例如："foo.html?hi")。否則，該請求將被正常處理。 ### 例子 ``` # <ISINDEX>風格的搜索 Script GET /cgi-bin/search # A CGI PUT 處理器 Script PUT /~bob/put.cgi ```