mod_actions

mod_actions - Definition von CGI-Skripten für Handler oder HTTP/Methoden

Beschreibung

Modul	mod_actions
Kontext	Server <VirtualHost> <Directory> <Location> <Files> .htaccess (FileInfo)
Syntax	Action Action-Type CGI-Skript
Standardwert	nicht gesetzt

• CGI-relevantes Modul
• Grundausstattung von Apache
• Stellt zwei Konfigurationsdirektiven zur Verfügung

Action

CGI-Skript für Handler oder MIME-Type aktivieren

Action ermöglicht es, für einen bestimmten MIME-Type oder einen Handler ein CGI-Skript anzugeben, das anstelle der aufgerufenen URL ausgeführt wird

• Falls sich dieses Skript in einem Verzeichnis befindet, in dem AcceptPathInfo aktiviert wurde, erhält es den relativen Pfad der angeforderten Datei über die Umgebungsvariable PATH_INFO und den absoluten (Dateisystem-)Pfad über PATH_TRANSLATED

Dies lässt sich nutzen, um die eigentlich angeforderte Datei zunächst in irgendeiner Form durch das CGI-Skript zu manipulieren und dann auszugeben

• Beachten Sie jedoch, dass sich die meisten derartigen Aufgaben erheblich komfortabler und mit besserer Performance durch Ausgabefilter (siehe SSI und Filter) umsetzen lassen

Das folgende Beispiel leitet sämtliche HTML-Dateien im Unterverzeichnis /actiontest der DocumentRoot an das Skript /cgi-bin/test.pl weiter

<Location /actiontest>
Action text/html /cgi-bin/test.pl
</Location>

Damit das Skript irgendetwas Sinnvolles mit der angeforderten Datei anfangen kann, muss das cgi-bin-Verzeichnis folgende Konfigurationsanweisung enthalten (oder erben)

AcceptPathInfo On

Alternativ können Sie das Skript einem Handler statt einem MIME-Type zuweisen; Handler können mittels AddHandler für eine bestimmte Dateiendung oder durch SetHandler für alle Dateien in einem Kontext festgelegt werden

Das folgende Beispiel aktiviert für alle Dateien im aktuellen Kontext, die die Endung .htm (aber nicht .html) tragen, das Skript /cgi-bin/modify.pl

AddHandler htmodify .htm
Action htmodify /cgi-bin/modify.pl

Beispiele für solche Skripte sehen Sie dort, wo die eigentliche CGI-Programmierung besprochen wird, im Verlauf dieses Kapitels

Script CGI-Skript für eine bestimmte HTTP-Methode aktivieren

Modul mod_actions
Kontext Server, <VirtualHost>, <Directory>, <Location>, <Files>
Syntax Script HTTP-Methode CGI-Skript
Standardwert nicht gesetzt

Umgebungsvariablen Mithilfe dieser Direktive können Sie für einzelne HTTP-Anfrage-Methoden generell ein bestimmtes CGI-Skript aktivieren

• Sinnvoll ist dies beispielsweise für PUTAnfragen: Das Skript kann erst einmal genau überprüfen, ob der übermittelte Inhalt unbedenklich ist, bevor es ihn auf der Festplatte des Server-Rechners speichert

Dieses Beispiel leitet PUT-Anfragen im aktuellen Kontext an /cgi-bin/putter.pl weiter

Script PUT /cgi-bin/putter.pl

Beachten Sie, dass dieses Verfahren bei GET-Anfragen nur funktioniert, wenn sich hinter der angeforderten URL ein Query-String, das heißt ein ? mit nachfolgender Parameterliste, befindet

• Andernfalls liefert Apache einfach die angeforderte Datei aus

Aufruf

Optionen

Unix	GNU	Parameter	Beschreibung

Konfiguration

Dateien

Datei	Beschreibung

Anhang

Dokumentation

Man-Page

Info-Pages