docs/manual/mod/mod_actions.xml.de


1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157

<?xml version="1.0"?>
<!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">
<?xml-stylesheet type="text/xsl" href="../style/manual.de.xsl"?>
<!-- English Revision: 125277 -->

<!--
 Copyright 2003-2005 The Apache Software Foundation or its licensors,
                     as applicable.

 Licensed 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&ouml;glicht die Ausf&uuml;hrung von CGI-Skripten
  in Abh&auml;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&uuml;hrung von 
      CGI-Skripten immer dann, wenn eine Anfrage zu einem bestimmten MIME-Type
      erfolgt. Die Direktive <directive module="mod_actions">Script</directive>
      erlaubt die Ausf&uuml;hrung von CGI-Skripten abh&auml;ngig von einer
      bestimmten Methode, die in der Anfrage verwendet wird. Dies macht es
      deutlich einfacher, Skripte auszuf&uuml;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&uuml;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 &Uuml;bergabe des 
  Handlers wurden in Apache 2.1 eingef&uuml;hrt.</compatibility>

<usage>
    <p>Die Direktive f&uuml;gt eine Aktion hinzu, welche das
      <var>CGI-Skript</var> aktiviert, sobald die <var>Aktionsart</var> durch
      eine Anfrage ausgel&ouml;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 MIME-Type sein. Die URL und
      den Dateipfad des angeforderten Dokuments in den 
      Standard-CGI-Umgebungsvariablen <code>PATH_INFO</code> und
      <code>PATH_TRANSLATED</code> &uuml;bergeben. Der f&uuml;r die jeweilige 
      Anfrage verwendete Handler wird in der Umgebungsvariablen
      <code>REDIRECT_HANDLER</code> &uuml;bergeben.</p>

    <example><title>Beispiele</title>
      # Anfragen f&uuml;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&uuml;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&uuml;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&uuml;fung
      auf Existenz der angeforderten Datei. Dies ist beispielsweise 
      n&uuml;tzlich, wenn Sie die Direktive <directive>Action</directive> in 
      Verbindung mit virtuellen Adressr&auml;umen verwenden m&ouml;chten.</p> 

    <example><title>Beispiel</title>
      &lt;Location /news&gt;<br />
      <indent>
        SetHandler news-handler<br />
        Action news-handler /cgi-bin/news.cgi virtual<br />
      </indent>
      &lt;/Location&gt;
    </example>
</usage>

<seealso><directive module="mod_mime">AddHandler</directive></seealso>
</directivesynopsis>

<directivesynopsis>
<name>Script</name>
<description>Aktiviert ein CGI-Skript f&uuml;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&uuml;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> &uuml;bergeben.</p>

    <note>
      Der Methodenname kann frei gew&auml;hlt werden. Bei <strong>Methodennamen
      wird zwischen Gro&szlig;- und Kleinschreibung</strong> unterschieden, so
      dass <code>Script PUT</code> und <code>Script put</code> zu vollkommen
      unterschiedlichen Ergebnissen f&uuml;hren.
    </note>

    <p>Beachten Sie, dass der <directive>Script</directive>-Befehl nur
      Voreinstellungen f&uuml;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&uuml;r &lt;ISINDEX&gt;-&auml;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>