granicus.if.org Git - apache/blob - docs/manual/mod/mod_actions.xml.de

   1 <?xml version="1.0"?>
   2 <!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">
   3 <?xml-stylesheet type="text/xsl" href="../style/manual.de.xsl"?>
   4 <!-- English Revision: 1.17 -->
   5
   6 <!--
   7  Copyright 2003-2004 The Apache Software Foundation
   8
   9  Licensed under the Apache License, Version 2.0 (the "License");
  10  you may not use this file except in compliance with the License.
  11  You may obtain a copy of the License at
  12
  13      http://www.apache.org/licenses/LICENSE-2.0
  14
  15  Unless required by applicable law or agreed to in writing, software
  16  distributed under the License is distributed on an "AS IS" BASIS,
  17  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  18  See the License for the specific language governing permissions and
  19  limitations under the License.
  20 -->
  21
  22 <modulesynopsis metafile="mod_actions.xml.meta">
  23
  24 <name>mod_actions</name>
  25
  26 <description>Dieses Modul erm&ouml;glicht die Ausf&uuml;hrung von CGI-Skripten
  27   in Abh&auml;ngigkeit von Medientypen und Anfragemethoden.</description>
  28
  29 <status>Base</status>
  30 <sourcefile>mod_actions.c</sourcefile>
  31 <identifier>actions_module</identifier>
  32
  33 <summary>
  34     <p>Das Modul besitzt zwei Direktiven. Die Direktive <directive
  35       module="mod_actions">Action</directive> erlaubt die Ausf&uuml;hrung von
  36       CGI-Skripten immer dann, wenn eine Anfrage zu einem bestimmten MIME-Type
  37       erfolgt. Die Direktive <directive module="mod_actions">Script</directive>
  38       erlaubt die Ausf&uuml;hrung von CGI-Skripten abh&auml;ngig von einer
  39       bestimmten Methode, die in der Anfrage verwendet wird. Dies macht es
  40       deutlich einfacher, Skripte auszuf&uuml;hren, die Dateien
  41       verarbeiten.</p>
  42 </summary>
  43
  44 <seealso><module>mod_cgi</module></seealso>
  45 <seealso><a href="../howto/cgi.html">Dynamische Inhalte mit CGI</a></seealso>
  46 <seealso><a href="../handler.html">Die Verwendung von Handlern</a></seealso>
  47
  48 <directivesynopsis>
  49 <name>Action</name>
  50 <description>Aktiviert ein CGI-Skript f&uuml;r einen bestimmten Handler oder
  51   Content-Type</description>
  52 <syntax>Action <var>Aktionsart</var> <var>CGI-Skript</var> [virtual]</syntax>
  53 <contextlist>
  54 <context>server config</context><context>virtual host</context>
  55 <context>directory</context><context>.htaccess</context>
  56 </contextlist>
  57 <override>FileInfo</override>
  58 <compatibility>Der Schalter <code>virtual</code> und die &Uuml;bergabe des
  59   Handlers wurden in Apache 2.1 eingef&uuml;hrt.</compatibility>
  60
  61 <usage>
  62     <p>Die Direktive f&uuml;gt eine Aktion hinzu, welche das
  63       <var>CGI-Skript</var> aktiviert, sobald die <var>Aktionsart</var> durch
  64       eine Anfrage ausgel&ouml;st wird. <var>CGI-Skript</var> ist der URL-Pfad
  65       zu einer Ressource, die unter Verwendung von <directive
  66       module="mod_alias">ScriptAlias</directive> oder <directive
  67       module="mod_mime">AddHandler</directive> als CGI-Skript gekennzeichnet
  68       wurde. Die <var>Aktionsart</var> kann entweder ein <a
  69       href="../handler.html">Handler</a> oder ein MIME-Type sein. Die URL und
  70       den Dateipfad des angeforderten Dokuments in den
  71       Standard-CGI-Umgebungsvariablen <code>PATH_INFO</code> und
  72       <code>PATH_TRANSLATED</code> &uuml;bergeben. Der f&uuml;r die jeweilige
  73       Anfrage verwendete Handler wird in der Umgebungsvariablen
  74       <code>REDIRECT_HANDLER</code> &uuml;bergeben.</p>
  75
  76     <example><title>Beispiele</title>
  77       # Anfragen f&uuml;r Dateien eines bestimmten MIME-Types:<br />
  78       Action image/gif /cgi-bin/images.cgi<br />
  79       <br />
  80       # Dateien einer bestimmten Dateiendung<br />
  81       AddHandler my-file-type .xyz<br />
  82       Action my-file-type /cgi-bin/program.cgi<br />
  83     </example>
  84
  85     <p>Im ersten Beispiel werden Anfragen f&uuml;r Dateien mit dem MIME-Type
  86       <code>image/gif</code> von dem angegebenen CGI-Skript
  87       <code>/cgi-bin/images.cgi</code> bearbeitet.</p>
  88
  89     <p>Im zweiten Beispiel werden Anfragen f&uuml;r Dateien mit der Dateiendung
  90       <code>.xyz</code> von dem angegebenen CGI-Skript
  91       <code>/cgi-bin/program.cgi</code> bearbeitet.</p>
  92
  93     <p>Der optionale Schalter <code>virtual</code> deaktiviert die Pr&uuml;fung
  94       auf Existenz der angeforderten Datei. Dies ist beispielsweise
  95       n&uuml;tzlich, wenn Sie die Direktive <directive>Action</directive> in
  96       Verbindung mit virtuellen Adressr&auml;umen verwenden m&ouml;chten.</p>
  97
  98     <example><title>Beispiel</title>
  99       &lt;Location /news&gt;<br />
 100       <indent>
 101         SetHandler news-handler<br />
 102         Action news-handler /cgi-bin/news.cgi virtual<br />
 103       </indent>
 104       &lt;/Location&gt;
 105     </example>
 106 </usage>
 107
 108 <seealso><directive module="mod_mime">AddHandler</directive></seealso>
 109 </directivesynopsis>
 110
 111 <directivesynopsis>
 112 <name>Script</name>
 113 <description>Aktiviert ein CGI-Skript f&uuml;r eine bestimmte
 114   Anfragemethode.</description>
 115 <syntax>Script <var>Methode</var> <var>CGI-Skript</var></syntax>
 116 <contextlist>
 117 <context>server config</context><context>virtual host</context>
 118 <context>directory</context></contextlist>
 119 <usage>
 120   <p>Die Direktive f&uuml;gt eine Aktion hinzu, welche das
 121     <var>CGI-Skript</var> aktiviert, wenn eine Datei unter der Verwendung der
 122     Methode <var>Methode</var> angefordert wird. <var>CGI-Skript</var> ist der
 123     URL-Pfad zu einer Ressource, die unter Verwendung von <directive
 124     module="mod_alias">ScriptAlias</directive> oder <directive
 125     module="mod_mime">AddHandler</directive> als CGI-Skript gekennzeichnet
 126     wurde. Die URL und der Dateipfad des angeforderten Dokuments werden in den
 127     Standard-CGI-Umgebungsvariablen <code>PATH_INFO</code> und
 128     <code>PATH_TRANSLATED</code> &uuml;bergeben.</p>
 129
 130     <note>
 131       Der Methodenname kann frei gew&auml;hlt werden. Bei <strong>Methodennamen
 132       wird zwischen Gro&szlig;- und Kleinschreibung</strong> unterschieden, so
 133       dass <code>Script PUT</code> und <code>Script put</code> zu vollkommen
 134       unterschiedlichen Ergebnissen f&uuml;hren.
 135     </note>
 136
 137     <p>Beachten Sie, dass der <directive>Script</directive>-Befehl nur
 138       Voreinstellungen f&uuml;r Aktionen definiert. Wird ein CGI-Skript
 139       - oder eine andere Ressource, die in der Lage ist, die angeforderte
 140       Methode intern zu bearbeiten - aufgerufen, so wird diese(s) verwendet.
 141       Beachten Sie auch, dass <directive>Script</directive> mit der Methode
 142       <code>GET</code> nur dann aufgerufen wird, wenn Query-Argumente vorhanden
 143       sind (<em>z.B.</em> foo.html?hi). Andernfalls wird die Anfrage normal
 144       bearbeitet.</p>
 145
 146     <example><title>Beispiele</title>
 147       # F&uuml;r &lt;ISINDEX&gt;-&auml;hnliches Suchen<br />
 148       Script GET /cgi-bin/search<br />
 149       <br />
 150       # Ein CGI-PUT-Handler<br />
 151       Script PUT /~bob/put.cgi<br />
 152     </example>
 153 </usage>
 154 </directivesynopsis>
 155
 156 </modulesynopsis>