Модуль Apache mod_actions

Описание:	Выполнение сценариев CGI на основе типа носителя или метода запроса.
Статус:	Базовый
Идентификатор модуля:	actions_module
Исходный файл:	mod_actions.c

Краткое описание

Этот модуль содержит две директивы. Директива Action позволяет запускать сценарии CGI при каждом запросе файла определённого типа содержимого MIME. Директива Script позволяет запускать сценарии CGI при каждом использовании определённого метода в запросе. Это значительно упрощает выполнение сценариев, обрабатывающих файлы.

Директива Action

Описание:	Активирует сценарий CGI для определённого обработчика или типа содержимого
Синтаксис:	Action action-type cgi-script [virtual]
Контекст:	конфигурация сервера, виртуальный хост, каталог, .htaccess
Переопределение:	FileInfo
Статус:	Базовый
Модуль:	mod_actions
Совместимость:	Модификатор `virtual` и передача обработчика появились в Apache 2.1

Эта директива добавляет действие, которое активирует cgi-script, когда запрос инициирует action-type. cgi-script — это URL-путь к ресурсу, назначенному сценарием CGI с помощью ScriptAlias или AddHandler. В качестве action-type может выступать обработчик или тип содержимого MIME. URL и путь к файлу запрошенного документа передаются с помощью стандартных переменных окружения CGI PATH_INFO и PATH_TRANSLATED. Обработчик, используемый для конкретного запроса, передаётся с помощью переменной REDIRECT_HANDLER.

Пример: тип MIME

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

В этом примере запросы файлов с типом содержимого MIME image/gif обрабатываются указанным сценарием CGI /cgi-bin/images.cgi.

Пример: расширение файла

# Files of a particular file extension
AddHandler my-file-type .xyz
Action my-file-type "/cgi-bin/program.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

Описание:	Активирует сценарий CGI для определённого метода запроса.
Синтаксис:	Script method cgi-script
Контекст:	конфигурация сервера, виртуальный хост, каталог
Статус:	Базовый
Модуль:	mod_actions

Эта директива добавляет действие, которое активирует cgi-script, когда файл запрашивается методом method. cgi-script — это URL-путь к ресурсу, назначенному сценарием CGI с помощью ScriptAlias или AddHandler. URL и путь к файлу запрошенного документа передаются с помощью стандартных переменных окружения CGI PATH_INFO и PATH_TRANSLATED.

Можно использовать любое произвольное имя метода. Имена методов чувствительны к регистру, поэтому Script PUT и Script put имеют совершенно разные последствия.

Обратите внимание, что команда Script задаёт только действия по умолчанию. Если вызывается сценарий CGI или другой ресурс, способный самостоятельно обработать запрошенный метод, он это сделает. Также обратите внимание, что Script с методом GET будет вызвана, только если присутствуют аргументы запроса (например, foo.html?hi). В противном случае запрос будет обрабатываться обычным образом.

# All GET requests go here
Script GET "/cgi-bin/search"

# A CGI PUT handler
Script PUT "/~bob/put.cgi"

© 2018 The Apache Software Foundation
Licensed under the Apache License, Version 2.0.
https://httpd.apache.org/docs/2.4/en/mod/mod_actions.html