Spec-Zone.ru › Apache HTTP Server

Модуль 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

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API