Apache HTTP Server Version 2.4

Apache > HTTP-Server > Dokumentation > Version 2.4 > Module

# Apache-Modul mod_actions

Diese Übersetzung ist möglicherweise nicht mehr aktuell. Bitte prüfen Sie die englische Version auf die neuesten Änderungen.

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.

### Direktiven

### Bugfix checklist

- httpd changelog
- Known issues
- Report a bug

### Siehe auch

- `mod_cgi`
- Dynamische Inhalte mit CGI
- Die Verwendung von Handlern

## 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

- `AddHandler`

## 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.

Der Methodenname kann frei gewählt werden. Bei Methodennamen wird zwischen Groß- und Kleinschreibung unterschieden, so dass `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
`