Apache HTTP Server Version 2.4
Apache-Modul mod_actions
Beschreibung: | Dieses Modul ermöglicht die Ausführung von CGI-Skripten in Abhängigkeit von Medientypen und Anfragemethoden. |
---|---|
Status: | Basis |
Modulbezeichner: | actions_module |
Quelltext-Datei: | mod_actions.c |
Zusammenfassung
Das Modul besitzt zwei Direktiven. Die Direktive Action
erlaubt die Ausführung von
CGI-Skripten immer dann, wenn eine Anfrage zu einem bestimmten MIME-Type erfolgt. Die Direktive Script
erlaubt die Ausführung von
CGI-Skripten abhängig von einer bestimmten Methode, die in der
Anfrage verwendet wird. Dies macht es deutlich einfacher, Skripte
auszuführen, die Dateien verarbeiten.
Action-Direktive
Beschreibung: | Aktiviert ein CGI-Skript für einen bestimmten Handler oder Content-Type |
---|---|
Syntax: | Action Aktionsart CGI-Skript [virtual] |
Kontext: | Serverkonfiguration, Virtual Host, Verzeichnis, .htaccess |
AllowOverride: | FileInfo |
Status: | Basis |
Modul: | mod_actions |
Kompatibilität: | Der Schalter virtual und die Übergabe des
Handlers wurden in Apache 2.1 eingeführt. |
Die Direktive fügt eine Aktion hinzu, welche das
CGI-Skript aktiviert, sobald die Aktionsart durch
eine Anfrage ausgelöst wird. CGI-Skript ist der URL-Pfad
zu einer Ressource, die unter Verwendung von ScriptAlias
oder AddHandler
als CGI-Skript gekennzeichnet
wurde. Die Aktionsart kann entweder ein Handler oder ein MIME-Type sein. Die URL und
den Dateipfad des angeforderten Dokuments in den
Standard-CGI-Umgebungsvariablen PATH_INFO
und
PATH_TRANSLATED
übergeben. Der für die jeweilige
Anfrage verwendete Handler wird in der Umgebungsvariablen
REDIRECT_HANDLER
übergeben.
Beispiele
# Anfragen für Dateien eines bestimmten MIME-Types:
Action image/gif /cgi-bin/images.cgi
# Dateien einer bestimmten Dateiendung
AddHandler my-file-type .xyz
Action my-file-type /cgi-bin/program.cgi
Im ersten Beispiel werden Anfragen für Dateien mit dem MIME-Type
image/gif
von dem angegebenen CGI-Skript
/cgi-bin/images.cgi
bearbeitet.
Im zweiten Beispiel werden Anfragen für Dateien mit der Dateiendung
.xyz
von dem angegebenen CGI-Skript
/cgi-bin/program.cgi
bearbeitet.
Der optionale Schalter virtual
deaktiviert die Prüfung
auf Existenz der angeforderten Datei. Dies ist beispielsweise
nützlich, wenn Sie die Direktive Action
in
Verbindung mit virtuellen Adressräumen verwenden möchten.
Beispiel
<Location /news>
SetHandler news-handler
Action news-handler /cgi-bin/news.cgi virtual
</Location>
Siehe auch
Script-Direktive
Beschreibung: | Aktiviert ein CGI-Skript für eine bestimmte Anfragemethode. |
---|---|
Syntax: | Script Methode CGI-Skript |
Kontext: | Serverkonfiguration, Virtual Host, Verzeichnis |
Status: | Basis |
Modul: | mod_actions |
Die Direktive fügt eine Aktion hinzu, welche das
CGI-Skript aktiviert, wenn eine Datei unter der Verwendung der
Methode Methode angefordert wird. CGI-Skript ist der
URL-Pfad zu einer Ressource, die unter Verwendung von ScriptAlias
oder AddHandler
als CGI-Skript gekennzeichnet
wurde. Die URL und der Dateipfad des angeforderten Dokuments werden in den
Standard-CGI-Umgebungsvariablen PATH_INFO
und
PATH_TRANSLATED
übergeben.
Script PUT
und Script put
zu vollkommen
unterschiedlichen Ergebnissen führen.
Beachten Sie, dass der Script
-Befehl nur
Voreinstellungen für Aktionen definiert. Wird ein CGI-Skript
- oder eine andere Ressource, die in der Lage ist, die angeforderte
Methode intern zu bearbeiten - aufgerufen, so wird diese(s) verwendet.
Beachten Sie auch, dass Script
mit der Methode
GET
nur dann aufgerufen wird, wenn Query-Argumente vorhanden
sind (z.B. foo.html?hi). Andernfalls wird die Anfrage normal
bearbeitet.
Beispiele
# Für <ISINDEX>-ähnliches Suchen
Script GET /cgi-bin/search
# Ein CGI-PUT-Handler
Script PUT /~bob/put.cgi