| <?xml version="1.0"?> |
| <!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd"> |
| <?xml-stylesheet type="text/xsl" href="../style/manual.de.xsl"?> |
| <!-- English Revision: 420990:1673563 (outdated) --> |
| |
| <!-- |
| Licensed to the Apache Software Foundation (ASF) under one or more |
| contributor license agreements. See the NOTICE file distributed with |
| this work for additional information regarding copyright ownership. |
| The ASF licenses this file to You under the Apache License, Version 2.0 |
| (the "License"); you may not use this file except in compliance with |
| the License. You may obtain a copy of the License at |
| |
| http://www.apache.org/licenses/LICENSE-2.0 |
| |
| Unless required by applicable law or agreed to in writing, software |
| distributed under the License is distributed on an "AS IS" BASIS, |
| WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. |
| See the License for the specific language governing permissions and |
| limitations under the License. |
| --> |
| |
| <modulesynopsis metafile="mod_actions.xml.meta"> |
| |
| <name>mod_actions</name> |
| |
| <description>Dieses Modul ermöglicht die Ausführung von CGI-Skripten |
| in Abhängigkeit von Medientypen und Anfragemethoden.</description> |
| |
| <status>Base</status> |
| <sourcefile>mod_actions.c</sourcefile> |
| <identifier>actions_module</identifier> |
| |
| <summary> |
| <p>Das Modul besitzt zwei Direktiven. Die Direktive <directive |
| module="mod_actions">Action</directive> erlaubt die Ausführung von |
| CGI-Skripten immer dann, wenn eine Anfrage zu einem bestimmten <glossary |
| ref="mime-type">MIME-Type</glossary> erfolgt. Die Direktive <directive |
| module="mod_actions">Script</directive> 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.</p> |
| </summary> |
| |
| <seealso><module>mod_cgi</module></seealso> |
| <seealso><a href="../howto/cgi.html">Dynamische Inhalte mit CGI</a></seealso> |
| <seealso><a href="../handler.html">Die Verwendung von Handlern</a></seealso> |
| |
| <directivesynopsis> |
| <name>Action</name> |
| <description>Aktiviert ein CGI-Skript für einen bestimmten Handler oder |
| Content-Type</description> |
| <syntax>Action <var>Aktionsart</var> <var>CGI-Skript</var> [virtual]</syntax> |
| <contextlist> |
| <context>server config</context><context>virtual host</context> |
| <context>directory</context><context>.htaccess</context> |
| </contextlist> |
| <override>FileInfo</override> |
| <compatibility>Der Schalter <code>virtual</code> und die Übergabe des |
| Handlers wurden in Apache 2.1 eingeführt.</compatibility> |
| |
| <usage> |
| <p>Die Direktive fügt eine Aktion hinzu, welche das |
| <var>CGI-Skript</var> aktiviert, sobald die <var>Aktionsart</var> durch |
| eine Anfrage ausgelöst wird. <var>CGI-Skript</var> ist der URL-Pfad |
| zu einer Ressource, die unter Verwendung von <directive |
| module="mod_alias">ScriptAlias</directive> oder <directive |
| module="mod_mime">AddHandler</directive> als CGI-Skript gekennzeichnet |
| wurde. Die <var>Aktionsart</var> kann entweder ein <a |
| href="../handler.html">Handler</a> oder ein <glossary ref="mime-type" |
| >MIME-Type</glossary> sein. Die URL und |
| den Dateipfad des angeforderten Dokuments in den |
| Standard-CGI-Umgebungsvariablen <code>PATH_INFO</code> und |
| <code>PATH_TRANSLATED</code> übergeben. Der für die jeweilige |
| Anfrage verwendete Handler wird in der Umgebungsvariablen |
| <code>REDIRECT_HANDLER</code> übergeben.</p> |
| |
| <example><title>Beispiele</title> |
| # Anfragen für Dateien eines bestimmten MIME-Types:<br /> |
| Action image/gif /cgi-bin/images.cgi<br /> |
| <br /> |
| # Dateien einer bestimmten Dateiendung<br /> |
| AddHandler my-file-type .xyz<br /> |
| Action my-file-type /cgi-bin/program.cgi<br /> |
| </example> |
| |
| <p>Im ersten Beispiel werden Anfragen für Dateien mit dem MIME-Type |
| <code>image/gif</code> von dem angegebenen CGI-Skript |
| <code>/cgi-bin/images.cgi</code> bearbeitet.</p> |
| |
| <p>Im zweiten Beispiel werden Anfragen für Dateien mit der Dateiendung |
| <code>.xyz</code> von dem angegebenen CGI-Skript |
| <code>/cgi-bin/program.cgi</code> bearbeitet.</p> |
| |
| <p>Der optionale Schalter <code>virtual</code> deaktiviert die Prüfung |
| auf Existenz der angeforderten Datei. Dies ist beispielsweise |
| nützlich, wenn Sie die Direktive <directive>Action</directive> in |
| Verbindung mit virtuellen Adressräumen verwenden möchten.</p> |
| |
| <example><title>Beispiel</title> |
| <Location /news><br /> |
| <indent> |
| SetHandler news-handler<br /> |
| Action news-handler /cgi-bin/news.cgi virtual<br /> |
| </indent> |
| </Location> |
| </example> |
| </usage> |
| |
| <seealso><directive module="mod_mime">AddHandler</directive></seealso> |
| </directivesynopsis> |
| |
| <directivesynopsis> |
| <name>Script</name> |
| <description>Aktiviert ein CGI-Skript für eine bestimmte |
| Anfragemethode.</description> |
| <syntax>Script <var>Methode</var> <var>CGI-Skript</var></syntax> |
| <contextlist> |
| <context>server config</context><context>virtual host</context> |
| <context>directory</context></contextlist> |
| <usage> |
| <p>Die Direktive fügt eine Aktion hinzu, welche das |
| <var>CGI-Skript</var> aktiviert, wenn eine Datei unter der Verwendung der |
| Methode <var>Methode</var> angefordert wird. <var>CGI-Skript</var> ist der |
| URL-Pfad zu einer Ressource, die unter Verwendung von <directive |
| module="mod_alias">ScriptAlias</directive> oder <directive |
| module="mod_mime">AddHandler</directive> als CGI-Skript gekennzeichnet |
| wurde. Die URL und der Dateipfad des angeforderten Dokuments werden in den |
| Standard-CGI-Umgebungsvariablen <code>PATH_INFO</code> und |
| <code>PATH_TRANSLATED</code> übergeben.</p> |
| |
| <note> |
| Der Methodenname kann frei gewählt werden. Bei <strong>Methodennamen |
| wird zwischen Groß- und Kleinschreibung</strong> unterschieden, so |
| dass <code>Script PUT</code> und <code>Script put</code> zu vollkommen |
| unterschiedlichen Ergebnissen führen. |
| </note> |
| |
| <p>Beachten Sie, dass der <directive>Script</directive>-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 <directive>Script</directive> mit der Methode |
| <code>GET</code> nur dann aufgerufen wird, wenn Query-Argumente vorhanden |
| sind (<em>z.B.</em> foo.html?hi). Andernfalls wird die Anfrage normal |
| bearbeitet.</p> |
| |
| <example><title>Beispiele</title> |
| # Für <ISINDEX>-ähnliches Suchen<br /> |
| Script GET /cgi-bin/search<br /> |
| <br /> |
| # Ein CGI-PUT-Handler<br /> |
| Script PUT /~bob/put.cgi<br /> |
| </example> |
| </usage> |
| </directivesynopsis> |
| |
| </modulesynopsis> |