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