switch to a 60 bit hash
[httpd-crcsyncproxy.git] / docs / manual / mod / core.html.de
blob892e1fd70cc19fcff499cef6f076e306baf78372
1 <?xml version="1.0" encoding="ISO-8859-1"?>
2 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
3 <html xmlns="http://www.w3.org/1999/xhtml" lang="de" xml:lang="de"><head><!--
4 XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
5 This file is generated from xml source: DO NOT EDIT
6 XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
7 -->
8 <title>core - Apache HTTP Server</title>
9 <link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" />
10 <link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" />
11 <link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" />
12 <link href="../images/favicon.ico" rel="shortcut icon" /></head>
13 <body>
14 <div id="page-header">
15 <p class="menu"><a href="../mod/">Module</a> | <a href="../mod/directives.html">Direktiven</a> | <a href="../faq/">FAQ</a> | <a href="../glossary.html">Glossar</a> | <a href="../sitemap.html">Seitenindex</a></p>
16 <p class="apache">Apache HTTP Server Version 2.3</p>
17 <img alt="" src="../images/feather.gif" /></div>
18 <div class="up"><a href="./"><img title="&lt;-" alt="&lt;-" src="../images/left.gif" /></a></div>
19 <div id="path">
20 <a href="http://www.apache.org/">Apache</a> &gt; <a href="http://httpd.apache.org/">HTTP-Server</a> &gt; <a href="http://httpd.apache.org/docs/">Dokumentation</a> &gt; <a href="../">Version 2.3</a> &gt; <a href="./">Module</a></div>
21 <div id="page-content">
22 <div id="preamble"><h1>Apache-Kernfunktionen</h1>
23 <div class="toplang">
24 <p><span>Verfügbare Sprachen: </span><a href="../de/mod/core.html" title="Deutsch">&nbsp;de&nbsp;</a> |
25 <a href="../en/mod/core.html" hreflang="en" rel="alternate" title="English">&nbsp;en&nbsp;</a> |
26 <a href="../ja/mod/core.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> |
27 <a href="../tr/mod/core.html" hreflang="tr" rel="alternate" title="Türkçe">&nbsp;tr&nbsp;</a></p>
28 </div>
29 <div class="outofdate">Diese Übersetzung ist möglicherweise
30 nicht mehr aktuell. Bitte prüfen Sie die englische Version auf
31 die neuesten Änderungen.</div>
32 <table class="module"><tr><th><a href="module-dict.html#Description">Beschreibung:</a></th><td>Ständig verfügbare Kernfunktionen des Apache HTTP
33 Servers</td></tr>
34 <tr><th><a href="module-dict.html#Status">Status:</a></th><td>Core</td></tr></table>
35 </div>
36 <div id="quickview"><h3 class="directives">Direktiven</h3>
37 <ul id="toc">
38 <li><img alt="" src="../images/down.gif" /> <a href="#acceptpathinfo">AcceptPathInfo</a></li>
39 <li><img alt="" src="../images/down.gif" /> <a href="#accessfilename">AccessFileName</a></li>
40 <li><img alt="" src="../images/down.gif" /> <a href="#adddefaultcharset">AddDefaultCharset</a></li>
41 <li><img alt="" src="../images/down.gif" /> <a href="#addoutputfilterbytype">AddOutputFilterByType</a></li>
42 <li><img alt="" src="../images/down.gif" /> <a href="#allowencodedslashes">AllowEncodedSlashes</a></li>
43 <li><img alt="" src="../images/down.gif" /> <a href="#allowoverride">AllowOverride</a></li>
44 <li><img alt="" src="../images/down.gif" /> <a href="#authname">AuthName</a></li>
45 <li><img alt="" src="../images/down.gif" /> <a href="#authtype">AuthType</a></li>
46 <li><img alt="" src="../images/down.gif" /> <a href="#cgimapextension">CGIMapExtension</a></li>
47 <li><img alt="" src="../images/down.gif" /> <a href="#contentdigest">ContentDigest</a></li>
48 <li><img alt="" src="../images/down.gif" /> <a href="#defaulttype">DefaultType</a></li>
49 <li><img alt="" src="../images/down.gif" /> <a href="#directory">&lt;Directory&gt;</a></li>
50 <li><img alt="" src="../images/down.gif" /> <a href="#directorymatch">&lt;DirectoryMatch&gt;</a></li>
51 <li><img alt="" src="../images/down.gif" /> <a href="#documentroot">DocumentRoot</a></li>
52 <li><img alt="" src="../images/down.gif" /> <a href="#enablemmap">EnableMMAP</a></li>
53 <li><img alt="" src="../images/down.gif" /> <a href="#enablesendfile">EnableSendfile</a></li>
54 <li><img alt="" src="../images/down.gif" /> <a href="#errordocument">ErrorDocument</a></li>
55 <li><img alt="" src="../images/down.gif" /> <a href="#errorlog">ErrorLog</a></li>
56 <li><img alt="" src="../images/down.gif" /> <a href="#fileetag">FileETag</a></li>
57 <li><img alt="" src="../images/down.gif" /> <a href="#files">&lt;Files&gt;</a></li>
58 <li><img alt="" src="../images/down.gif" /> <a href="#filesmatch">&lt;FilesMatch&gt;</a></li>
59 <li><img alt="" src="../images/down.gif" /> <a href="#forcetype">ForceType</a></li>
60 <li><img alt="" src="../images/down.gif" /> <a href="#hostnamelookups">HostnameLookups</a></li>
61 <li><img alt="" src="../images/down.gif" /> <a href="#ifdefine">&lt;IfDefine&gt;</a></li>
62 <li><img alt="" src="../images/down.gif" /> <a href="#ifmodule">&lt;IfModule&gt;</a></li>
63 <li><img alt="" src="../images/down.gif" /> <a href="#include">Include</a></li>
64 <li><img alt="" src="../images/down.gif" /> <a href="#keepalive">KeepAlive</a></li>
65 <li><img alt="" src="../images/down.gif" /> <a href="#keepalivetimeout">KeepAliveTimeout</a></li>
66 <li><img alt="" src="../images/down.gif" /> <a href="#limit">&lt;Limit&gt;</a></li>
67 <li><img alt="" src="../images/down.gif" /> <a href="#limitexcept">&lt;LimitExcept&gt;</a></li>
68 <li><img alt="" src="../images/down.gif" /> <a href="#limitinternalrecursion">LimitInternalRecursion</a></li>
69 <li><img alt="" src="../images/down.gif" /> <a href="#limitrequestbody">LimitRequestBody</a></li>
70 <li><img alt="" src="../images/down.gif" /> <a href="#limitrequestfields">LimitRequestFields</a></li>
71 <li><img alt="" src="../images/down.gif" /> <a href="#limitrequestfieldsize">LimitRequestFieldSize</a></li>
72 <li><img alt="" src="../images/down.gif" /> <a href="#limitrequestline">LimitRequestLine</a></li>
73 <li><img alt="" src="../images/down.gif" /> <a href="#limitxmlrequestbody">LimitXMLRequestBody</a></li>
74 <li><img alt="" src="../images/down.gif" /> <a href="#location">&lt;Location&gt;</a></li>
75 <li><img alt="" src="../images/down.gif" /> <a href="#locationmatch">&lt;LocationMatch&gt;</a></li>
76 <li><img alt="" src="../images/down.gif" /> <a href="#loglevel">LogLevel</a></li>
77 <li><img alt="" src="../images/down.gif" /> <a href="#maxkeepaliverequests">MaxKeepAliveRequests</a></li>
78 <li><img alt="" src="../images/down.gif" /> <a href="#namevirtualhost">NameVirtualHost</a></li>
79 <li><img alt="" src="../images/down.gif" /> <a href="#options">Options</a></li>
80 <li><img alt="" src="../images/down.gif" /> <a href="#require">Require</a></li>
81 <li><img alt="" src="../images/down.gif" /> <a href="#rlimitcpu">RLimitCPU</a></li>
82 <li><img alt="" src="../images/down.gif" /> <a href="#rlimitmem">RLimitMEM</a></li>
83 <li><img alt="" src="../images/down.gif" /> <a href="#rlimitnproc">RLimitNPROC</a></li>
84 <li><img alt="" src="../images/down.gif" /> <a href="#satisfy">Satisfy</a></li>
85 <li><img alt="" src="../images/down.gif" /> <a href="#scriptinterpretersource">ScriptInterpreterSource</a></li>
86 <li><img alt="" src="../images/down.gif" /> <a href="#serveradmin">ServerAdmin</a></li>
87 <li><img alt="" src="../images/down.gif" /> <a href="#serveralias">ServerAlias</a></li>
88 <li><img alt="" src="../images/down.gif" /> <a href="#servername">ServerName</a></li>
89 <li><img alt="" src="../images/down.gif" /> <a href="#serverpath">ServerPath</a></li>
90 <li><img alt="" src="../images/down.gif" /> <a href="#serverroot">ServerRoot</a></li>
91 <li><img alt="" src="../images/down.gif" /> <a href="#serversignature">ServerSignature</a></li>
92 <li><img alt="" src="../images/down.gif" /> <a href="#servertokens">ServerTokens</a></li>
93 <li><img alt="" src="../images/down.gif" /> <a href="#sethandler">SetHandler</a></li>
94 <li><img alt="" src="../images/down.gif" /> <a href="#setinputfilter">SetInputFilter</a></li>
95 <li><img alt="" src="../images/down.gif" /> <a href="#setoutputfilter">SetOutputFilter</a></li>
96 <li><img alt="" src="../images/down.gif" /> <a href="#timeout">TimeOut</a></li>
97 <li><img alt="" src="../images/down.gif" /> <a href="#usecanonicalname">UseCanonicalName</a></li>
98 <li><img alt="" src="../images/down.gif" /> <a href="#virtualhost">&lt;VirtualHost&gt;</a></li>
99 </ul>
100 </div>
102 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
103 <div class="directive-section"><h2><a name="AcceptPathInfo" id="AcceptPathInfo">AcceptPathInfo</a>-<a name="acceptpathinfo" id="acceptpathinfo">Direktive</a></h2>
104 <table class="directive">
105 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Ressourcen lassen angehängte Pfadangaben zu</td></tr>
106 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>AcceptPathInfo On|Off|Default</code></td></tr>
107 <tr><th><a href="directive-dict.html#Default">Voreinstellung:</a></th><td><code>AcceptPathInfo Default</code></td></tr>
108 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Serverkonfiguration, Virtual Host, Verzeichnis, .htaccess</td></tr>
109 <tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>FileInfo</td></tr>
110 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
111 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
112 <tr><th><a href="directive-dict.html#Compatibility">Kompatibilität:</a></th><td>Verfügbar ab Apache 2.0.30</td></tr>
113 </table>
114 <p>Die Direktive steuert, ob Anfragen akzeptiert oder
115 abgewiesen werden, bei denen nach der tatsächlichen
116 Datei (oder einer nicht existierenden Datei in einem existierenden
117 Verzeichnis) zusätzliche Pfadangaben folgen. Die angehängte
118 Pfadangabe kann Skripten in der Umgebungsvariable <code>PATH_INFO</code>
119 verfügbar gemacht werden.</p>
121 <p>Nehmen wir beispielsweise an, dass <code>/test/</code> auf ein
122 Verzeichnis zeigt, welches lediglich eine Datei <code>here.html</code>
123 enthält. Dann wird bei Anfragen nach
124 <code>/test/here.html/more</code> und
125 <code>/test/nothere.html/more</code> beides Mal <code>/more</code>
126 als <code>PATH_INFO</code> ermittelt.</p>
128 <p>Die drei möglichen Argumente für die Direktive
129 <code class="directive">AcceptPathInfo</code> sind:</p>
131 <dl>
132 <dt><code>Off</code></dt><dd>Eine Anfrage wird nur dann akzeptiert,
133 wenn sie exakt auf ein existierendes Verzeichnis (oder eine Datei)
134 abgebildet werden kann. Daher würde eine Anfrage mit einer nach dem
135 tatsächlichen Dateinamen angehängten Pfadangabe, wie
136 <code>/test/here.html/more</code> im obigen Beispiel, den Fehler
137 404 NOT FOUND <span class="transnote">(<em>Anm.d.Ü.:</em> nicht gefunden)</span>
138 zurückgeben.</dd>
140 <dt><code>On</code></dt>
141 <dd>Eine Anfrage wird akzeptiert, wenn eine vorangestellte Pfadangabe
142 auf ein existierendes Verzeichnis abgebildet werden kann. Das
143 obige Beispiel <code>/test/here.html/more</code> wird akzeptiert,
144 wenn <code>/test/here.html</code> auf eine gültige Datei
145 zeigt.</dd>
147 <dt><code>Default</code></dt>
148 <dd>Die Behandlung von Anfragen mit angehängten Pfadangaben
149 wird von dem für die Anfrage verantwortlichen <a href="../handler.html">Handler</a> bestimmt. Der Core-Handler
150 für gewöhnliche Dateien weist <code>PATH_INFO</code>-Zugriffe
151 standardmäßig zurück. Handler, die Skripte bedienen,
152 wie z.B. <a href="mod_cgi.html">cgi-script</a> und
153 <a href="mod_isapi.html">isapi-handler</a>, sind im Allgemeinen darauf
154 voreingestellt, <code>PATH_INFO</code> zu akzeptieren.</dd>
155 </dl>
157 <p>Das eigentliche Ziel von <code>AcceptPathInfo</code> ist es, Ihnen
158 das Überschreiben der Voreinstellung der Handler bezüglich
159 der Akzeptanz oder Ablehnung von <code>PATH_INFO</code> zu erlauben.
160 Eine solche Änderung ist zum Beispiel notwendig, wenn Sie einen
161 <a href="../filter.html">Filter</a> wie <a href="mod_include.html">INCLUDES</a> verwenden, um Inhalte
162 abhängig von <code>PATH_INFO</code> zu generieren. Der
163 Core-Handler würde die Anfrage normalerweise abweisen. Verwenden
164 Sie die folgende Konfiguration, um dennoch solch ein Skript zu
165 ermöglichen.</p>
167 <div class="example"><p><code>
168 &lt;Files "mypaths.shtml"&gt;<br />
169 <span class="indent">
170 Options +Includes<br />
171 SetOutputFilter INCLUDES<br />
172 AcceptPathInfo On<br />
173 </span>
174 &lt;/Files&gt;
175 </code></p></div>
178 </div>
179 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
180 <div class="directive-section"><h2><a name="AccessFileName" id="AccessFileName">AccessFileName</a>-<a name="accessfilename" id="accessfilename">Direktive</a></h2>
181 <table class="directive">
182 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Name der dezentralen Konfigurationsdateien</td></tr>
183 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>AccessFileName <var>Dateiname</var> [<var>Dateiname</var>] ...</code></td></tr>
184 <tr><th><a href="directive-dict.html#Default">Voreinstellung:</a></th><td><code>AccessFileName .htaccess</code></td></tr>
185 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Serverkonfiguration, Virtual Host</td></tr>
186 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
187 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
188 </table>
189 <p>Aus dieser Namensliste sucht der Server während der
190 Bearbeitung einer Anfrage in jedem Verzeichnis nach der ersten
191 existierenden Datei, sofern im betreffenden Verzeichnis dezentrale
192 Konfigurationsdateien <a href="#allowoverride">erlaubt sind</a>.
193 Beispiel:</p>
195 <div class="example"><p><code>
196 AccessFileName .acl
197 </code></p></div>
199 <p>Vor der Rücksendung des Dokuments
200 <code>/usr/local/web/index.html</code> wird der Server
201 <code>/.acl</code>, <code>/usr/.acl</code>,
202 <code>/usr/local/.acl</code> und <code>/usr/local/web/.acl</code>
203 einlesen, solange diese nicht mit</p>
205 <div class="example"><p><code>
206 &lt;Directory /&gt;<br />
207 <span class="indent">
208 AllowOverride None<br />
209 </span>
210 &lt;/Directory&gt;
211 </code></p></div>
213 <p>deaktiviert wurden.</p>
215 <h3>Siehe auch</h3>
216 <ul>
217 <li><code class="directive"><a href="#allowoverride">AllowOverride</a></code></li>
218 <li><a href="../configuring.html">Konfigurationsdateien</a></li>
219 <li><a href="../howto/htaccess.html">.htaccess-Dateien</a></li>
220 </ul>
221 </div>
222 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
223 <div class="directive-section"><h2><a name="AddDefaultCharset" id="AddDefaultCharset">AddDefaultCharset</a>-<a name="adddefaultcharset" id="adddefaultcharset">Direktive</a></h2>
224 <table class="directive">
225 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Standard-Charset-Parameter, der bei Antworten vom Content-Type
226 <code>text/plain</code> oder <code>text/html</code> hinzugefügt wird
227 </td></tr>
228 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>AddDefaultCharset On|Off|<var>Zeichenkodierung</var></code></td></tr>
229 <tr><th><a href="directive-dict.html#Default">Voreinstellung:</a></th><td><code>AddDefaultCharset Off</code></td></tr>
230 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Serverkonfiguration, Virtual Host, Verzeichnis, .htaccess</td></tr>
231 <tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>FileInfo</td></tr>
232 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
233 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
234 </table>
235 <p>Die Direktive gibt einen Standardwert für den Charset-Paramter des
236 Medientyps (den Namen einer Zeichencodierung) an, der einer Antwort
237 genau dann hinzugefügt wird, wenn der Content-Type der Antwort entweder
238 <code>text/plain</code> oder <code>text/html</code> ist. Dies sollte jedes
239 mittels <code>META</code>-Element im Datenteil der Antwort angegebene
240 Charset überschreiben. Das genaue Verhalten hängt jedoch oft von
241 der Client-Konfiguration des Benutzers ab. Die Einstellung
242 <code>AddDefaultCharset Off</code> deaktiviert diese Funktionalität.
243 <code>AddDefaultCharset On</code> aktiviert die Standard-Zeichenkodierung
244 <code>iso-8859-1</code>. Jeder andere Wert wird als die zu verwendende
245 <var>Zeichenkodierung</var> aufgefaßt, die eines der bei <a href="http://www.iana.org/assignments/character-sets">IANA registrierten
246 Charset-Werte</a> zur Verwendung in MIME-Medientypen sein sollte. Zum
247 Beispiel:</p>
249 <div class="example"><p><code>
250 AddDefaultCharset utf-8
251 </code></p></div>
253 <p><code class="directive">AddDefaultCharset</code> sollte nur verwendet werden,
254 wenn von allen Textressourcen, für die es gilt, bekannt ist, dass sie
255 in dieser Zeichkodierung vorliegen, oder wenn es zu unbequem ist, ihre
256 Zeichenkodierung indivuell zu benennen. Ein solches Beispiel ist das
257 Hinzufügen des Charset-Parameters zu Ressourcen, die generierte
258 Inhalte enthalten. Ein Beispiel sind CGI-Skript-Altlasten, die aufgrund von
259 in die Ausgabe integrierten Daten, die durch den Benutzer übermittelt
260 wurden, gegen Cross-Site-Scripting-Angriffe verwundbar sind. Eine bessere
261 Lösung wäre jedoch, diese Skripte zu korrigieren (oder zu
262 löschen), da die Angabe einer Standard-Zeichencodierung keine
263 Anwender schützt, die in ihrem Browser die Funktion zur
264 automatischen Erkennung der Zeichenkodierung aktiviert haben.</p>
266 <h3>Siehe auch</h3>
267 <ul>
268 <li><code class="directive"><a href="../mod/mod_mime.html#addcharset">AddCharset</a></code></li>
269 </ul>
270 </div>
271 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
272 <div class="directive-section"><h2><a name="AddOutputFilterByType" id="AddOutputFilterByType">AddOutputFilterByType</a>-<a name="addoutputfilterbytype" id="addoutputfilterbytype">Direktive</a></h2>
273 <table class="directive">
274 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>einen Ausgabefilter einem bestimmten MIME-Type
275 zuordnen</td></tr>
276 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>AddOutputFilterByType <var>Filter</var>[;<var>Filter</var>...]
277 <var>MIME-Type</var> [<var>MIME-Type</var>] ...</code></td></tr>
278 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Serverkonfiguration, Virtual Host, Verzeichnis, .htaccess</td></tr>
279 <tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>FileInfo</td></tr>
280 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
281 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
282 <tr><th><a href="directive-dict.html#Compatibility">Kompatibilität:</a></th><td>Verfügbar ab Apache 2.0.33</td></tr>
283 </table>
284 <p>Die Direktive aktiviert für eine Anfrage abhängig vom
285 MIME-Type der Antwort einen bestimmten Ausgabe-<a href="../filter.html">Filter</a>.</p>
287 <p>Das folgende Beispiel verwendet den Filter <code>DEFLATE</code>,
288 der von <code class="module"><a href="../mod/mod_deflate.html">mod_deflate</a></code> angeboten wird. Er komprimiert
289 jede Ausgabe, die als <code>text/html</code> oder <code>text/plain</code>
290 gekennzeichnet ist, (gleichgültig, ob statisch oder dynamisch)
291 bevor sie an den Client gesendet wird.</p>
293 <div class="example"><p><code>
294 AddOutputFilterByType DEFLATE text/html text/plain
295 </code></p></div>
297 <p>Wenn Sie den Inhalt von mehr als einem Filter verarbeiten lassen
298 wollen, dann müssen deren Namen durch Semikolons voneinander
299 getrennt werden. Es ist ebenfalls möglich, eine
300 <code class="directive">AddOutputFilterByType</code>-Direktive für
301 jeden von diesen Filtern zu verwenden.</p>
303 <p>Die folgende Konfiguration sorgt dafür, dass alle
304 Skriptausgaben, die als <code>text/html</code> gekennzeichnet
305 sind, zuerst vom <code>INCLUDES</code>-Filter und dann vom
306 <code>DEFLATE</code>-Filter verarbeitet werden.</p>
308 <div class="example"><p><code>
309 &lt;Location /cgi-bin/&gt;<br />
310 <span class="indent">
311 Options Includes<br />
312 AddOutputFilterByType INCLUDES;DEFLATE text/html<br />
313 </span>
314 &lt;/Location&gt;
315 </code></p></div>
317 <div class="warning"><h3>Hinweis:</h3>
318 <p>Die Aktivierung von Filtern mittels
319 <code class="directive">AddOutputFilterByType</code> kann in einigen
320 Fällen ganz oder teilweise fehlschlagen. Beispielsweise
321 werden keine Filter angewendet, wenn der MIME-Type nicht bestimmt
322 werden kann und auf die Einstellung der <code class="directive"><a href="#defaulttype">DefaultType</a></code>-Anweisung zurückfällt,
323 selbst wenn die <code class="directive"><a href="#defaulttype">DefaultType</a></code>-Einstellung die gleiche ist.</p>
325 <p>Wenn Sie jedoch sicherstellen wollen, dass der Filter
326 angewendet wird, sollten Sie den Content-Type z.B. mit
327 <code class="directive"><a href="../mod/mod_mime.html#addtype">AddType</a></code> oder
328 <code class="directive"><a href="#forcetype">ForceType</a></code> der Ressource
329 explizit zuordnen. Das Setzen des Content-Types innerhalb
330 eines (nicht-nph) CGI-Skriptes funktioniert ebenfalls
331 zuverlässig.</p>
333 <p>Die Typ-gebundenen Ausgabefilter werden niemals auf
334 Proxy-Anfragen angewendet.</p>
335 </div>
337 <h3>Siehe auch</h3>
338 <ul>
339 <li><code class="directive"><a href="../mod/mod_mime.html#addoutputfilter">AddOutputFilter</a></code></li>
340 <li><code class="directive"><a href="#setoutputfilter">SetOutputFilter</a></code></li>
341 <li><a href="../filter.html">Filter</a></li>
342 </ul>
343 </div>
344 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
345 <div class="directive-section"><h2><a name="AllowEncodedSlashes" id="AllowEncodedSlashes">AllowEncodedSlashes</a>-<a name="allowencodedslashes" id="allowencodedslashes">Direktive</a></h2>
346 <table class="directive">
347 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Legt fest, ob kodierte Pfadtrennzeichen in URLs durchgereicht
348 werden dürfen</td></tr>
349 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>AllowEncodedSlashes On|Off</code></td></tr>
350 <tr><th><a href="directive-dict.html#Default">Voreinstellung:</a></th><td><code>AllowEncodedSlashes Off</code></td></tr>
351 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Serverkonfiguration, Virtual Host</td></tr>
352 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
353 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
354 <tr><th><a href="directive-dict.html#Compatibility">Kompatibilität:</a></th><td>Verfügbar ab Apache 2.0.46</td></tr>
355 </table>
356 <p>Die <code class="directive">AllowEncodedSlashes</code>-Direktive erlaubt die
357 Verwendung von URLs, welche kodierte Pfadtrennzeichen (<code>%2F</code>
358 für <code>/</code> und auf entsprechenden Systemen zusätzlich
359 <code>%5C</code> für <code>\</code>) enthalten. Normalerweise werden
360 derartige URLs mit einem 404-Fehler (Nicht gefunden) abgewiesen.</p>
362 <p><code class="directive">AllowEncodedSlashes</code> <code>On</code> ist
363 vor allem in Verbindung mit <code>PATH_INFO</code> hilfreich.</p>
365 <div class="note"><h3>Anmerkung</h3>
366 <p>Das Erlauben von Schrägstrichen impliziert <em>nicht</em> deren
367 <em>Dekodierung</em>. Vorkommen von <code>%2F</code> oder <code>%5C</code>
368 (<em>nur</em> auf entsprechenden Systemen) werden unverändert in der
369 ansonsten dekodierten URL belassen.</p>
370 </div>
372 <h3>Siehe auch</h3>
373 <ul>
374 <li><code class="directive"><a href="#acceptpathinfo">AcceptPathInfo</a></code></li>
375 </ul>
376 </div>
377 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
378 <div class="directive-section"><h2><a name="AllowOverride" id="AllowOverride">AllowOverride</a>-<a name="allowoverride" id="allowoverride">Direktive</a></h2>
379 <table class="directive">
380 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Direktiven-Typen, die in <code>.htaccess</code>-Dateien
381 erlaubt sind.</td></tr>
382 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>AllowOverride All|None|<var>Direktiven-Typ</var>
383 [<var>Direktiven-Typ</var>] ...</code></td></tr>
384 <tr><th><a href="directive-dict.html#Default">Voreinstellung:</a></th><td><code>AllowOverride All</code></td></tr>
385 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Verzeichnis</td></tr>
386 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
387 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
388 </table>
389 <p>Wenn der Server eine <code>.htaccess</code>-Datei (wie durch
390 <code class="directive"><a href="#accessfilename">AccessFileName</a></code> definiert)
391 findet, muss er wissen, welche in der Datei angegebenen Direktiven
392 frühere Konfigurationsanweisungen überschreiben
393 dürfen.</p>
395 <div class="note"><h3>Nur in &lt;Directory&gt;-Abschnitten verfügbar</h3>
396 <code class="directive">AllowOverride</code> ist nur in <code class="directive"><a href="#directory">&lt;Directory&gt;</a></code>-Abschnitten
397 gültig, die ohne reguläre Ausdrücke definiert wurden, nicht
398 in <code class="directive"><a href="#location">&lt;Location&gt;</a></code>-,
399 <code class="directive"><a href="#directorymatch">&lt;DirectoryMatch&gt;</a></code>- oder
400 <code class="directive"><a href="#files">&lt;Files&gt;</a></code>-Abschnitten.
401 </div>
403 <p>Wenn diese Anweisung auf <code>None</code> gesetzt wird, dann
404 werden <a href="#accessfilename">.htaccess</a>-Dateien komplett
405 ignoriert. In diesem Fall wird der Server nicht einmal versuchen,
406 die <code>.htaccess</code>-Dateien im Dateisystem zu lesen.</p>
408 <p>Wenn diese Anweisung auf <code>All</code> gesetzt wird, dann
409 ist jede Direktive in den <code>.htaccess</code>-Dateien erlaubt,
410 die den <a href="directive-dict.html#Context">Kontext</a>
411 .htaccess besitzt.</p>
413 <p>Der <var>Direktiven-Typ</var> kann eine der folgenden
414 Anweisungsgruppen sein.</p>
416 <dl>
417 <dt>AuthConfig</dt>
419 <dd>
420 Erlaubt die Verwendung von Autorisierungs-Anweisungen (<code class="directive"><a href="../mod/mod_authn_dbm.html#authdbmgroupfile">AuthDBMGroupFile</a></code>,
421 <code class="directive"><a href="../mod/mod_authn_dbm.html#authdbmuserfile">AuthDBMUserFile</a></code>,
422 <code class="directive"><a href="../mod/mod_authz_groupfile.html#authgroupfile">AuthGroupFile</a></code>,
423 <code class="directive"><a href="#authname">AuthName</a></code>,
424 <code class="directive"><a href="#authtype">AuthType</a></code>, <code class="directive"><a href="../mod/mod_authn_file.html#authuserfile">AuthUserFile</a></code>, <code class="directive"><a href="#require">Require</a></code> <em>usw.</em>).</dd>
426 <dt>FileInfo</dt>
428 <dd>
429 Erlaubt die Verwendung von Direktiven zur Steuerung der
430 Dokumenttypen (<code class="directive"><a href="#defaulttype">DefaultType</a></code>, <code class="directive"><a href="#errordocument">ErrorDocument</a></code>, <code class="directive"><a href="#forcetype">ForceType</a></code>, <code class="directive"><a href="../mod/mod_negotiation.html#languagepriority">LanguagePriority</a></code>,
431 <code class="directive"><a href="#sethandler">SetHandler</a></code>, <code class="directive"><a href="#setinputfilter">SetInputFilter</a></code>, <code class="directive"><a href="#setoutputfilter">SetOutputFilter</a></code>, und
432 <code class="module"><a href="../mod/mod_mime.html">mod_mime</a></code>-Direktiven Add* und Remove*
433 <em>usw.</em>).</dd>
435 <dt>Indexes</dt>
437 <dd>
438 Erlaubt die Verwendung von Direktiven zur Steuerung von
439 Verzeichnisindizes (<code class="directive"><a href="../mod/mod_autoindex.html#adddescription">AddDescription</a></code>,
440 <code class="directive"><a href="../mod/mod_autoindex.html#addicon">AddIcon</a></code>, <code class="directive"><a href="../mod/mod_autoindex.html#addiconbyencoding">AddIconByEncoding</a></code>,
441 <code class="directive"><a href="../mod/mod_autoindex.html#addiconbytype">AddIconByType</a></code>,
442 <code class="directive"><a href="../mod/mod_autoindex.html#defaulticon">DefaultIcon</a></code>, <code class="directive"><a href="../mod/mod_dir.html#directoryindex">DirectoryIndex</a></code>, <code class="directive"><a href="../mod/mod_autoindex.html#fancyindexing">FancyIndexing</a></code>, <code class="directive"><a href="../mod/mod_autoindex.html#headername">HeaderName</a></code>, <code class="directive"><a href="../mod/mod_autoindex.html#indexignore">IndexIgnore</a></code>, <code class="directive"><a href="../mod/mod_autoindex.html#indexoptions">IndexOptions</a></code>, <code class="directive"><a href="../mod/mod_autoindex.html#readmename">ReadmeName</a></code>
443 <em>usw.</em>).</dd>
445 <dt>Limit</dt>
447 <dd>
448 Erlaubt die Verwendung von Direktiven zur Steuerung des
449 Zugriffs von Hosts (<code class="directive"><a href="../mod/mod_authz_host.html#allow">Allow</a></code>, <code class="directive"><a href="../mod/mod_authz_host.html#deny">Deny</a></code> und <code class="directive"><a href="../mod/mod_authz_host.html#order">Order</a></code>).</dd>
451 <dt>Options[=<var>Option</var>,...]</dt>
453 <dd>
454 Erlaubt die Verwendung von Direktiven zur Steuerung spezieller
455 Verzeichniseigenschaften (<code class="directive"><a href="#options">Options</a></code>
456 und <code class="directive"><a href="../mod/mod_include.html#xbithack">XBitHack</a></code>). Sie
457 können mit einem Gleichheitszeichen gefolgt von einer
458 kommaseparierten Liste (ohne Leerzeichen) angeben, welche Optionen mit
459 der <code class="directive"><a href="#options">Options</a></code>-Direktive gesetzt
460 werden dürfen.</dd>
461 </dl>
463 <p>Beispiel:</p>
465 <div class="example"><p><code>
466 AllowOverride AuthConfig Indexes
467 </code></p></div>
469 <p>Im obigen Beispiel erzeugen alle Direktiven einen internal server
470 error <span class="transnote">(<em>Anm.d.Ü.:</em> Server-interner Fehler)</span>, die weder der
471 Gruppe <code>AuthConfig</code> noch der Gruppe <code>Indexes</code>
472 angehören.</p>
474 <h3>Siehe auch</h3>
475 <ul>
476 <li><code class="directive"><a href="#accessfilename">AccessFileName</a></code></li>
477 <li><a href="../configuring.html">Konfigurationsdateien</a></li>
478 <li><a href="../howto/htaccess.html">.htaccess-Dateien</a></li>
479 </ul>
480 </div>
481 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
482 <div class="directive-section"><h2><a name="AuthName" id="AuthName">AuthName</a>-<a name="authname" id="authname">Direktive</a></h2>
483 <table class="directive">
484 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Autorisierungsbereich zur Verwendung in der
485 HTTP-Authentisierung</td></tr>
486 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>AuthName <var>auth-Bereich</var></code></td></tr>
487 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Verzeichnis, .htaccess</td></tr>
488 <tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>AuthConfig</td></tr>
489 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
490 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
491 </table>
492 <p>Die Direktive legt den Namen des Autorisierungsbereiches
493 <span class="transnote">(<em>Anm.d.Ü.:</em> Der Autorisierungsbereich wird auch Realm genannt.)</span>
494 für ein Verzeichnis fest. Dieser Realm wird dem Client mitgeteilt,
495 damit der Anwender weiß, welchen Benutzernamen und welches Passwort
496 er zu übermitteln hat. <code class="directive">AuthName</code> akzeptiert ein
497 Argument. Falls der Name des Realm Leerzeichen enthält, muss er in
498 Anführungszeichen eingeschlossen werden. Um zu funktionieren, muss
499 die Anweisung von den Direktiven <code class="directive"><a href="#authtype">AuthType</a></code> und <code class="directive"><a href="#require">Require</a></code> sowie von
500 Direktiven wie <code class="directive"><a href="../mod/mod_authn_file.html#authuserfile">AuthUserFile</a></code>
501 und <code class="directive"><a href="../mod/mod_authz_groupfile.html#authgroupfile">AuthGroupFile</a></code>
502 begleitet werden.</p>
504 <p>Beispiel:</p>
506 <div class="example"><p><code>
507 AuthName "Top Secret"
508 </code></p></div>
510 <p>Die <code>AuthName</code> übergebene Zeichenkette ist das,
511 was in dem von den meisten Browsern angebotenen Passwort-Dialog
512 angezeigt wird.</p>
514 <h3>Siehe auch</h3>
515 <ul>
516 <li><a href="../howto/auth.html">Authentisierung, Autorisierung und
517 Zugriffskontrolle</a></li>
518 </ul>
519 </div>
520 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
521 <div class="directive-section"><h2><a name="AuthType" id="AuthType">AuthType</a>-<a name="authtype" id="authtype">Direktive</a></h2>
522 <table class="directive">
523 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Art der Authentisierung</td></tr>
524 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>AuthType Basic|Digest</code></td></tr>
525 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Verzeichnis, .htaccess</td></tr>
526 <tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>AuthConfig</td></tr>
527 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
528 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
529 </table>
530 <p>Die Direktive wählt die Art der Benutzer-Authentisierung
531 für ein Verzeichnis aus. Derzeit sind lediglich <code>Basic</code>
532 und <code>Digest</code> implementiert.
533 Um zu funktionieren, muss die Anweisung von den Direktiven <code class="directive"><a href="#authname">AuthName</a></code> und <code class="directive"><a href="#require">Require</a></code> sowie von
534 Direktiven wie <code class="directive"><a href="../mod/mod_authn_file.html#authuserfile">AuthUserFile</a></code>
535 und <code class="directive"><a href="../mod/mod_authz_groupfile.html#authgroupfile">AuthGroupFile</a></code>
536 begleitet werden.</p>
538 <h3>Siehe auch</h3>
539 <ul>
540 <li><a href="../howto/auth.html">Authentisierung, Autorisierung und
541 Zugriffskontrolle</a></li>
542 </ul>
543 </div>
544 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
545 <div class="directive-section"><h2><a name="CGIMapExtension" id="CGIMapExtension">CGIMapExtension</a>-<a name="cgimapextension" id="cgimapextension">Direktive</a></h2>
546 <table class="directive">
547 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Technik zur Bestimmung des Interpreters für
548 CGI-Skripte</td></tr>
549 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>CGIMapExtension <var>CGI-Pfad</var> <var>.Endung</var></code></td></tr>
550 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Verzeichnis, .htaccess</td></tr>
551 <tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>FileInfo</td></tr>
552 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
553 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
554 <tr><th><a href="directive-dict.html#Compatibility">Kompatibilität:</a></th><td>ausschließlich NetWare</td></tr>
555 </table>
556 <p>Die Direktive wird zur Steuerung verwendet, wie Apache
557 den Interpreter ermittelt, der zur Ausführung von
558 CGI-Skripten verwendet wird. Beispielsweise bestimmt die Angabe
559 von <code>CGIMapExtension sys:\foo.nlm .foo</code>, dass
560 alle CGI-Scripte mit der Endung <code>.foo</code> an den
561 FOO-Interpreter übergeben werden.</p>
563 </div>
564 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
565 <div class="directive-section"><h2><a name="ContentDigest" id="ContentDigest">ContentDigest</a>-<a name="contentdigest" id="contentdigest">Direktive</a></h2>
566 <table class="directive">
567 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Aktiviert die Generierung von <code>Content-MD5</code>
568 HTTP-Response-Headern</td></tr>
569 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>ContentDigest On|Off</code></td></tr>
570 <tr><th><a href="directive-dict.html#Default">Voreinstellung:</a></th><td><code>ContentDigest Off</code></td></tr>
571 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Serverkonfiguration, Virtual Host, Verzeichnis, .htaccess</td></tr>
572 <tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>Options</td></tr>
573 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
574 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
575 </table>
576 <p>Die Direktive aktiviert die Generierung von
577 <code>Content-MD5</code>-Headern, wie sie in RFC1864 bzw. RFC2616
578 definiert sind.</p>
580 <p>MD5 ist ein Algorithmus zur Berechnung eines "Datenextrakts"
581 (zuweilen "Fingerabdruck" genannt) <span class="transnote">(<em>Anm.d.Ü.:</em> Der "Datenextrakt" wird im
582 Englischen als "message digest" oder "fingerprint" bezeichnet.)</span>
583 aus beliebig langen Daten. Es gilt als zuverlässig, dass
584 Veränderungen an den Daten sich in Veränderungen des
585 Extrakts wiederspiegeln.</p>
587 <p>Der <code>Content-MD5</code>-Header bietet eine
588 End-to-End-Integritätsprüfung (MIC) <span class="transnote">(<em>Anm.d.Ü.:</em> MIC steht für
589 "message integrity check".)</span> des Daten-Inhalts. Ein Proxy oder
590 Client kann diesen Header prüfen, um zufällige Veränderungen
591 des Entity-Inhalts bei der Übertragung festzustellen.
592 Beispielheader:</p>
594 <div class="example"><p><code>
595 Content-MD5: AuLb7Dp1rqtRtxz2m9kRpA==
596 </code></p></div>
598 <p>Beachten Sie bitte, dass dies Performanceprobleme auf Ihrem
599 System verursachen kann, da der Extrakt bei jeder Anfrage
600 berechnet wird (der Wert wird nicht zwischengespeichert).</p>
602 <p><code>Content-MD5</code> wird nur für Dokumente gesendet,
603 die von <code class="module"><a href="../mod/core.html">core</a></code> bedient werden, nicht jedoch bei
604 Modulen. SSI-Dokumente, CGI-Skript-Ausgaben und Byte-Range-Antworten
605 besitzen diesen Header beispielsweise nicht.</p>
607 </div>
608 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
609 <div class="directive-section"><h2><a name="DefaultType" id="DefaultType">DefaultType</a>-<a name="defaulttype" id="defaulttype">Direktive</a></h2>
610 <table class="directive">
611 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>MIME-Content-Type, der gesendet wird, wenn der Server den Typ
612 nicht auf andere Weise ermitteln kann.</td></tr>
613 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>DefaultType <var>MIME-Type</var></code></td></tr>
614 <tr><th><a href="directive-dict.html#Default">Voreinstellung:</a></th><td><code>DefaultType text/plain</code></td></tr>
615 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Serverkonfiguration, Virtual Host, Verzeichnis, .htaccess</td></tr>
616 <tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>FileInfo</td></tr>
617 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
618 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
619 </table>
620 <p>Es kann vorkommen, dass der Server ein Dokument ausliefern muss,
621 dessen Typ er nicht mit Hilfe seiner MIME-Type-Zuordnungen bestimmen
622 kann.</p>
624 <p>Der Server muss den Client über den Content-Type des
625 Dokumentes informieren. Daher verwendet er im Falle eines
626 unbekannten Typs die <code>DefaultType</code>-Einstellung.
627 Zum Beispiel:</p>
629 <div class="example"><p><code>
630 DefaultType image/gif
631 </code></p></div>
633 <p>wäre angemessen für ein Verzeichnis, das viele GIF-Bilder
634 enthält, deren Dateinamen nicht Endung <code>.gif</code>
635 besitzen.</p>
637 <p>Beachten Sie bitte, dass die Direktive anders als <code class="directive"><a href="#forcetype">ForceType</a></code> lediglich den Standard-MIME-Type
638 bestimmt. Alle anderen MIME-Type-Definitionen, einschließlich
639 Dateierweiterungen, die den Medien-Typ anzeigen können,
640 überschreiben diese Voreinstellung.</p>
642 </div>
643 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
644 <div class="directive-section"><h2><a name="Directory" id="Directory">&lt;Directory&gt;</a>-<a name="directory" id="directory">Direktive</a></h2>
645 <table class="directive">
646 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Umschließt eine Gruppe von Direktiven, die nur auf
647 das genannte Verzeichnis des Dateisystems und Unterverzeichnisse angewendet
648 werden</td></tr>
649 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>&lt;Directory <var>Verzeichnispfad</var>&gt;
650 ... &lt;/Directory&gt;</code></td></tr>
651 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Serverkonfiguration, Virtual Host</td></tr>
652 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
653 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
654 </table>
655 <p><code class="directive">&lt;Directory&gt;</code> und
656 <code>&lt;/Directory&gt;</code> werden dazu verwendet, eine Gruppe
657 von Direktiven zusammenzufassen, die nur für das genannte
658 Verzeichnis und dessen Unterverzeichnisse gelten. Jede Direktive,
659 die im Verzeichnis-Kontext erlaubt ist, kann verwendet werden.
660 <var>Verzeichnispfad</var> ist entweder der vollständige Pfad zu
661 einem Verzeichnis oder eine Zeichenkette mit Platzhaltern wie sie von der
662 Unix-Shell zum Abgleich verwendet werden. In einer Zeichenkette
663 mit Platzhaltern <span class="transnote">(<em>Anm.d.Ü.:</em> sogenannte wild-cards)</span> entspricht
664 <code>?</code> einem einzelnen Zeichen und <code>*</code> einer
665 Zeichenkette beliebiger Länge. Sie können auch auch
666 <code>[]</code>-Zeichenbereiche verwenden. Keiner der Platzhalter
667 entspricht dem Zeichen "/". Daher passt <code>&lt;Directory
668 /*/public_html&gt;</code> nicht auf <code>/home/user/public_html</code>,
669 <code>&lt;Directory /home/*/public_html&gt;</code> jedoch tut es.
670 Beispiel:</p>
672 <div class="example"><p><code>
673 &lt;Directory /usr/local/httpd/htdocs&gt;<br />
674 <span class="indent">
675 Options Indexes FollowSymLinks<br />
676 </span>
677 &lt;/Directory&gt;
678 </code></p></div>
680 <div class="note">
681 <p>Seien Sie vorsichtig mit den <var>Verzeichnispfad</var>-Argumenten.
682 Sie müssen buchstäblich mit dem Dateisystempfad
683 übereinstimmen, den der Apache für den Zugriff auf die
684 Dateien verwendet. Direktiven, die für ein bestimmtes
685 Verzeichnis gelten, gelten nicht für Dateien in dem Verzeichnis,
686 auf die über einen anderen Pfad zugegriffen wird, wie z.B.
687 über verschiedene symbolische Links.</p>
688 </div>
690 <p>Erweiterte reguläre Ausdrücke können ebenfalls
691 verwendet werden, indem das Zeichen <code>~</code> hinzugefügt
692 wird. Beispielsweise würde</p>
694 <div class="example"><p><code>
695 &lt;Directory ~ "^/www/.*/[0-9]{3}"&gt;
696 </code></p></div>
698 <p>auf Verzeichnisse in <code>/www/</code> passen, die aus drei
699 Zahlen bestehen.</p>
701 <p>Wenn mehrere <code class="directive">&lt;Directory&gt;</code>-Abschnitte
702 (ohne reguläre Ausdrücke) auf ein Verzeichnis (oder
703 ein ihm übergeordnetes Verzeichnis) passen, welches ein Dokument
704 enthält, dann werden die Direktiven der Reihe nach, angefangen
705 beim kürzesten passenden Muster, vermischt mit den Direktiven
706 aus den <a href="#accessfilename">.htaccess</a>-Dateien, angewendet.
707 Beispiel:</p>
709 <div class="example"><p><code>
710 &lt;Directory /&gt;<br />
711 <span class="indent">
712 AllowOverride None<br />
713 </span>
714 &lt;/Directory&gt;<br />
715 <br />
716 &lt;Directory /home/&gt;<br />
717 <span class="indent">
718 AllowOverride FileInfo<br />
719 </span>
720 &lt;/Directory&gt;
721 </code></p></div>
723 <p>Beim Zugriff auf das Dokument <code>/home/web/dir/doc.html</code>
724 sind die einzelnen Schritte:</p>
726 <ul>
727 <li>Wende die Direktive <code>AllowOverride None</code> an
728 (deaktiviere <code>.htaccess</code>-Dateien).</li>
730 <li>Wende die Direktive <code>AllowOverride FileInfo</code>
731 (auf das Verzeichnis <code>/home</code>) an.</li>
733 <li>Wende jede <code>FileInfo</code>-Direktive aus
734 <code>/home/.htaccess</code>, <code>/home/web/.htaccess</code> und
735 <code>/home/web/dir/.htaccess</code> der Reihe nach an.</li>
736 </ul>
738 <p>Reguläre Ausdrücke werden solange nicht berücksichtigt,
739 bis alle normalen Abschnitte angewendet wurden. Anschließend
740 werden alle regulären Ausdrücke in der Reihenfolge
741 geprüft, in der sie in der Konfigurationsdatei auftauchen.
742 Beispielsweise wird bei</p>
744 <div class="example"><p><code>
745 &lt;Directory ~ abc$&gt;<br />
746 <span class="indent">
747 # ... hier die Direktiven ...<br />
748 </span>
749 &lt;/Directory&gt;
750 </code></p></div>
752 <p>der Abschnitt mit dem regulären Ausdruck nicht
753 berücksichtigt, bis alle normalen
754 <code class="directive">&lt;Directory&gt;</code>-Abschnitte und
755 <code>.htaccess</code>-Dateien angewendet wurden. Dann erst wird
756 der reguläre Ausdruck mit <code>/home/abc/public_html/abc</code>
757 abgeglichen und der entsprechende <code class="directive">&lt;Directory&gt;</code>-Abschnitt angewendet.</p>
759 <p><strong>Beachten Sie bitte, dass der vom Apache voreingestellte
760 Zugriff für <code>&lt;Directory /&gt;</code>
761 <code>Allow from All</code> ist. Das bedeutet, dass der Apache
762 jede Datei ausliefert, die durch eine URL abgebildet wird. Es wird
763 empfohlen, dass Sie dies durch einen Block wie</strong></p>
765 <div class="example"><p><code>
766 &lt;Directory /&gt;<br />
767 <span class="indent">
768 Order Deny,Allow<br />
769 Deny from All<br />
770 </span>
771 &lt;/Directory&gt;
772 </code></p></div>
774 <p><strong>ändern und anschließend für
775 Verzeichnisse überschreiben, die Sie verfügbar machen
776 <em>wollen</em>. Für weitere Einzelheiten lesen Sie bitte
777 die Seite zu den <a href="../misc/security_tips.html">Sicherheitshinweisen</a>.</strong></p>
779 <p>Die Verzeichnisabschnitte erscheinen in der Datei
780 <code>httpd.conf</code>. <code class="directive">&lt;Directory&gt;</code>-Direktiven dürfen nicht
781 ineinander verschachtelt werden oder innerhalb von <code class="directive"><a href="#limit">&lt;Limit&gt;</a></code>- oder <code class="directive"><a href="#limitexcept">&lt;LimitExcept&gt;</a></code>-Abschnitten auftauchen.</p>
783 <h3>Siehe auch</h3>
784 <ul>
785 <li><a href="../sections.html">Wie die Abschnitte &lt;Directory&gt;,
786 &lt;Location&gt; und &lt;Files&gt; arbeiten</a> für eine
787 Erläuterung, wie diese verschiedenen Abschnitte miteinander
788 kombiniert werden, wenn eine Anfrage empfangen wird</li>
789 </ul>
790 </div>
791 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
792 <div class="directive-section"><h2><a name="DirectoryMatch" id="DirectoryMatch">&lt;DirectoryMatch&gt;</a>-<a name="directorymatch" id="directorymatch">Direktive</a></h2>
793 <table class="directive">
794 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Umschließt eine Gruppe von Direktiven, die auf
795 Verzeichnisse des Dateisystems und ihre Unterverzeichnisse abgebildet
796 werden, welche auf einen regulären Ausdruck passen</td></tr>
797 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>&lt;DirectoryMatch <var>regex</var>&gt;
798 ... &lt;/DirectoryMatch&gt;</code></td></tr>
799 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Serverkonfiguration, Virtual Host</td></tr>
800 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
801 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
802 </table>
803 <p><code class="directive">&lt;DirectoryMatch&gt;</code> und
804 <code>&lt;/DirectoryMatch&gt;</code> werden dazu verwendet, eine
805 Gruppe von Direktiven zusammenzufassen, die nur für das
806 genannte Verzeichnis und dessen Unterverzeichnisse gelten, genauso
807 wie bei <code class="directive"><a href="#directory">&lt;Directory&gt;</a></code>.
808 Als Argument dient jedoch ein regulärer Ausdruck.
809 Beispielsweise würde</p>
811 <div class="example"><p><code>
812 &lt;DirectoryMatch "^/www/.*/[0-9]{3}"&gt;
813 </code></p></div>
815 <p>auf Verzeichnisse in <code>/www/</code> passen, die aus drei
816 Zeichen bestehen.</p>
818 <h3>Siehe auch</h3>
819 <ul>
820 <li><code class="directive"><a href="#directory">&lt;Directory&gt;</a></code>
821 für eine Beschreibung, wie reguläre Ausdrücke mit
822 normalen <code class="directive">&lt;Directory&gt;</code>-Anweisungen
823 vermischt werden.</li>
824 <li><a href="../sections.html">Wie die Abschnitte &lt;Directory&gt;,
825 &lt;Location&gt; und &lt;Files&gt; arbeiten</a> für eine
826 Erläuterung, wie diese verschiedenen Abschnitte miteinander
827 kombiniert werden, wenn eine Anfrage empfangen wird</li>
828 </ul>
829 </div>
830 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
831 <div class="directive-section"><h2><a name="DocumentRoot" id="DocumentRoot">DocumentRoot</a>-<a name="documentroot" id="documentroot">Direktive</a></h2>
832 <table class="directive">
833 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Verzeichnis, welches den Haupt-Dokumentenbaum bildet, der im
834 Web sichtbar ist.</td></tr>
835 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>DocumentRoot <var>Verzeichnis</var></code></td></tr>
836 <tr><th><a href="directive-dict.html#Default">Voreinstellung:</a></th><td><code>DocumentRoot /usr/local/apache/htdocs</code></td></tr>
837 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Serverkonfiguration, Virtual Host</td></tr>
838 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
839 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
840 </table>
841 <p>Die Direktive setzt das Verzeichnis, von dem aus
842 <code class="program"><a href="../programs/httpd.html">httpd</a></code> Dateien ausliefert. Sofern nicht eine Direktive
843 wie <code class="directive"><a href="../mod/mod_alias.html#alias">Alias</a></code> greift, hängt
844 der Server Pfade aus der angeforderten URL an das Wurzelverzeichnis
845 an, um den Pfad zum Dokument zu bilden. Beispiel:</p>
847 <div class="example"><p><code>
848 DocumentRoot /usr/web
849 </code></p></div>
851 <p>Damit bezieht sich ein Zugriff auf
852 <code>http://www.my.host.com/index.html</code> auf
853 <code>/usr/web/index.html</code>. Wenn das <var>Verzeichnis</var> nicht
854 absolut angegeben ist, wird es relativ zu <code class="directive"><a href="#serverroot">ServerRoot</a></code> betrachtet.</p>
856 <p><code class="directive">DocumentRoot</code> sollte ohne einen
857 Schrägstrich am Ende angegeben werden.</p>
859 <h3>Siehe auch</h3>
860 <ul>
861 <li><a href="../urlmapping.html">URLs auf das Dateisystem
862 abbilden</a></li>
863 </ul>
864 </div>
865 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
866 <div class="directive-section"><h2><a name="EnableMMAP" id="EnableMMAP">EnableMMAP</a>-<a name="enablemmap" id="enablemmap">Direktive</a></h2>
867 <table class="directive">
868 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Verwende Memory-Mapping, um Dateien während der
869 Auslieferung zu lesen</td></tr>
870 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>EnableMMAP On|Off</code></td></tr>
871 <tr><th><a href="directive-dict.html#Default">Voreinstellung:</a></th><td><code>EnableMMAP On</code></td></tr>
872 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Serverkonfiguration, Virtual Host, Verzeichnis, .htaccess</td></tr>
873 <tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>FileInfo</td></tr>
874 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
875 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
876 </table>
877 <p>Die Direktive steuert, ob <code class="program"><a href="../programs/httpd.html">httpd</a></code> Memory-Mapping
878 verwenden darf, wenn er während der Auslieferung den Inhalt einer
879 Datei lesen muss. Wenn die Bearbeitung einer Anfrage es erfordert,
880 auf die Daten in einer Datei zuzugreifen -- zum Beispiel bei der
881 Auslieferung einer mittels <code class="module"><a href="../mod/mod_include.html">mod_include</a></code> serverseitig
882 analysierten Datei --, dann verwendet der Apache standardmäßig
883 Memory-Mapping für diese Datei, sofern das Betriebssystem es
884 unterstützt.</p>
886 <p>Memory-Mapping bedeutet zuweilen eine Performanceverbesserung.
887 In einigen Umgebungen ist es jedoch besser, Memory-Mapping zu
888 deaktivieren, um Problemen während des Betriebs vorzubeugen:</p>
890 <ul>
891 <li>Bei einigen Multiprozessorsystemen kann Memory-Mapping die
892 Performance von <code class="program"><a href="../programs/httpd.html">httpd</a></code> reduzieren.</li>
893 <li>Bei einem per NFS eingebundenen <code class="directive"><a href="#documentroot">DocumentRoot</a></code> kann <code class="program"><a href="../programs/httpd.html">httpd</a></code> mit
894 einem Speicherzugriffsfehler <span class="transnote">(<em>Anm.d.Ü.:</em> ein so genannter "segmentation
895 fault")</span> abstürzen, wenn eine Datei gelöscht oder
896 gekürzt wird, während <code class="program"><a href="../programs/httpd.html">httpd</a></code> sie im Speicher
897 abbildet.</li>
898 </ul>
900 <p>Bei Serverkonfigurationen, die für dieses Problem
901 anfällig sind, sollten Sie das Memory-Mapping für
902 auszuliefernde Dateien deaktivieren, indem Sie schreiben:</p>
904 <div class="example"><p><code>
905 EnableMMAP Off
906 </code></p></div>
908 <p>Bei per NFS eingebundenen Dateien kann diese Funktion
909 explizit für die störenden Dateien deaktiviert werden,
910 indem Sie angeben:</p>
912 <div class="example"><p><code>
913 &lt;Directory "/pfad-zu-den-nfs-dateien"&gt;
914 <span class="indent">
915 EnableMMAP Off
916 </span>
917 &lt;/Directory&gt;
918 </code></p></div>
920 </div>
921 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
922 <div class="directive-section"><h2><a name="EnableSendfile" id="EnableSendfile">EnableSendfile</a>-<a name="enablesendfile" id="enablesendfile">Direktive</a></h2>
923 <table class="directive">
924 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Verwende die sendfile-Unterstützung des Kernels, um
925 Dateien an den Client auszuliefern</td></tr>
926 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>EnableSendfile On|Off</code></td></tr>
927 <tr><th><a href="directive-dict.html#Default">Voreinstellung:</a></th><td><code>EnableSendfile On</code></td></tr>
928 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Serverkonfiguration, Virtual Host, Verzeichnis, .htaccess</td></tr>
929 <tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>FileInfo</td></tr>
930 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
931 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
932 <tr><th><a href="directive-dict.html#Compatibility">Kompatibilität:</a></th><td>Verfügbar ab Apache Version 2.0.44</td></tr>
933 </table>
934 <p>Die Direktive steuert, ob <code class="program"><a href="../programs/httpd.html">httpd</a></code> die
935 sendfile-Unterstützung des Kernels verwenden kann, um
936 Dateiinhalte an den Client zu übermitteln. Wenn die Bearbeitung
937 einer Anfrage keinen Zugriff auf die Daten in der Datei erfordert --
938 zum Beispiel bei der Auslieferung einer statischen Datei -- und das
939 Betriebssystem es unterstützt, verwendet der Apache
940 standardmäßig sendfile, um den Dateiinhalt zu
941 übertragen, ohne die Datei jemals zu lesen.</p>
943 <p>Der sendfile-Mechanismus vermeidet getrennte Lese- und
944 Sendeoperationen sowie Puffer-Zuweisungen. Bei einigen Plattformen bzw.
945 Dateisystemen deaktivieren Sie diese Funktion jedoch besser, um Probleme
946 während des Betriebs zu vermeiden:</p>
948 <ul>
949 <li>Einige Plattformen besitzen u.U. eine fehlerhafte
950 sendfile-Unterstützung, die das Erstellungssystem nicht erkennt,
951 insbesondere wenn die Binärdateien auf einem anderen Rechner erstellt
952 und auf eine solche Maschine mit fehlerhafter sendfile-Unterstützung
953 übertragen wurden.</li>
954 <li>Bei einem über das Netzwerk eingebundenen <code class="directive"><a href="#documentroot">DocumentRoot</a></code> (z.B. NFS oder SMB) ist der
955 Kernel möglicherweise nicht in der Lage, die Netzwerkdatei
956 über seinen eigenen Cache zu bedienen.</li>
957 <li>Unter Linux löst die Verwendung von <code>sendfile</code>
958 in Verbindung mit bestimmten Netzwerkkarten und IPv6
959 TCP-Checksummenfehler aus.</li>
960 </ul>
962 <p>Bei Serverkonfigurationen, die für dieses Problam
963 anfällig sind, sollten die diese Funktion deaktivieren, indem
964 Sie schreiben:</p>
966 <div class="example"><p><code>
967 EnableSendfile Off
968 </code></p></div>
970 <p>Bei per NFS oder SMB eingebundenen Dateien kann diese Funktion
971 explizit für die störenden Dateien deaktiviert werden, indem
972 Sie angeben:</p>
974 <div class="example"><p><code>
975 &lt;Directory "/pfad-zu-den-nfs-dateien"&gt;
976 <span class="indent">
977 EnableSendfile Off
978 </span>
979 &lt;/Directory&gt;
980 </code></p></div>
981 <p>Beachten Sie bitte, dass die verzeichnisbasierte und
982 .htaccess-Konfiguration von <code class="directive">EnableSendfile</code>
983 nicht vom <code class="module"><a href="../mod/mod_disk_cache.html">mod_disk_cache</a></code>-Modul unterstützt wird.
984 Nur die globale Konfiguration von <code class="directive">EnableSendfile</code>
985 wird vom Modul beachtet.
986 </p>
988 </div>
989 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
990 <div class="directive-section"><h2><a name="ErrorDocument" id="ErrorDocument">ErrorDocument</a>-<a name="errordocument" id="errordocument">Direktive</a></h2>
991 <table class="directive">
992 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Das, was der Server im Fehlerfall an den Client
993 zurückgibt</td></tr>
994 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>ErrorDocument <var>Fehlercode</var> <var>Dokument</var></code></td></tr>
995 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Serverkonfiguration, Virtual Host, Verzeichnis, .htaccess</td></tr>
996 <tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>FileInfo</td></tr>
997 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
998 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
999 <tr><th><a href="directive-dict.html#Compatibility">Kompatibilität:</a></th><td>Die Syntax der Anführungszeichen bei Textnachrichten hat
1000 sich im Apache 2.0 geändert</td></tr>
1001 </table>
1002 <p>Im Falle eines Problems oder Fehlers kann der Apache
1003 konfiguriert werden, eine der vier Aktionen auszuführen:</p>
1005 <ol>
1006 <li>Ausgabe einer einfachen, hartkodierten Fehlermeldung</li>
1008 <li>Ausgabe einer angepassten Meldung</li>
1010 <li>Umleitung zu einem lokalen <var>URL-Pfad</var> der das
1011 Problem bzw. den Fehler behandelt</li>
1013 <li>Umleitung zu einer externen <var>URL</var>, die das Problem
1014 bzw. den Fehler behandelt</li>
1015 </ol>
1017 <p>Die erste Option ist Voreinstellung, während die Optionen
1018 2 bis 4 über die Direktive <code class="directive">ErrorDocument</code>
1019 eingestellt werden, welcher der HTTP-Statuscode und eine
1020 URL oder Nachricht folgen. Abhängig vom Problem bzw. Fehler bietet
1021 der Apache manchmal zusätzliche Informationen an.</p>
1023 <p>URLs können bei lokalen Webpfaden mit einem Schrägstrich
1024 (/) beginnen (relativ zum <code class="directive"><a href="#documentroot">DocumentRoot</a></code>-Verzeichnis) oder eine vollständige URL
1025 bilden, die der Client auflösen kann. Alternativ kann eine
1026 Nachricht für die Anzeige im Browser angeboten werden. Beispiel:</p>
1028 <div class="example"><p><code>
1029 ErrorDocument 500 http://foo.example.com/cgi-bin/tester<br />
1030 ErrorDocument 404 /cgi-bin/falsche_urls.pl<br />
1031 ErrorDocument 401 /info_zur_anmeldung.html<br />
1032 ErrorDocument 403 "Der Zugriff ist nicht erlaubt."
1033 </code></p></div>
1035 <p>Außerdem kann der spezielle Wert <code>default</code> angegeben
1036 werden, um die schlichte, hartkodierte Nachricht des Apache zu verwenden.
1037 Es wird normalerweise nicht benötigt, doch <code>default</code>
1038 stellt die einfach, im Apache hartkodierte Meldung in Konfigurationen
1039 wieder her, die ansonsten von einem existierenden <span class="transnote">(<em>Anm.d.Ü.:</em> zuvor
1040 konfigurierten)</span> <code class="directive">ErrorDocument</code> erben
1041 würden.</p>
1043 <div class="example"><p><code>
1044 ErrorDocument 404 /cgi-bin/bad_urls.pl<br /><br />
1045 &lt;Directory /web/docs&gt;<br />
1046 <span class="indent">
1047 ErrorDocument 404 default<br />
1048 </span>
1049 &lt;/Directory&gt;
1050 </code></p></div>
1052 <p>Wenn Sie eine <code class="directive">ErrorDocument</code>-Anweisung
1053 angeben, die auf eine entfernte URL weist (d.h. irgendetwas mit der
1054 Methode <code>http</code> davor), beachten Sie bitte, dass der Apache
1055 eine Umleitung zum Client sendet, um diesem mitzuteilen, wo das
1056 Dokument zu finden ist, auch wenn das Dokument letztlich wieder zum
1057 gleichen Server führt. Das hat mehrere Auswirkungen. Die
1058 wichtigste ist, dass der Client nicht den Original-Statuscode
1059 erhält sondern statt dessen einen Umleitungs-Statuscode. Dies
1060 wiederum kann Web-Robots und andere Clients verwirren, die den
1061 Statuscode dazu verwenden, herauszufinden ob eine URL gültig ist.
1062 Wenn Sie eine entfernte URL in einer Anweisung
1063 <code>ErrorDocument 401</code> verwenden, wird der Client
1064 darüber hinaus nicht wissen, dass er den Benutzer zur Eingabe
1065 eines Passwortes auffordern muss, da er den Statuscode 401 nicht
1066 erhält. <strong>Deshalb müssen Sie sich auf ein lokales
1067 Dokument beziehen, wenn Sie eine Anweisung <code>ErrorDocument
1068 401</code> verwenden.</strong></p>
1070 <p>Der Microsoft Internet Explorer (MSIE) ignoriert
1071 standardmäßig serverseitig generierte Fehlermeldungen, wenn
1072 sie "zu kurz" sind und ersetzt sie durch eigene "freundliche"
1073 Fehlermeldungen. Die Größe variiert abhängig von der
1074 Art des Fehlers, im Allgemeinen zeigt der MSIE jedoch den
1075 serverseitig generierten Fehler, anstatt ihn zu verstecken, wenn Ihr
1076 Fehlerdokument größer als 512 Bytes ist. Weitere Informationen
1077 sind im Artikel <a href="http://support.microsoft.com/default.aspx?scid=kb;en-us;Q294807">Q294807</a> in der Microsoft Knowledgebase verfügbar.</p>
1079 <p>Obwohl die meisten Fehlermeldungen überschrieben werden
1080 können, werden unter bestimmten Umständen die internen
1081 Meldungen ungeachtet der Einstellung der <code class="directive"><a href="#errordocument">ErrorDocument</a></code>-Direktive verwendet. Insbesondere bei
1082 einer fehlerhaften Anfrage werden der normale Bearbeitungsprozess sofort
1083 beendet und die interne Meldung zurückgegeben. Das ist notwendig, um
1084 Sicherheitsprobleme zu vermeiden, die auf Grund fehlerhafter Anfragen
1085 entstehen.</p>
1087 <p>In Versionen vor 2.0 wurden Meldungen durch ein einzelnes
1088 vorangestelltes Anführungszeichen (") erkannt.</p>
1090 <h3>Siehe auch</h3>
1091 <ul>
1092 <li><a href="../custom-error.html">Dokumentation zu individuellen
1093 Fehlermeldungen</a></li>
1094 </ul>
1095 </div>
1096 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
1097 <div class="directive-section"><h2><a name="ErrorLog" id="ErrorLog">ErrorLog</a>-<a name="errorlog" id="errorlog">Direktive</a></h2>
1098 <table class="directive">
1099 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Ablageort, an dem der Server Fehler protokolliert</td></tr>
1100 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code> ErrorLog <var>Dateiname</var>|syslog[:<var>facility</var>]</code></td></tr>
1101 <tr><th><a href="directive-dict.html#Default">Voreinstellung:</a></th><td><code>ErrorLog logs/error_log (Unix) ErrorLog logs/error.log (Windows and
1102 OS/2)</code></td></tr>
1103 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Serverkonfiguration, Virtual Host</td></tr>
1104 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
1105 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
1106 </table>
1107 <p>Die Direktive <code class="directive">ErrorLog</code> bestimmt den Namen
1108 der Datei, in welcher der Server alle auftretenden Fehler protokolliert.
1109 Wenn <var>Dateiname</var> nicht absolut ist, wird er relativ zu <code class="directive"><a href="#serverroot">ServerRoot</a></code> betrachtet.</p>
1111 <div class="example"><h3>Beispiel</h3><p><code>
1112 ErrorLog /var/log/httpd/error_log
1113 </code></p></div>
1115 <p>Wenn der <var>Dateiname</var> mit einem senkrechten Strich (|,
1116 engl.: Pipe) beginnt, wird angenommen, dass es sich um einen Befehl
1117 handelt, der ausgeführt wird, um das Fehlerprotokolls zu
1118 verarbeiten.</p>
1120 <div class="example"><h3>Beispiel</h3><p><code>
1121 ErrorLog "|/usr/local/bin/httpd_errors"
1122 </code></p></div>
1124 <p>Die Verwendung von <code>syslog</code> anstelle eines Dateinamens
1125 aktiviert die Protokollierung mittels syslogd(8), sofern das System
1126 es unterstützt. Als Voreinstellung wird der syslog-Typ (syslog
1127 facility) <code>local7</code> verwendet, Sie können dies jedoch
1128 auch überschreiben, indem Sie die Syntax
1129 <code>syslog:<var>facility</var></code> verwenden, wobei
1130 <var>facility</var> einer der Namen sein kann, die üblicherweise
1131 in syslog(1) dokumentiert sind.</p>
1133 <div class="example"><h3>Beispiel</h3><p><code>
1134 ErrorLog syslog:user
1135 </code></p></div>
1137 <p>SICHERHEITSHINWEIS: Lesen Sie das Dokument <a href="../misc/security_tips.html#serverroot">Sicherheitshinweise</a>
1138 zu Einzelheiten darüber, warum Ihre Sicherheit gefährdet
1139 sein kann, wenn das Verzeichnis, in dem die Log-Dateien gespeichert
1140 werden, für jemand anderen, als den Benutzer, der den Server
1141 gestartet hat, beschreibbar ist.</p>
1143 <div class="warning"><h3>Anmerkung</h3>
1144 <p>Bei der Eingabe eines Dateipfads auf nicht-Unix-Plattformen sollte
1145 darauf geachtet werden, nur (Vorwärts-)Schrägstriche zu
1146 verwenden, auch wenn die Plattform rückwärts gerichtete
1147 Schrägstriche (Backslashes) erlaubt. Im Allgemeinen ist es eine gute
1148 Idee, innerhalb der Konfigurationsdateien immer
1149 Vorwärts-Schrägstriche zu verwenden.</p>
1150 </div>
1152 <h3>Siehe auch</h3>
1153 <ul>
1154 <li><code class="directive"><a href="#loglevel">LogLevel</a></code></li>
1155 <li><a href="../logs.html">Apache-Log-Dateien</a></li>
1156 </ul>
1157 </div>
1158 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
1159 <div class="directive-section"><h2><a name="FileETag" id="FileETag">FileETag</a>-<a name="fileetag" id="fileetag">Direktive</a></h2>
1160 <table class="directive">
1161 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Dateiattribute, die zur Erstellung des HTTP-Response-Headers
1162 ETag verwendet werden</td></tr>
1163 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>FileETag <var>Komponente</var> ...</code></td></tr>
1164 <tr><th><a href="directive-dict.html#Default">Voreinstellung:</a></th><td><code>FileETag INode MTime Size</code></td></tr>
1165 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Serverkonfiguration, Virtual Host, Verzeichnis, .htaccess</td></tr>
1166 <tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>FileInfo</td></tr>
1167 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
1168 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
1169 </table>
1170 <p>Wenn dem Dokument eine Datei zugrundeliegt, bestimmt die Direktive
1171 <code class="directive">FileETag</code> die Dateiattribute, die zur Erstellung
1172 des HTTP-Response-Headers <code>ETag</code> (Entity-Tag) verwendet
1173 werden. (Der Wert von <code>ETag</code> wird bei der Cache-Verwaltung
1174 zur Einsparung von Netzwerk-Bandbreite benutzt.) Im Apache 1.3.22 und
1175 früher wurde der <code>ETag</code>-Wert <em>stets</em> aus
1176 der I-Node, der Größe und dem Datum der letzten
1177 Änderung (mtime) der Datei gebildet. Die Direktive
1178 <code class="directive">FileETag</code> erlaubt es Ihnen, zu bestimmen,
1179 welche dieser Eigenschaften -- falls überhaupt -- verwendet
1180 werden sollen. Die gültigen Schlüsselworte lauten:</p>
1182 <dl>
1183 <dt><strong>INode</strong></dt>
1184 <dd>Die I-Node-Nummer wird in die Berechnung mit einbezogen</dd>
1185 <dt><strong>MTime</strong></dt>
1186 <dd>Datum und Uhrzeit der letzten Änderung werden mit einbezogen</dd>
1187 <dt><strong>Size</strong></dt>
1188 <dd>Die Anzahl der Bytes in der Datei wird mit einbezogen</dd>
1189 <dt><strong>All</strong></dt>
1190 <dd>Alle verfügbaren Angaben werden verwendet. Die ist
1191 gleichbedeutend mit:
1192 <div class="example"><p><code>FileETag INode MTime Size</code></p></div></dd>
1193 <dt><strong>None</strong></dt>
1194 <dd>Es wird keine <code>ETag</code>-Angabe in die Antwort eingefügt,
1195 wenn dem Dokument eine Datei zugrundeliegt.</dd>
1196 </dl>
1198 <p>Den Schlüsselwörtern <code>INode</code>, <code>MTime</code>
1199 und <code>Size</code> kann entweder ein <code>+</code> oder ein
1200 <code>-</code> vorangestellt werden, was die Änderung einer
1201 Vorgabe erlaubt, die von einem größeren Umfeld
1202 geerbt wurde. Jedes Schlüselwort ohne ein solches Prefix
1203 hebt die ererbte Einstellung sofort und vollständig auf.</p>
1205 <p>Wenn die Konfiguration für ein Verzeichnis
1206 <code>FileETag&nbsp;INode&nbsp;MTime&nbsp;Size</code> enthält
1207 und die eines Unterverzeichnisses <code>FileETag&nbsp;-INode</code>,
1208 dann ist die Einstellung für das Unterverzeichnis (die an
1209 jedes Unter-Unterverzeichnis weitervererbt wird, welches dies nicht
1210 überschreibt) äquivalent mit
1211 <code>FileETag&nbsp;MTime&nbsp;Size</code>.</p>
1213 </div>
1214 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
1215 <div class="directive-section"><h2><a name="Files" id="Files">&lt;Files&gt;</a>-<a name="files" id="files">Direktive</a></h2>
1216 <table class="directive">
1217 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Enthält Direktiven, die sich nur auf passende Dateinamen
1218 beziehen</td></tr>
1219 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>&lt;Files <var>Dateiname</var>&gt; ... &lt;/Files&gt;</code></td></tr>
1220 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Serverkonfiguration, Virtual Host, Verzeichnis, .htaccess</td></tr>
1221 <tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>All</td></tr>
1222 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
1223 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
1224 </table>
1225 <p>Die Direktive <code class="directive">&lt;Files&gt;</code>
1226 begrenzt die Reichweite der enthaltenen Anweisungen auf Dateinamen.
1227 Sie ist vergleichbar mit den Direktiven <code class="directive"><a href="#directory">&lt;Directory&gt;</a></code> und <code class="directive"><a href="#location">&lt;Location&gt;</a></code>. Sie muss eine
1228 passende <code>&lt;/Files&gt;</code>-Anweisung besitzen.
1229 Die innerhalb dieses Abschnittes angegebenen Direktiven werden auf
1230 jedes Objekt mit einem Basisnamen (letzte Komponente des Dateinamens)
1231 angewendet, der auf die angegebenen Dateinamen passt. <code class="directive">&lt;Files&gt;</code>-Container werden, nachdem die
1232 <code class="directive"><a href="#directory">&lt;Directory&gt;</a></code>-Container
1233 und <code>.htaccess</code>-Dateien gelesen sind, jedoch vor den
1234 <code class="directive"><a href="#location">&lt;Location&gt;</a></code>-Containern,
1235 in der Reihenfolge ihres Auftretens ausgeführt. Beachten Sie, dass
1236 <code class="directive">&lt;Files&gt;</code>-Anweisungen innerhalb von
1237 <code class="directive"><a href="#directory">&lt;Directory&gt;</a></code>-Containern
1238 auftreten können, um den Teil des Dateisystems einzuschränken,
1239 den sie betreffen.</p>
1241 <p>Das Argument <var>Dateiname</var> kann einen Dateinamen oder eine
1242 Zeichenkette mit Platzhaltern enthalten, wobei <code>?</code> auf ein
1243 einzelnes Zeichen passt und <code>*</code> auf eine beliebige Folge von
1244 Zeichen. Erweiterte reguläre Ausdrücke können ebenfalls
1245 verwendet werden, indem das Zeichen <code>~</code> hinzugefügt wird.
1246 Beispielsweise würde</p>
1248 <div class="example"><p><code>
1249 &lt;Files ~ "\.(gif|jpe?g|png)$"&gt;
1250 </code></p></div>
1252 <p>auf die gebräuchlichsten Grafikformate im Internet passen.
1253 <code class="directive"><a href="#filesmatch">&lt;FilesMatch&gt;</a></code> wird
1254 jedoch bevorzugt.</p>
1256 <p>Beachten Sie bitte, dass die <code class="directive">&lt;Files&gt;</code>-Container anders als <code class="directive"><a href="#directory">&lt;Directory&gt;</a></code>- und <code class="directive"><a href="#location">&lt;Location&gt;</a></code>-Container innerhalb
1257 von <code>.htaccess</code>-Dateien verwendet werden können.
1258 Dies erlaubt den Anwendern auf Dateiebene die Kontrolle über ihre
1259 eigenen Dateien.</p>
1261 <h3>Siehe auch</h3>
1262 <ul>
1263 <li><a href="../sections.html">Wie die Abschnitte &lt;Directory&gt;,
1264 &lt;Location&gt; und &lt;Files&gt; arbeiten</a> für eine
1265 Erläuterung, wie diese verschiedenen Abschnitte miteinander
1266 kombiniert werden, wenn eine Anfrage empfangen wird</li>
1267 </ul>
1268 </div>
1269 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
1270 <div class="directive-section"><h2><a name="FilesMatch" id="FilesMatch">&lt;FilesMatch&gt;</a>-<a name="filesmatch" id="filesmatch">Direktive</a></h2>
1271 <table class="directive">
1272 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Enthält Direktiven, die für Dateinamen gelten, die
1273 auf einen regulären Ausdruck passen</td></tr>
1274 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>&lt;FilesMatch <var>regex</var>&gt; ... &lt;/FilesMatch&gt;</code></td></tr>
1275 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Serverkonfiguration, Virtual Host, Verzeichnis, .htaccess</td></tr>
1276 <tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>All</td></tr>
1277 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
1278 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
1279 </table>
1280 <p>Die Direktive <code class="directive">&lt;FilesMatch&gt;</code>
1281 begrenzt wie die Direktive <code class="directive"><a href="#files">&lt;Files&gt;</a></code> die enthaltenen Anweisungen auf
1282 Dateinamen. Sie akzeptiert jedoch reguläre Ausdrücke.
1283 Beispielsweise würde</p>
1285 <div class="example"><p><code>
1286 &lt;FilesMatch "\.(gif|jpe?g|png)$"&gt;
1287 </code></p></div>
1289 <p>auf die gebräuchlichsten Grafikformate im Internet passen.</p>
1291 <h3>Siehe auch</h3>
1292 <ul>
1293 <li><a href="../sections.html">Wie die Abschnitte &lt;Directory&gt;,
1294 &lt;Location&gt; und &lt;Files&gt; arbeiten</a> für eine
1295 Erläuterung, wie diese verschiedenen Abschnitte miteinander
1296 kombiniert werden, wenn eine Anfrage empfangen wird</li>
1297 </ul>
1298 </div>
1299 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
1300 <div class="directive-section"><h2><a name="ForceType" id="ForceType">ForceType</a>-<a name="forcetype" id="forcetype">Direktive</a></h2>
1301 <table class="directive">
1302 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Erzwingt die Auslieferung aller passendenden Dateien mit dem
1303 angegebenen MIME-Content-Type</td></tr>
1304 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>ForceType <var>MIME-Type</var>|None</code></td></tr>
1305 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Verzeichnis, .htaccess</td></tr>
1306 <tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>FileInfo</td></tr>
1307 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
1308 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
1309 <tr><th><a href="directive-dict.html#Compatibility">Kompatibilität:</a></th><td>Wurde im Apache 2.0 in den Core verschoben</td></tr>
1310 </table>
1311 <p>Wenn sie innerhalb einer <code>.htaccess</code>-Datei, eines
1312 <code class="directive"><a href="#directory">&lt;Directory&gt;</a></code>-,
1313 <code class="directive"><a href="#location">&lt;Location&gt;</a></code>-
1314 <code class="directive"><a href="#files">&lt;Files&gt;</a></code>-Containers
1315 angegeben wird, erzwingt die Direktive die Auslieferung aller
1316 entsprechenden Dateien mit dem Content-Type, der durch
1317 <var>MIME-Type</var> definiert wurde. Wenn Sie zum Beispiel ein
1318 Verzeichnis voller GIF-Dateien haben, die Sie nicht alle durch
1319 <code>.gif</code> kennzeichnen wollen, können Sie angeben:</p>
1321 <div class="example"><p><code>
1322 ForceType image/gif
1323 </code></p></div>
1325 <p>Beachten Sie bitte, dass die Direktive anders als <code class="directive"><a href="#defaulttype">DefaultType</a></code> alle MIME-Type-Zuordnungen
1326 überschreibt, einschließlich Dateiendungen, die einen
1327 Medientyp bezeichnen könnten.</p>
1329 <p>Sie können jede <code class="directive">ForceType</code>-Angabe
1330 durch die Verwendung des Wertes <code>None</code> überschreiben:</p>
1332 <div class="example"><p><code>
1333 # erzwinge image/gif für alle Dateien:<br />
1334 &lt;Location /images&gt;<br />
1335 <span class="indent">
1336 ForceType image/gif<br />
1337 </span>
1338 &lt;/Location&gt;<br />
1339 <br />
1340 # hier jedoch normale MIME-Type-Zuordnungen:<br />
1341 &lt;Location /images/mixed&gt;<br />
1342 <span class="indent">
1343 ForceType None<br />
1344 </span>
1345 &lt;/Location&gt;
1346 </code></p></div>
1348 </div>
1349 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
1350 <div class="directive-section"><h2><a name="HostnameLookups" id="HostnameLookups">HostnameLookups</a>-<a name="hostnamelookups" id="hostnamelookups">Direktive</a></h2>
1351 <table class="directive">
1352 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Aktiviert DNS-Lookups auf Client-IP-Adressen</td></tr>
1353 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>HostnameLookups On|Off|Double</code></td></tr>
1354 <tr><th><a href="directive-dict.html#Default">Voreinstellung:</a></th><td><code>HostnameLookups Off</code></td></tr>
1355 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Serverkonfiguration, Virtual Host, Verzeichnis</td></tr>
1356 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
1357 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
1358 </table>
1359 <p>Diese Direktive aktiviert die DNS-Abfrage <span class="transnote">(<em>Anm.d.Ü.:</em> ein sogenannter
1360 DNS-Lookup)</span>, so dass Hostnamen protokolliert (und in
1361 <code>REMOTE_HOST</code> an CGIs/SSIs übergeben) werden könnnen.
1362 Der Wert <code>Double</code> bezieht sich auf ein
1363 Double-Reverse-DNS-Lookup. D.h. nachdem ein Reverse-Lookup
1364 durchgeführt wurde, wird dann auf dem Ergebnis ein
1365 Forward-Lookup ausgeführt. Wenigstens eine der IP-Adressen
1366 aus dem Forward-Lookup muss der Originaladresse entsprechen.
1367 (In der "tcpwrappers"-Terminologie wird dies <code>PARANOID</code>
1368 genannt.)</p>
1370 <p>Unabhängig von der Einstellung wird ein Double-Reverse-Lookup
1371 durchgeführt, wenn <code class="module"><a href="../mod/mod_authz_host.html">mod_authz_host</a></code> zur
1372 Zugriffskontrolle per Hostnamen eingesetzt wird. Dies ist aus
1373 Sicherheitsgründen notwendig. Beachten Sie, dass das Ergebnis dieses
1374 Double-Reverse-Lookups nicht generell verfügbar ist, solange Sie
1375 nicht <code>HostnameLookups Double</code> setzen. Wenn beispielsweise
1376 nur <code>HostnameLookups On</code> angegeben ist und eine Anfrage
1377 für ein Objekt erfolgt, welches durch Hostnamen-Beschränkungen
1378 geschützt ist, dann wird CGIs nur das Ergebnis des
1379 Singel-Reverse-Lookups in <code>REMOTE_HOST</code> übergeben,
1380 egal ob das Doble-Reverse-Lookup fehlschlug oder nicht.</p>
1382 <p>Die Voreinstellung ist <code>Off</code>, um Netzwerktraffic bei den
1383 Angeboten einzusparen, die nicht tatsächlich Reverse-Lookups
1384 benötigen. Es ist auch für die Endanwender besser, da sie nicht
1385 die zusätzliche Wartezeit ertragen müssen, die ein Lookup mit
1386 sich bringt. Hoch frequentierte Angebote sollten diese Direktive auf
1387 <code>Off</code>lassen. Das Hilfsprogramm <code class="program"><a href="../programs/logresolve.html">logresolve</a></code>, das standardmäßig in das
1388 Unterverzeichnis <code>bin</code> Ihres Installationsverzeichnisses
1389 kompiliert wird, kann dazu verwendet werden, um offline Hostnamen von
1390 protokollierten IP-Adressen nachzuschlagen.</p>
1392 </div>
1393 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
1394 <div class="directive-section"><h2><a name="IfDefine" id="IfDefine">&lt;IfDefine&gt;</a>-<a name="ifdefine" id="ifdefine">Direktive</a></h2>
1395 <table class="directive">
1396 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Schließt Direktiven ein, die nur ausgeführt werden,
1397 wenn eine Testbedingung beim Start wahr ist</td></tr>
1398 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>&lt;IfDefine [!]<var>Parametername</var>&gt; ...
1399 &lt;/IfDefine&gt;</code></td></tr>
1400 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Serverkonfiguration, Virtual Host, Verzeichnis, .htaccess</td></tr>
1401 <tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>All</td></tr>
1402 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
1403 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
1404 </table>
1405 <p>Der Container <code>&lt;IfDefine <var>Test</var>&gt;...&lt;/IfDefine&gt;
1406 </code> wird dazu verwendet, Direktiven als bedingt zu kennzeichnen.
1407 Die Direktiven innerhalb eines <code class="directive">&lt;IfDefine&gt;</code>-Abschnittes werden nur ausgeführt,
1408 wenn <var>Test</var> wahr ist. Ist <var>Test</var> falsch, wird alles
1409 zwischen der Start- und Endemarkierung ignoriert.</p>
1411 <p>In der <code class="directive">&lt;IfDefine&gt;</code>-Anweisung kann
1412 <var>Test</var> eine von zwei Formen annehmen:</p>
1414 <ul>
1415 <li><var>Parametername</var></li>
1417 <li><code>!</code><var>Parametername</var></li>
1418 </ul>
1420 <p>Im ersten Fall werden die Direktiven zwischen der Start- und
1421 Endemarkierung nur ausgeführt, wenn der Parameter namens
1422 <var>Parametername</var> definiert ist. Die zweite Form kehrt den
1423 Test um und führt die Direktiven nur dann aus, wenn
1424 <var>Parametername</var> <strong>nicht</strong> definiert ist.</p>
1426 <p>Das Argument <var>Parametername</var> ist ein sogenanntes
1427 "Define", das beim beim Start des Servers in der
1428 <code class="program"><a href="../programs/httpd.html">httpd</a></code>-Befehlszeile durch
1429 <code>-D<var>Parameter</var></code> angegeben wird.</p>
1431 <p><code class="directive">&lt;IfDefine&gt;</code>-Container können
1432 ineinander verschachtelt werden, um einfache Multi-Parameter-Tests
1433 zu implementieren. Beispiel:</p>
1435 <div class="example"><p><code>
1436 httpd -DReverseProxy ...<br />
1437 <br />
1438 # httpd.conf<br />
1439 &lt;IfDefine ReverseProxy&gt;<br />
1440 <span class="indent">
1441 LoadModule rewrite_module modules/mod_rewrite.so<br />
1442 LoadModule proxy_module modules/libproxy.so<br />
1443 </span>
1444 &lt;/IfDefine&gt;
1445 </code></p></div>
1447 </div>
1448 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
1449 <div class="directive-section"><h2><a name="IfModule" id="IfModule">&lt;IfModule&gt;</a>-<a name="ifmodule" id="ifmodule">Direktive</a></h2>
1450 <table class="directive">
1451 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Schließt Direktiven ein, die abhängig vom
1452 Vorhandensein oder Fehlen eines speziellen Moduls ausgeführt
1453 werden</td></tr>
1454 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>&lt;IfModule [!]<var>Modulname</var>|<var>Modulbezeichner</var>&gt;
1455 ... &lt;/IfModule&gt;</code></td></tr>
1456 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Serverkonfiguration, Virtual Host, Verzeichnis, .htaccess</td></tr>
1457 <tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>All</td></tr>
1458 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
1459 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
1460 <tr><th><a href="directive-dict.html#Compatibility">Kompatibilität:</a></th><td>Modulbezeichner sind ab Version 2.1
1461 verfügbar.</td></tr>
1462 </table>
1463 <p>Der Container <code>&lt;IfModule
1464 <var>Test</var>&gt;...&lt;/IfModule&gt;</code> wird dazu verwendet,
1465 Direktiven als abhängig von dem Vorhandensein eines speziellen
1466 Moduls zu kennzeichnen. Die Direktiven innerhalb eines <code class="directive">&lt;IfModule&gt;</code>-Abschnitts werden nur
1467 ausgeführt, wenn <var>Test</var> wahr ist. Ist <var>Test</var>
1468 falsch, wird alles zwischen der Start- und Endemarkierung ignoriert.</p>
1470 <p>In der <code class="directive">&lt;IfModule&gt;</code>-Anweisung
1471 kann <var>Test</var> eine von zwei Formen annehmen:</p>
1473 <ul>
1474 <li><var>Modul</var></li>
1476 <li><code>!</code><var>Modul</var></li>
1477 </ul>
1479 <p>Im ersten Fall werden die Direktiven zwischen der Start- und
1480 Endemarkierung nur ausgeführt, das Modul namens
1481 <var>Modul</var> im Apache enthalten ist -- entweder einkompiliert
1482 oder mittels <code class="directive"><a href="../mod/mod_so.html#loadmodule">LoadModule</a></code>
1483 dynamisch geladen. Die zweite Form dreht den Test um und führt die
1484 Direktiven nur aus, wenn <var>Modul</var> <strong>nicht</strong>
1485 enthalten ist.</p>
1487 <p>Das Argument <var>Modul</var> kann entweder der Modulbezeichner oder
1488 der Dateiname des Moduls zum Zeitpunkt seiner Kompilierung sein.
1489 <code>rewrite_module</code> beispielsweise ist der Bezeichner und
1490 <code>mod_rewrite.c</code> ist der Dateiname. Wenn ein Modul aus mehreren
1491 Quelltext-Dateien besteht, verwenden Sie den Namen der Datei, welche die
1492 Zeichenfolge <code>STANDARD20_MODULE_STUFF</code> enthält.</p>
1494 <p><code class="directive">&lt;IfModule&gt;</code>-Container können
1495 inneinander verschachtelt werden, um einfache Multi-Modul-Tests
1496 durchzuführen.</p>
1498 <p>Dieser Container sollte verwendet werden, wenn Sie eine
1499 Konfigurationsdatei benötigen, die unabhängig davon funktioniert,
1500 ob ein bestimmtes Modul verfügbar ist oder nicht. Normalerweise
1501 ist es nicht notwendig, Direktiven in <code class="directive">&lt;IfModule&gt;</code>-Containern unterzubringen.</p>
1503 </div>
1504 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
1505 <div class="directive-section"><h2><a name="Include" id="Include">Include</a>-<a name="include" id="include">Direktive</a></h2>
1506 <table class="directive">
1507 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Fügt andere Konfigurationsdateien innerhalb der
1508 Server-Konfigurationsdatei ein</td></tr>
1509 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>Include <var>Dateiname</var>|<var>Verzeichnis</var></code></td></tr>
1510 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Serverkonfiguration, Virtual Host, Verzeichnis</td></tr>
1511 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
1512 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
1513 <tr><th><a href="directive-dict.html#Compatibility">Kompatibilität:</a></th><td>Die Platzhalter-Suche ist verfügbar seit
1514 2.0.41</td></tr>
1515 </table>
1516 <p>Die Direktive erlaubt das Einfügen anderer Konfigurationsdateien
1517 in die Konfigurationsdatei des Servers.</p>
1519 <p>Shell-typische (<code>fnmatch()</code>) Platzhlaterzeichen können
1520 dazu verwendet werden, mehrere Dateien auf einmal in alphabetischer
1521 Reihenfolge einzufügen. Wenn <code class="directive">Include</code>
1522 darüber hinaus auf ein Verzeichnis anstatt auf eine Datei zeigt,
1523 liest der Apache alle Dateien in diesem Verzeichnis und allen
1524 Unterverzeichnissen ein. Das Einfügen ganzer Verzeichnisse ist
1525 jedoch nicht empfehlenswert, da temporäre Dateien sehr leicht
1526 versehentlich in einem Verzeichnis zurückgelassen werden, was
1527 <code class="program"><a href="../programs/httpd.html">httpd</a></code> scheitern lassen kann.</p>
1529 <p>Der angegebene Dateiname kann ein absoluter Pfad sein oder relativ zum
1530 <code class="directive"><a href="#serverroot">ServerRoot</a></code>-Verzeichnis angegeben
1531 werden.</p>
1533 <p>Beispiele:</p>
1535 <div class="example"><p><code>
1536 Include /usr/local/apache2/conf/ssl.conf<br />
1537 Include /usr/local/apache2/conf/vhosts/*.conf
1538 </code></p></div>
1540 <p>Oder Sie geben Pfade relativ zu Ihrem <code class="directive"><a href="#serverroot">ServerRoot</a></code>-Verzeichnis an:</p>
1542 <div class="example"><p><code>
1543 Include conf/ssl.conf<br />
1544 Include conf/vhosts/*.conf
1545 </code></p></div>
1547 <p>Der Aufruf von <code>apachectl configtest</code> liefert eine Liste
1548 der Dateien, die während des Konfigurations-Tests verarbeitet
1549 werden:</p>
1551 <div class="example"><p><code>
1552 root@host# apachectl configtest<br />
1553 Processing config file: /usr/local/apache2/conf/ssl.conf<br />
1554 Processing config file: /usr/local/apache2/conf/vhosts/vhost1.conf<br />
1555 Processing config file: /usr/local/apache2/conf/vhosts/vhost2.conf<br />
1556 Syntax OK
1557 </code></p></div>
1559 <h3>Siehe auch</h3>
1560 <ul>
1561 <li><code class="program"><a href="../programs/apachectl.html">apachectl</a></code></li>
1562 </ul>
1563 </div>
1564 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
1565 <div class="directive-section"><h2><a name="KeepAlive" id="KeepAlive">KeepAlive</a>-<a name="keepalive" id="keepalive">Direktive</a></h2>
1566 <table class="directive">
1567 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Aktiviert persistente HTTP-Verbindungen</td></tr>
1568 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>KeepAlive On|Off</code></td></tr>
1569 <tr><th><a href="directive-dict.html#Default">Voreinstellung:</a></th><td><code>KeepAlive On</code></td></tr>
1570 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Serverkonfiguration, Virtual Host</td></tr>
1571 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
1572 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
1573 </table>
1574 <p>Die Keep-Alive-Erweiterung von HTTP/1.0 und die
1575 HTTP/1.1-Funktionalität persistenter Verbindungen unterstützt
1576 langlebige HTTP-Sitzungen, die es erlauben, mehrere Anfragen über
1577 die gleich TCP-Verbindung zu senden. In einigen Fällen wurde eine
1578 Beschleunigung der Wartezeiten von beinahe 50% für HTML-Dokumente
1579 mit vielen Bildern festgestellt. Um Keep-Alive-Verbindungen zu aktivieren,
1580 setzen Sie <code>KeepAlive On</code>.</p>
1582 <p>Bei HTTP/1.0-Clients werden Keep-Alive-Verbindungen nur dann verwendet,
1583 wenn sie vom Client eigens angefordert werden. Desweiteren können
1584 Keep-Alive-Verbindungen bei einem HTTP/1.0-Client nur dann verwendet
1585 werden, wenn die Länge des Inhalts im Voraus bekannt ist. Dies
1586 impliziert, dass dynamische Inhalte wie CGI-Ausgaben, SSI-Seiten und
1587 servergenerierte Verzeichnisauflistungen im Allgemeinen keine
1588 Keep-Alive-Verbindungen mit HTTP/1.0-Clients verwenden. Bei
1589 HTTP/1.1-Clients sind Keep-Alive-Verbindungen Voreinstellung, solange
1590 nichts anderes angegeben ist. Wenn der Client es anfordert, wird
1591 Chunked-Encoding verwendet, um Inhalte mit unbekannter Länge
1592 über persistente Verbindungen zu senden.</p>
1594 <h3>Siehe auch</h3>
1595 <ul>
1596 <li><code class="directive"><a href="#maxkeepaliverequests">MaxKeepAliveRequests</a></code></li>
1597 </ul>
1598 </div>
1599 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
1600 <div class="directive-section"><h2><a name="KeepAliveTimeout" id="KeepAliveTimeout">KeepAliveTimeout</a>-<a name="keepalivetimeout" id="keepalivetimeout">Direktive</a></h2>
1601 <table class="directive">
1602 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Zeitspanne, die der Server während persistenter Verbindungen
1603 auf nachfolgende Anfragen wartet</td></tr>
1604 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>KeepAliveTimeout <var>Sekunden</var></code></td></tr>
1605 <tr><th><a href="directive-dict.html#Default">Voreinstellung:</a></th><td><code>KeepAliveTimeout 5</code></td></tr>
1606 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Serverkonfiguration, Virtual Host</td></tr>
1607 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
1608 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
1609 </table>
1610 <p>Dies legt die Anzahl der Sekunden fest, die der Apache auf weitere
1611 Anfragen wartet, bevor er die Verbindung schließt. Nachdem einmal
1612 eine Anfrage entgegen genommen wurde, wird die durch die Direktive
1613 <code class="directive"><a href="#timeout">Timeout</a></code> festgelegte Auszeit
1614 angewendet.</p>
1616 <p>Auf stark belasteten Servern kann ein hoher
1617 <code class="directive">KeepAliveTimeout</code>-Wert zu Durchsatzminderungen
1618 führen. Je höher die Auszeit angegeben ist, desto länger
1619 ist der Apache damit beschäftigt, auf untätige Clients zu
1620 warten.</p>
1622 </div>
1623 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
1624 <div class="directive-section"><h2><a name="Limit" id="Limit">&lt;Limit&gt;</a>-<a name="limit" id="limit">Direktive</a></h2>
1625 <table class="directive">
1626 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Beschränkt die eingeschlossenen Zugriffskontrollen auf
1627 bestimmte HTTP-Methoden</td></tr>
1628 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>&lt;Limit <var>Methode</var> [<var>Methode</var>] ... &gt; ...
1629 &lt;/Limit&gt;</code></td></tr>
1630 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Serverkonfiguration, Virtual Host, Verzeichnis, .htaccess</td></tr>
1631 <tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>All</td></tr>
1632 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
1633 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
1634 </table>
1635 <p>Zugriffskontrollen gelten normalerweise für <strong>alle</strong>
1636 Zugriffsmethoden, was normalerweise auch das gewünschte Verhalten ist.
1637 <strong>Im Allgemeinen sollten Zugriffskontrollen nicht in einen
1638 <code class="directive">&lt;Limit&gt;</code>-Container gepackt
1639 werden.</strong></p>
1641 <p>Der Sinn der Direktive <code class="directive">&lt;Limit&gt;</code>
1642 ist es, den Effekt der Zugriffskontrollen auf die angegebenen
1643 HTTP-Methoden zu beschränken. Bei allen anderen Methoden haben
1644 die in der <code class="directive">&lt;Limit&gt;</code>-Gruppe
1645 enthaltenen Zugriffsbeschränkungen <strong>keine Wirkung</strong>.
1646 Im folgenden Beispiel gilt die Zugriffskontrolle nur für die
1647 Methoden <code>POST</code>, <code>PUT</code> und <code>DELETE</code>.
1648 Alle anderen Methoden bleiben ungeschützt:</p>
1650 <div class="example"><p><code>
1651 &lt;Limit POST PUT DELETE&gt;<br />
1652 <span class="indent">
1653 Require valid-user<br />
1654 </span>
1655 &lt;/Limit&gt;
1656 </code></p></div>
1658 <p>Sie können eine oder mehrere der folgenden Methoden angeben:
1659 <code>GET</code>, <code>POST</code>, <code>PUT</code>, <code>DELETE</code>,
1660 <code>CONNECT</code>, <code>OPTIONS</code>,
1661 <code>PATCH</code>, <code>PROPFIND</code>, <code>PROPPATCH</code>,
1662 <code>MKCOL</code>, <code>COPY</code>, <code>MOVE</code>,
1663 <code>LOCK</code> und <code>UNLOCK</code>. <strong>Die Methodennamen
1664 unterscheiden zwischen Groß- und Kleinschreibung.</strong> Wenn
1665 <code>GET</code> verwendet wird, sind <code>HEAD</code>-Anfragen
1666 ebenfalls eingeschränkt. Die <code>TRACE</code>-Methode kann nicht
1667 limitiert werden.</p>
1669 <div class="warning">
1670 Wenn es um Zugriffsbeschränkungen geht, sollte
1671 ein <code class="directive"><a href="#limitexcept">&lt;LimitExcept&gt;</a></code>-Container sollte immmer einem <code class="directive"><a href="#limit">&lt;Limit&gt;</a></code>-Container vorgezogen
1672 werden, da <code class="directive"><a href="#limitexcept">&lt;LimitExcept&gt;</a></code>
1673 einen Schutz gegen beliebige Methoden bietet.
1674 </div>
1676 </div>
1677 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
1678 <div class="directive-section"><h2><a name="LimitExcept" id="LimitExcept">&lt;LimitExcept&gt;</a>-<a name="limitexcept" id="limitexcept">Direktive</a></h2>
1679 <table class="directive">
1680 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Beschränkt Zugriffskontrollen auf alle HTTP-Methoden
1681 außer den genannten</td></tr>
1682 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>&lt;LimitExcept <var>Methode</var> [<var>Methode</var>] ... &gt; ...
1683 &lt;/LimitExcept&gt;</code></td></tr>
1684 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Serverkonfiguration, Virtual Host, Verzeichnis, .htaccess</td></tr>
1685 <tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>All</td></tr>
1686 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
1687 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
1688 </table>
1689 <p><code class="directive">&lt;LimitExcept&gt;</code> und
1690 <code>&lt;/LimitExcept&gt;</code> werden dazu verwendet, eine Gruppe
1691 von Anweisungen zur Zugriffskontrolle zusammenzufassen, die dann auf
1692 jede HTTP-Methode angewendet werden, die <strong>nicht</strong>
1693 als Argument angegeben ist. D.h. dies ist das Gegenteil des
1694 <code class="directive"><a href="#limit">&lt;Limit&gt;</a></code>-Containers
1695 und kann zur Steuerung von Standard- und nicht-Standard-/unbekannten
1696 Methoden verwendet werden. Für weitere Einzelheiten lesen Sie bitte
1697 die Beschreibung zu <code class="directive"><a href="#limit">&lt;Limit&gt;</a></code>.</p>
1699 <p>Beispiel:</p>
1701 <div class="example"><p><code>
1702 &lt;LimitExcept POST GET&gt;<br />
1703 <span class="indent">
1704 Require valid-user<br />
1705 </span>
1706 &lt;/LimitExcept&gt;
1707 </code></p></div>
1710 </div>
1711 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
1712 <div class="directive-section"><h2><a name="LimitInternalRecursion" id="LimitInternalRecursion">LimitInternalRecursion</a>-<a name="limitinternalrecursion" id="limitinternalrecursion">Direktive</a></h2>
1713 <table class="directive">
1714 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Bestimmt die maximale Anzahl interner Umleitungen und
1715 verschachtelter Unteranfragen</td></tr>
1716 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>LimitInternalRecursion <var>Zahl</var> [<var>Zahl</var>]</code></td></tr>
1717 <tr><th><a href="directive-dict.html#Default">Voreinstellung:</a></th><td><code>LimitInternalRecursion 10</code></td></tr>
1718 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Serverkonfiguration, Virtual Host</td></tr>
1719 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
1720 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
1721 <tr><th><a href="directive-dict.html#Compatibility">Kompatibilität:</a></th><td>Verfügbar ab Apache 2.0.47</td></tr>
1722 </table>
1723 <p>Eine interne Umleitung erfolgt beispielsweise, wenn die Direktive
1724 <code class="directive"><a href="../mod/mod_actions.html#action">Action</a></code> verwendet wird, welche
1725 die Originalanfrage intern zu einem CGI-Skript weiterleitet. Eine
1726 Unteranfrage <span class="transnote">(<em>Anm.d.Ü.:</em> engl. Subrequest)</span> ist ein Mechanismus des
1727 Apache, um herauszufinden, was bei einer URI geschehen würde, wäre
1728 sie angefordert worden. <code class="module"><a href="../mod/mod_dir.html">mod_dir</a></code> z.B. verwendet
1729 Unteranfragen, um nach den Dateien zu suchen, die in der <code class="directive"><a href="../mod/mod_dir.html#directoryindex">DirectoryIndex</a></code>-Anweisung aufgeführt
1730 sind.</p>
1732 <p><code class="directive">LimitInternalRecursion</code> bewahrt den Server vor
1733 einem Absturz, wenn er in eine Endlosschleife aus internen Umleitungen
1734 oder Unteranfragen hineinläuft. Derartige Schleifen werden
1735 gewöhnlich durch Fehlkonfiguration verursacht.</p>
1737 <p>Die Direktive setzt zwei verschiedene Begrenzungen, welche je Anfrage
1738 ausgewertet werden. Die erste <var>Zahl</var> bestimmt die maximale
1739 Anzahl der Umleitungen, die aufeinander folgen dürfen. Die zweite
1740 <var>Zahl</var> legt fest, wie tief Unteranfragen ineinander
1741 verschachtelt werden dürfen. Wenn Sie lediglich eine <var>Zahl</var>
1742 angeben, wird sie beiden Begrenzungen zugewiesen.</p>
1744 <div class="example"><h3>Beispiel</h3><p><code>
1745 LimitInternalRecursion 5
1746 </code></p></div>
1748 </div>
1749 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
1750 <div class="directive-section"><h2><a name="LimitRequestBody" id="LimitRequestBody">LimitRequestBody</a>-<a name="limitrequestbody" id="limitrequestbody">Direktive</a></h2>
1751 <table class="directive">
1752 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Begrenzt die Gesamtgröße des vom Client gesendeten
1753 HTTP-Request-Body</td></tr>
1754 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>LimitRequestBody <var>Bytes</var></code></td></tr>
1755 <tr><th><a href="directive-dict.html#Default">Voreinstellung:</a></th><td><code>LimitRequestBody 0</code></td></tr>
1756 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Serverkonfiguration, Virtual Host, Verzeichnis, .htaccess</td></tr>
1757 <tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>All</td></tr>
1758 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
1759 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
1760 </table>
1761 <p>Die Direktive gibt die Anzahl der <var>Bytes</var> zwischen 0
1762 (unbegrenzt) und 2147483647 (2GB) an, die im Request-Body (Datenteil der
1763 Anfrage) erlaubt sind.</p>
1765 <p>Die Direktive <code class="directive">LimitRequestBody</code> erlaubt es dem
1766 Benutzer, die Größe des HTTP-Request-Bodys in dem Kontext zu
1767 begrenzen, in dem die Anweisung angegeben ist (Server, pro Verzeichnis,
1768 pro Datei oder pro Adresse). Wenn die Anfrage des Clients dieses Limit
1769 überschreitet, gibt der Server einen Fehler zurück anstatt die
1770 Anfrage zu bearbeiten. Die Größe des Datenteils einer Anfrage
1771 kann sehr stark variieren, abhängig von der Art der Ressource und
1772 den für diese Ressource erlaubten Methoden. CGI-Skripte verwenden
1773 den Datenteil üblicherweise zum Empfang von Formulardaten. Wird
1774 die <code>PUT</code>-Methode angewendet, dann muss der Wert mindestens
1775 so groß sein wie irgendeine Darstellungsform, die der Server
1776 für diese Ressource akzeptieren soll.</p>
1778 <p>Die Direktive gibt dem Serveradministrator eine größere
1779 Kontrolle gegenüber abnormalem Verhalten von Clients, was bei der
1780 Vermeidung einiger Formen von Denial-of-Service-Attacken hilfreich
1781 sein kann.</p>
1783 <p>Wenn Sie beispielsweise das Hochladen von Dateien zu einer bestimmten
1784 Adresse erlauben, aber die Größe der hochgeladenen Dateien
1785 auf 100K beschränken wollen, können Sie die folgende Anweisung
1786 verwenden:</p>
1788 <div class="example"><p><code>
1789 LimitRequestBody 102400
1790 </code></p></div>
1793 </div>
1794 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
1795 <div class="directive-section"><h2><a name="LimitRequestFields" id="LimitRequestFields">LimitRequestFields</a>-<a name="limitrequestfields" id="limitrequestfields">Direktive</a></h2>
1796 <table class="directive">
1797 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Begrenzt die Anzahl der HTTP-Request-Header, die vom Client
1798 entgegengenommen werden</td></tr>
1799 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>LimitRequestFields <var>Anzahl</var></code></td></tr>
1800 <tr><th><a href="directive-dict.html#Default">Voreinstellung:</a></th><td><code>LimitRequestFields 100</code></td></tr>
1801 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Serverkonfiguration</td></tr>
1802 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
1803 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
1804 </table>
1805 <p><var>Anzahl</var> ist ein Integer-Wert (eine positive Ganzzahl)
1806 zwischen 0 (unbegrenzt) und 32767. Die Voreinstellung wird durch die
1807 Konstante <code>DEFAULT_LIMIT_REQUEST_FIELDS</code> (<code>100</code>
1808 bei der Auslieferung) zur Kompilierungszeit gesetzt.</p>
1810 <p>Die Direktive <code class="directive">LimitRequestFields</code> erlaubt es
1811 dem Serveradministrator, die maximale Anzahl der in einem HTTP-Request
1812 erlaubten HTTP-Request-Header zu verändern. Für den Server
1813 muss dieser Wert größer sein als die Anzahl der Headerzeilen,
1814 die ein normaler Client senden könnte. Die Anzahl der Request-Header,
1815 die ein gewöhnlicher Client verwendet, überschreitet selten 20
1816 Zeilen. Allerdings kann dies zwischen den verschiedenen
1817 Client-Ausführungen variieren, oft abhängig vom Ausmaß,
1818 mit dem der Anwender die genaue Content-Negotiation-Unterstützung
1819 seines Browsers konfiguriert hat. Optionale HTTP-Erweiterungen
1820 äußern sich oft in Form von HTTP-Headern.</p>
1822 <p>Die Direktive gibt dem Serveradministrator eine größere
1823 Kontrolle gegenüber abnormalem Verhalten von Clients, was bei der
1824 Vermeidung einiger Formen von Denial-of-Service-Attacken hilfreich
1825 sein kann. Der Wert sollte erhöht werden, wenn normale Clients
1826 eine Fehlermeldung vom Server erhalten, die besagt, dass mit der Anfrage
1827 zu viele Headerzeilen gesendet wurden.</p>
1829 <p>Beispiel:</p>
1831 <div class="example"><p><code>
1832 LimitRequestFields 50
1833 </code></p></div>
1836 </div>
1837 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
1838 <div class="directive-section"><h2><a name="LimitRequestFieldSize" id="LimitRequestFieldSize">LimitRequestFieldSize</a>-<a name="limitrequestfieldsize" id="limitrequestfieldsize">Direktive</a></h2>
1839 <table class="directive">
1840 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Begrenzt die Länge des vom Client gesendeten
1841 HTTP-Request-Headers</td></tr>
1842 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>LimitRequestFieldsize <var>Bytes</var></code></td></tr>
1843 <tr><th><a href="directive-dict.html#Default">Voreinstellung:</a></th><td><code>LimitRequestFieldsize 8190</code></td></tr>
1844 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Serverkonfiguration</td></tr>
1845 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
1846 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
1847 </table>
1848 <p>Die Direktive gibt die Anzahl der <var>Bytes</var> an, die in einem
1849 HTTP-Header erlaubt sind.</p>
1851 <p>Die Direktive <code class="directive">LimitRequestFieldsize</code> erlaubt es
1852 dem Serveradministrator, die maximale Größe eines
1853 HTTP-Request-Headers zu verringern oder erhöhen. Für den Server
1854 muss der Wert groß genug sein, um eine beliebige Headerzeile einer
1855 normalen Client-Anfrage vorzuhalten. Die Größe variiert stark
1856 zwischen den verschiedenen Client-Ausführungen, oft abhängig vom
1857 Ausmaß, mit dem der Anwender die genaue
1858 Content-Negotiation-Unterstützung seines Browsers konfiguriert hat.
1859 SPNEGO-Authentisierungs-Header können bis zu 12392 Bytes lang
1860 sein.</p>
1862 <p>Die Direktive gibt dem Serveradministrator eine größere
1863 Kontrolle gegenüber abnormalem Verhalten von Clients, was bei der
1864 Vermeidung einiger Formen von Denial-of-Service-Attacken hilfreich
1865 sein kann.</p>
1867 <p>Beispiel:</p>
1869 <div class="example"><p><code>
1870 LimitRequestFieldSize 4094
1871 </code></p></div>
1873 <div class="note">Unter normalen Umständen sollte die Voreinstellung nicht
1874 verändert werden.</div>
1876 </div>
1877 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
1878 <div class="directive-section"><h2><a name="LimitRequestLine" id="LimitRequestLine">LimitRequestLine</a>-<a name="limitrequestline" id="limitrequestline">Direktive</a></h2>
1879 <table class="directive">
1880 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Begrenzt die Länge der vom Client entgegengenommenen
1881 HTTP-Anfragezeile</td></tr>
1882 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>LimitRequestLine <var>Bytes</var></code></td></tr>
1883 <tr><th><a href="directive-dict.html#Default">Voreinstellung:</a></th><td><code>LimitRequestLine 8190</code></td></tr>
1884 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Serverkonfiguration</td></tr>
1885 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
1886 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
1887 </table>
1888 <p>Die Direktive legt die Anzahl der <var>Bytes</var> fest, die in der
1889 HTTP-Anfragezeile erlaubt sind.</p>
1891 <p>Die Direktive <code class="directive">LimitRequestLine</code> erlaubt es dem
1892 Serveradministrator, die maximale Größe der
1893 HTTP-Anfragezeile zu verringern oder erhöhen. Da
1894 die Anfragezeile aus der HTTP-Methode, der URI und der Protokollversion
1895 besteht, bedeutet die <code class="directive">LimitRequestLine</code>-Direktive
1896 eine Beschränkung der Länge der für eine Anfrage an den
1897 Server erlaubten Anfrage-URI. Für den Server muss der Wert groß
1898 genug sein, um jeden seiner Ressourcennamen vorzuhalten,
1899 einschließlich aller Informationen, die im Query-String einer
1900 <code>GET</code>-Anfrage übergeben werden können.</p>
1902 <p>Die Direktive gibt dem Serveradministrator eine größere
1903 Kontrolle gegenüber abnormalem Verhalten von Clients, was bei der
1904 Vermeidung einiger Formen von Denial-of-Service-Attacken hilfreich
1905 sein kann.</p>
1907 <p>Beispiel:</p>
1909 <div class="example"><p><code>
1910 LimitRequestLine 4094
1911 </code></p></div>
1913 <div class="note">Unter normalen Umständen sollte die Voreinstellung nicht
1914 verändert werden.</div>
1916 </div>
1917 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
1918 <div class="directive-section"><h2><a name="LimitXMLRequestBody" id="LimitXMLRequestBody">LimitXMLRequestBody</a>-<a name="limitxmlrequestbody" id="limitxmlrequestbody">Direktive</a></h2>
1919 <table class="directive">
1920 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Begrenzt die Größe eines XML-basierten
1921 Request-Bodys</td></tr>
1922 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>LimitXMLRequestBody <var>Bytes</var></code></td></tr>
1923 <tr><th><a href="directive-dict.html#Default">Voreinstellung:</a></th><td><code>LimitXMLRequestBody 1000000</code></td></tr>
1924 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Serverkonfiguration, Virtual Host, Verzeichnis, .htaccess</td></tr>
1925 <tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>All</td></tr>
1926 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
1927 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
1928 </table>
1929 <p>Dies gibt die Grenze für die maximale Größe (in Bytes)
1930 des XML-basierten Request-Bodys an. Der Wert <code>0</code> deaktiviert
1931 diese Prüfung.</p>
1933 <p>Beispiel:</p>
1935 <div class="example"><p><code>
1936 LimitXMLRequestBody 0
1937 </code></p></div>
1940 </div>
1941 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
1942 <div class="directive-section"><h2><a name="Location" id="Location">&lt;Location&gt;</a>-<a name="location" id="location">Direktive</a></h2>
1943 <table class="directive">
1944 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Wendet die enthaltenen Direktiven nur auf die entsprechenden
1945 URLs an</td></tr>
1946 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>&lt;Location
1947 <var>URL-Pfad</var>|<var>URL</var>&gt; ... &lt;/Location&gt;</code></td></tr>
1948 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Serverkonfiguration, Virtual Host</td></tr>
1949 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
1950 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
1951 </table>
1952 <p>Die Direktive <code class="directive">&lt;Location&gt;</code>
1953 begrenzt die Reichweite der enthaltenen Anweisungen auf URLs.
1954 Sie ist der Direktive <code class="directive"><a href="#directory">&lt;Directory&gt;</a></code> ähnlich und startet einen
1955 Abschnitt, der mit der Anweisung <code>&lt;/Location&gt;</code>
1956 abgeschlossen wird. <code class="directive">&lt;Location&gt;</code>-Container werden, nachdem die
1957 <code class="directive"><a href="#directory">&lt;Directory&gt;</a></code>-Container
1958 und <code>.htaccess</code>-Dateien gelesen wurden, und nach den
1959 <code class="directive"><a href="#files">&lt;Files&gt;</a></code>-Containern, in
1960 der Reihenfolge ausgeführt, in der sie in der Konfigurationsdatei
1961 erscheinen.</p>
1963 <p><code class="directive">&lt;Location&gt;</code>-Abschnitte operieren
1964 vollständig außerhalb des Dateisystems. Dies hat mehrere
1965 Konsequenzen. An Wichtigsten, <code class="directive">&lt;Location&gt;</code>-Anweisungen sollten nicht dafür
1966 verwendet werden, den Zugriff zu Teilen des Dateisystems zu steuern. Da
1967 mehrere unterschiedliche URLs auf die gleiche Stelle des Dateisystems
1968 zeigen können, könnte eine solche Zugriffskontrolle u.U.
1969 umgangen werden.</p>
1971 <div class="note"><h3>Wann sollte<code class="directive">&lt;Location&gt;</code> verwendet werden</h3>
1973 <p>Verwenden Sie <code class="directive">&lt;Location&gt;</code>, um
1974 Anweisungen auf Inhalte anzuwenden, die außerhalb des Dateisystems
1975 abgelegt sind. Benutzen Sie <code class="directive"><a href="#directory">&lt;Directory&gt;</a></code> und <code class="directive"><a href="#files">&lt;Files&gt;</a></code> für Inhalte, die
1976 innerhalb des Dateisystems abgelegt sind. Eine Ausnahme bildet
1977 <code>&lt;Location /&gt;</code>, welches ein einfacher Weg ist, um eine
1978 Konfiguration auf den gesamten Server anzuwenden.</p>
1979 </div>
1981 <p>Für alle nicht-Proxy-Anfragen ist die entsprechende URL
1982 ein URL-Pfad in der Form <code>/path/</code>. Es dürfen weder ein
1983 Schema, noch ein Hostname, noch ein Port, noch ein Query-String einbezogen
1984 werden. Für Proxy-Anfragen hat die Vergleichs-URL die Form
1985 <code>schema://servername/path</code>. Das Präfix muss angegeben
1986 werden.</p>
1988 <p>Die URL kann Platzhalter verwenden. In einer Zeichenfolge mit
1989 Platzhaltern entspricht <code>?</code> einem einzelnen Zeichen und
1990 <code>*</code>einer beliebigen Zeichenfolge.</p>
1992 <p>Erweiterte reguläre Ausdrücke können ebenfalls
1993 verwendet werden, indem das Zeichen <code>~</code> hinzugefügt
1994 wird. Beispielsweise würde</p>
1996 <div class="example"><p><code>
1997 &lt;Location ~ "/(extra|special)/data"&gt;
1998 </code></p></div>
2000 <p>auf URLs passen, welche die Zeichenfolge <code>/extra/data</code>
2001 oder <code>/special/data</code> enthalten. Die Direktive <code class="directive"><a href="#locationmatch">&lt;LocationMatch&gt;</a></code> verhält sich
2002 genauso wie <code class="directive">&lt;Location&gt;</code> mit
2003 regulären Ausdrücken.</p>
2005 <p>Die Funktionalität von <code class="directive">&lt;Location&gt;</code> ist insbesondere dann nützlich,
2006 wenn sie mit der <code class="directive"><a href="#sethandler">SetHandler</a></code>-Direktive
2007 kombiniert wird. Um zum Beispiel Statusabfragen zu aktivieren, sie aber
2008 nur von Browsern aus <code>foo.com</code> zuzulassen, könnten Sie
2009 schreiben:</p>
2011 <div class="example"><p><code>
2012 &lt;Location /status&gt;<br />
2013 <span class="indent">
2014 SetHandler server-status<br />
2015 Order Deny,Allow<br />
2016 Deny from all<br />
2017 Allow from .foo.com<br />
2018 </span>
2019 &lt;/Location&gt;
2020 </code></p></div>
2022 <div class="note"><h3>Anmerkung zu / (Schrägstrich, Slash)</h3>
2023 <p>Das Slash-Zeichen hat eine besondere Bedeutung, je nachdem, wo es
2024 in der URL erscheint. Manche werden sein Verhalten vom Dateisystem
2025 gewohnt sein, wo mehrere aufeinanderfolgende Schrägstriche
2026 häufig zu einem Schrägstrich zusammengefaßt werden
2027 (<em>d.h.</em> <code>/home///foo</code> ist das gleiche wie
2028 <code>/home/foo</code>). Im URL-Raum ist dies nicht notwendigerweise
2029 genauso. Bei der Direktive <code class="directive"><a href="#locationmatch">&lt;LocationMatch&gt;</a></code> und der <code class="directive">&lt;Location&gt;</code>-Version mit regulären Ausdrücken
2030 müssen Sie explizit mehrere Schrägstriche angeben, wenn Sie
2031 genau dies beabsichtigen.</p>
2033 <p>Beispielsweise würde <code>&lt;LocationMatch ^/abc&gt;</code>
2034 auf die angeforderte URL <code>/abc</code> passen, nicht aber auf
2035 <code>//abc</code>. Die Direktive <code class="directive">&lt;Location&gt;</code> (ohne reguläre Ausdrücke) verhält
2036 sich ähnlich, wenn sie für Proxy-Anfragen verwendet wird.
2037 Wenn <code class="directive">&lt;Location&gt;</code> (ohne
2038 reguläre Ausdrücke) jedoch für nicht-Proxy-Anfragen
2039 verwendet wird, werden stillscheigend mehrere Schrächstriche mit
2040 mit einem einzigen Schrägstrich gleichgesetzt. Geben Sie
2041 beispielsweise <code>&lt;Location /abc/def&gt;</code> an und die
2042 Anfrage lautet auf <code>/abc//def</code>, dann greift die Anweisung.</p>
2043 </div>
2045 <h3>Siehe auch</h3>
2046 <ul>
2047 <li><a href="../sections.html">Wie die Abschnitte &lt;Directory&gt;,
2048 &lt;Location&gt; und &lt;Files&gt; arbeiten</a> für eine
2049 Erläuterung, wie diese verschiedenen Abschnitte miteinander
2050 kombiniert werden, wenn eine Anfrage empfangen wird</li>
2051 </ul>
2052 </div>
2053 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
2054 <div class="directive-section"><h2><a name="LocationMatch" id="LocationMatch">&lt;LocationMatch&gt;</a>-<a name="locationmatch" id="locationmatch">Direktive</a></h2>
2055 <table class="directive">
2056 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Wendet die enthaltenen Direktiven nur auf URLs an, die auf
2057 reguläre Ausdrücke passen</td></tr>
2058 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>&lt;LocationMatch
2059 <var>regex</var>&gt; ... &lt;/LocationMatch&gt;</code></td></tr>
2060 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Serverkonfiguration, Virtual Host</td></tr>
2061 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
2062 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
2063 </table>
2064 <p>Die Direktive <code class="directive">&lt;LocationMatch&gt;</code>
2065 begrenzt die Reichweite der enthaltenen Anweisungen in der gleichen Weise
2066 wie <code class="directive"><a href="#location">&lt;Location&gt;</a></code> auf URLs.
2067 Sie verwendet jedoch reguläre Ausdrücke als Argument anstelle
2068 einer einfachen Zeichenkette. Beispielsweise würde</p>
2070 <div class="example"><p><code>
2071 &lt;LocationMatch "/(extra|special)/data"&gt;
2072 </code></p></div>
2074 <p>auf URLs passen, welche die Zeichenfolge <code>/extra/data</code>
2075 oder <code>/special/data</code> enthalten.</p>
2077 <h3>Siehe auch</h3>
2078 <ul>
2079 <li><a href="../sections.html">Wie die Abschnitte &lt;Directory&gt;,
2080 &lt;Location&gt; und &lt;Files&gt; arbeiten</a> für eine
2081 Erläuterung, wie diese verschiedenen Abschnitte miteinander
2082 kombiniert werden, wenn eine Anfrage empfangen wird</li>
2083 </ul>
2084 </div>
2085 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
2086 <div class="directive-section"><h2><a name="LogLevel" id="LogLevel">LogLevel</a>-<a name="loglevel" id="loglevel">Direktive</a></h2>
2087 <table class="directive">
2088 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Steuert die Ausführlichkeit des Fehlerprotokolls</td></tr>
2089 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>LogLevel <var>Level</var></code></td></tr>
2090 <tr><th><a href="directive-dict.html#Default">Voreinstellung:</a></th><td><code>LogLevel warn</code></td></tr>
2091 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Serverkonfiguration, Virtual Host</td></tr>
2092 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
2093 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
2094 </table>
2095 <p><code class="directive">LogLevel</code> stellt die Ausführlichkeit
2096 der Nachrichten ein, die im Fehlerprotokoll aufgezeichnet werden (siehe
2097 Direktive <code class="directive"><a href="#errorlog">ErrorLog</a></code>). Die folgenden,
2098 nach absteigender Aussagekraft sortierten <var>Level</var> sind
2099 verfügbar:</p>
2101 <table class="bordered">
2103 <tr>
2104 <th><strong>Level</strong> </th>
2106 <th><strong>Beschreibung</strong> </th>
2108 <th><strong>Beispiel</strong> </th>
2109 </tr>
2111 <tr>
2112 <td><code>emerg</code> </td>
2114 <td>Notfall - das System ist unbenutzbar.</td>
2116 <td>"Child cannot open lock file. Exiting"
2117 <span class="transnote">(<em>Anm.d.Ü.:</em> "Kindprozess kann die Lock-Datei nicht öffnen.
2118 Beende Programm")</span></td>
2119 </tr>
2121 <tr>
2122 <td><code>alert</code> </td>
2124 <td>Maßnahmen müssen unverzüglich ergriffen
2125 werden.</td>
2127 <td>"getpwuid: couldn't determine user name from uid"
2128 <span class="transnote">(<em>Anm.d.Ü.:</em> "getpwuid: kann keinen Benutzernamen aus der UID
2129 ermitteln")</span></td>
2130 </tr>
2132 <tr>
2133 <td><code>crit</code> </td>
2135 <td>Kritischer Zustand.</td>
2137 <td>"socket: Failed to get a socket, exiting child"
2138 <span class="transnote">(<em>Anm.d.Ü.:</em> "socket: Socket-Zuweisung fehlgeschlagen, beende
2139 Kindprozess")</span></td>
2140 </tr>
2142 <tr>
2143 <td><code>error</code> </td>
2145 <td>Fehlerbedingung.</td>
2147 <td>"Premature end of script headers"
2148 <span class="transnote">(<em>Anm.d.Ü.:</em> "Vorzeitiges Ende der Skript-Header")</span></td>
2149 </tr>
2151 <tr>
2152 <td><code>warn</code> </td>
2154 <td>Warnung.</td>
2156 <td>"child process 1234 did not exit, sending another SIGHUP"
2157 <span class="transnote">(<em>Anm.d.Ü.:</em> "Kindprozess 1234 nicht beendet, sende ein weiteres
2158 SIGHUP")</span></td>
2159 </tr>
2161 <tr>
2162 <td><code>notice</code> </td>
2164 <td>Normaler, aber signifikanter Zustand.</td>
2166 <td>"httpd: caught SIGBUS, attempting to dump core in ..."
2167 <span class="transnote">(<em>Anm.d.Ü.:</em> "httpd: SIGBUS empfangen, versuche Speicherabbild nach ...
2168 zu schreiben")</span></td>
2169 </tr>
2171 <tr>
2172 <td><code>info</code> </td>
2174 <td>Information.</td>
2176 <td>"Server seems busy, (you may need to increase
2177 StartServers, or Min/MaxSpareServers)..."
2178 <span class="transnote">(<em>Anm.d.Ü.:</em> "Server scheint beschäftigt zu sein,
2179 (möglicherweise müssen Sie StartServers oder
2180 Min/MaxSpareServers erhöhen)")</span></td>
2181 </tr>
2183 <tr>
2184 <td><code>debug</code> </td>
2186 <td>Debug-Level-Nachrichten</td>
2188 <td>"Opening config file ..."
2189 <span class="transnote">(<em>Anm.d.Ü.:</em> "Öffne Konfigurationsdatei ...")</span></td>
2190 </tr>
2191 </table>
2193 <p>Geben Sie einen bestimmten Level an, denn werden Nachrichten von
2194 allen höheren Leveln ebenso angezeigt. <em>Z.B.:</em> Wenn
2195 <code>LogLevel info</code> eingestellt ist, dann werden Nachrichten der
2196 Log-Level <code>notice</code> und <code>warn</code> ebenso eingetragen.</p>
2198 <p>Es wird empfohlen, mindestens den Level <code>crit</code> zu
2199 verwenden.</p>
2201 <p>Beispiel:</p>
2203 <div class="example"><p><code>
2204 LogLevel notice
2205 </code></p></div>
2207 <div class="note"><h3>Hinweis</h3>
2208 <p>Beim Protokollieren in eine reguläre Datei können
2209 Nachrichten des Levels <code>notice</code> nicht unterdrückt
2210 werden und werden daher immer protokolliert. Dies trifft allerdings
2211 nicht zu, wenn mittels <code>syslog</code> protokolliert wird.</p>
2212 </div>
2214 </div>
2215 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
2216 <div class="directive-section"><h2><a name="MaxKeepAliveRequests" id="MaxKeepAliveRequests">MaxKeepAliveRequests</a>-<a name="maxkeepaliverequests" id="maxkeepaliverequests">Direktive</a></h2>
2217 <table class="directive">
2218 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Anzahl der Anfragen, die bei einer persistenten Verbindung
2219 zulässig sind</td></tr>
2220 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>MaxKeepAliveRequests <var>Anzahl</var></code></td></tr>
2221 <tr><th><a href="directive-dict.html#Default">Voreinstellung:</a></th><td><code>MaxKeepAliveRequests 100</code></td></tr>
2222 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Serverkonfiguration, Virtual Host</td></tr>
2223 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
2224 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
2225 </table>
2226 <p>Die Direktive <code class="directive">MaxKeepAliveRequests</code>
2227 begrenzt die Anzahl der Anfragen, die pro Verbindung zulässig sind,
2228 wenn <code class="directive"><a href="#keepalive">KeepAlive</a></code> eingeschaltet ist.
2229 Bei der Einstellung <code>0</code> sind unbegrenzt viele Anfragen
2230 erlaubt. Wir empfehlen für diese Einstellung einen hohen Wert
2231 für eine maximale Serverleistung.</p>
2233 <p>Beispiel:</p>
2235 <div class="example"><p><code>
2236 MaxKeepAliveRequests 500
2237 </code></p></div>
2239 </div>
2240 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
2241 <div class="directive-section"><h2><a name="NameVirtualHost" id="NameVirtualHost">NameVirtualHost</a>-<a name="namevirtualhost" id="namevirtualhost">Direktive</a></h2>
2242 <table class="directive">
2243 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Bestimmt eine IP-Adresse für den Betrieb namensbasierter
2244 virtueller Hosts</td></tr>
2245 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>NameVirtualHost <var>Adresse</var>[:<var>Port</var>]</code></td></tr>
2246 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Serverkonfiguration</td></tr>
2247 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
2248 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
2249 </table>
2250 <p>Die Direktive <code class="directive">NameVirtualHost</code> ist erforderlich,
2251 wenn Sie <a href="../vhosts/">namensbasierte virtuelle Hosts</a>
2252 konfigurieren möchten.</p>
2254 <p>Obwohl <var>Adresse</var> eine Hostname sein kann, wird empfohlen,
2255 dass Sie stets eine IP-Adresse verwenden, z.B.:</p>
2257 <div class="example"><p><code>
2258 NameVirtualHost 111.22.33.44
2259 </code></p></div>
2261 <p>Mit der <code class="directive">NameVirtualHost</code>-Anweisung geben Sie
2262 die IP-Adresse an, unter der der Server Anfragen für
2263 namensbasierte virtuelle Hosts entgegennimmt. Das ist üblicherweise
2264 die Adresse, zu der die Namen Ihrer namensbasierten virtuellen Hosts
2265 aufgelöst werden. Falls eine Firewall oder ein anderer Proxy die
2266 Anfrage in Empfang nimmt und Sie zu einer weiteren IP-Adresse des Servers
2267 weiterleitet, müssen Sie die IP-Adresse der physikalischen
2268 Schnittstelle der Maschine angeben, welche die Anfragen bedient.
2269 Wenn Sie mehrere namensbasierte Hosts an verschiedenen Adressen
2270 betreiben, wiederholen Sie einfach die Anweisung für jede
2271 Adresse.</p>
2273 <div class="note"><h3>Anmerkung</h3>
2274 <p>Beachten Sie, dass der "Hauptserver" und jeder
2275 <code>_default_</code>-Server <strong>niemals</strong> bei einer
2276 Anfrage an einer <code class="directive">NameVirtualHost</code>-IP-Adresse
2277 bedient wird (es sei denn, Sie geben aus irgendwelchen Gründen
2278 <code class="directive">NameVirtualHost</code> an, definieren dann aber keine
2279 <code class="directive">VirtualHost</code>s für diese Adresse).</p>
2280 </div>
2282 <p>Optional können Sie die Nummer eines Ports angeben, an dem
2283 namensbasierte virtuelle Hosts verwendet werden sollen. Beispiel:</p>
2285 <div class="example"><p><code>
2286 NameVirtualHost 111.22.33.44:8080
2287 </code></p></div>
2289 <p>IPv6-Adressen müssen, wie im folgenden Beispiel angegeben, in
2290 eckige Klammern eingeschlossen werden:</p>
2292 <div class="example"><p><code>
2293 NameVirtualHost [2001:db8::a00:20ff:fea7:ccea]:8080
2294 </code></p></div>
2296 <p>Um an allen Schnittstellen Anfragen zu empfangen, können Sie
2297 <code>*</code> als Argument verwenden.</p>
2299 <div class="example"><p><code>
2300 NameVirtualHost *
2301 </code></p></div>
2303 <div class="note"><h3>Argument der Direktive <code class="directive">&lt;VirtualHost&gt;</code></h3>
2304 <p>Beachten Sie, dass das Argument der <code class="directive">&lt;VirtualHost&gt;</code>-Anweisung exakt auf das Argument
2305 der <code class="directive">NameVirtualHost</code>-Anweisung passen muss.</p>
2307 <div class="example"><p><code>
2308 NameVirtualHost 1.2.3.4<br />
2309 &lt;VirtualHost 1.2.3.4&gt;<br />
2310 # ...<br />
2311 &lt;/VirtualHost&gt;<br />
2312 </code></p></div>
2313 </div>
2315 <h3>Siehe auch</h3>
2316 <ul>
2317 <li><a href="../vhosts/">Dokumentation zu virtuellen Hosts</a></li>
2318 </ul>
2319 </div>
2320 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
2321 <div class="directive-section"><h2><a name="Options" id="Options">Options</a>-<a name="options" id="options">Direktive</a></h2>
2322 <table class="directive">
2323 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Definiert, welche Eigenschaften oder Funktionen in einem
2324 bestimmten Verzeichnis verfügbar sind</td></tr>
2325 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>Options
2326 [+|-]<var>Option</var> [[+|-]<var>Option</var>] ...</code></td></tr>
2327 <tr><th><a href="directive-dict.html#Default">Voreinstellung:</a></th><td><code>Options All</code></td></tr>
2328 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Serverkonfiguration, Virtual Host, Verzeichnis, .htaccess</td></tr>
2329 <tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>Options</td></tr>
2330 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
2331 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
2332 </table>
2333 <p>Die Direktive <code class="directive">Options</code> steuert, welche
2334 Eigenschaften bzw. Funktionen in einem bestimmten Verzeichnis
2335 verfügbar sind.</p>
2337 <p><var>Option</var> kann auf <code>None</code> gesetzt werden, wobei
2338 keine der besonderen Eigenschaften verfügbar sind, oder auf eines
2339 oder mehrere der folgenden:</p>
2341 <dl>
2342 <dt><code>All</code></dt>
2344 <dd>Alle Optionen außer <code>MultiViews</code>. Dies ist
2345 die Voreinstellung.</dd>
2347 <dt><code>ExecCGI</code></dt>
2349 <dd>Die Ausführung von CGI-Skripten, welche <code class="module"><a href="../mod/mod_cgi.html">mod_cgi</a></code>
2350 verwenden, ist erlaubt.</dd>
2352 <dt><code>FollowSymLinks</code></dt>
2354 <dd>Der Server folgt symbolischen Links in diesem Verzeichnis.
2355 <div class="note">
2356 <p>Auch wenn der Server symbolischen Links folgt, bedeutet dies
2357 <em>nicht</em>, dass der zum Abgleich gegen <code class="directive"><a href="#directory">&lt;Directory&gt;</a></code>-Abschnitte verwendete Pfadname
2358 wechselt.</p>
2359 <p>Beachten Sie auch, dass diese Option innerhalb eines
2360 <code class="directive"><a href="#location">&lt;Location&gt;</a></code>-Abschnitts
2361 <strong>ignoriert wird</strong>.</p>
2362 </div></dd>
2364 <dt><code>Includes</code></dt>
2366 <dd>
2367 Server Side Includes, die von <code class="module"><a href="../mod/mod_include.html">mod_include</a></code> bereitgestellt
2368 werden, sind erlaubt.</dd>
2370 <dt><code>IncludesNOEXEC</code></dt>
2372 <dd>Server Side Includes sind erlaubt, <code>#exec cmd</code>
2373 und <code>#exec cgi</code> sind jedoch deaktiviert. Es ist aber noch
2374 möglich, CGI-Skripte aus
2375 <code class="directive"><a href="../mod/mod_alias.html#scriptalias">ScriptAlias</a></code>-Verzeichnissen mittels
2376 <code>#include virtual</code> einzubinden.</dd>
2378 <dt><code>Indexes</code></dt>
2380 <dd>Wenn eine URL, die auf ein Verzeichnis zeigt, in dem sich keine durch
2381 <code class="directive"><a href="../mod/mod_dir.html#directoryindex">DirectoryIndex</a></code> definierte
2382 Indexdatei (<em>z.B.</em> <code>index.html</code>) befindet, dann liefert
2383 <code class="module"><a href="../mod/mod_autoindex.html">mod_autoindex</a></code> eine formatierte Auflistung des
2384 Verzeichnisses zurück.</dd>
2386 <dt><code>MultiViews</code></dt>
2388 <dd>"MultiViews" sind bei der Verwendung von
2389 <code class="module"><a href="../mod/mod_negotiation.html">mod_negotiation</a></code> erlaubt (siehe <a href="../content-negotiation.html">Content-Negotiation</a>).</dd>
2391 <dt><code>SymLinksIfOwnerMatch</code></dt>
2393 <dd>Der Server folgt nur symbolischen Links, bei denen die Zieldatei
2394 bzw. das Zielverzeichnis der gleichen Benutzerkennung gehört, wie
2395 der Link.
2396 <div class="note"><h3>Anmerkung</h3> Diese Option wird innerhalb eines
2397 <code class="directive"><a href="#location">&lt;Location&gt;</a></code>-Abschnitts
2398 ignoriert.</div></dd>
2399 </dl>
2401 <p>Wenn mehrere <code class="directive">Options</code> auf ein Verzeichnis
2402 angewandt werden können, dann wird normalerweise die
2403 spezifischste <span class="transnote">(<em>Anm.d.Ü.:</em> Gemeint ist die zuletzt
2404 ausgeführte Option.)</span> verwendet und alle anderen werden
2405 ignoriert; die Optionen werden nicht vermischt. (Siehe auch <a href="../sections.html#mergin">Wie Abschnitte zusammengeführt
2406 werden.</a>.) Wenn jedoch <em>allen</em> Optionen der
2407 <code class="directive">Options</code>-Anweisung eines der Zeichen
2408 <code>+</code> oder <code>-</code> vorangestellt wird, werden die Optionen
2409 zusammengemischt. Jede Option mit vorangestelltem <code>+</code> wird
2410 zu den momentan gültigen Optionen hinzugefügt und jede Option
2411 mit vorangestelltem <code>-</code> wird aus den derzeit gültigen
2412 Optionen entfernt.</p>
2414 <p>So wird zum Beispiel ohne die Zeichen <code>+</code> und
2415 <code>-</code></p>
2417 <div class="example"><p><code>
2418 &lt;Directory /web/docs&gt;<br />
2419 <span class="indent">
2420 Options Indexes FollowSymLinks<br />
2421 </span>
2422 &lt;/Directory&gt;<br />
2423 <br />
2424 &lt;Directory /web/docs/spec&gt;<br />
2425 <span class="indent">
2426 Options Includes<br />
2427 </span>
2428 &lt;/Directory&gt;
2429 </code></p></div>
2431 <p>für das Verzeichnis <code>/web/docs/spec</code> wird jetzt
2432 lediglich <code>Includes</code> gesetzt. Wenn die zweite
2433 <code class="directive">Options</code>-Anweisung jedoch <code>+</code>-
2434 und <code>-</code>-Zeichen verwenden würde,</p>
2436 <div class="example"><p><code>
2437 &lt;Directory /web/docs&gt;<br />
2438 <span class="indent">
2439 Options Indexes FollowSymLinks<br />
2440 </span>
2441 &lt;/Directory&gt;<br />
2442 <br />
2443 &lt;Directory /web/docs/spec&gt;<br />
2444 <span class="indent">
2445 Options +Includes -Indexes<br />
2446 </span>
2447 &lt;/Directory&gt;
2448 </code></p></div>
2450 <p>dann würden die Optionen <code>FollowSymLinks</code> und
2451 <code>Includes</code> für das Verzeichnis <code>/web/docs/spec</code>
2452 gesetzt.</p>
2454 <div class="note"><h3>Anmerkung</h3>
2455 <p>Die Verwendung von <code>-IncludesNOEXEC</code> oder
2456 <code>-Includes</code> deaktiviert Server Side Includes unabhängig
2457 von der vorigen Einstellung vollständig.</p>
2458 </div>
2460 <p>Die Voreinstellung ist <code>All</code>, sofern keine anderen Angaben
2461 gemacht wurden.</p>
2463 </div>
2464 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
2465 <div class="directive-section"><h2><a name="Require" id="Require">Require</a>-<a name="require" id="require">Direktive</a></h2>
2466 <table class="directive">
2467 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Wählt die authentisierten Benutzer aus, die auf eine
2468 Ressource zugreifen können</td></tr>
2469 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>Require <var>Name</var> [<var>Name</var>] ...</code></td></tr>
2470 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Verzeichnis, .htaccess</td></tr>
2471 <tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>AuthConfig</td></tr>
2472 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
2473 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
2474 </table>
2475 <p>Die Direktive wählt aus, welche authentisierten Benutzer auf eine
2476 Ressource zugreifen dürfen. Folgende Syntax ist erlaubt:</p>
2478 <dl>
2479 <dt><code>Require user <var>User-ID</var> [<var>User-ID</var>]
2480 ...</code></dt>
2481 <dd>Nur die genannten Benutzer dürfen auf die Ressource
2482 zugreifen.</dd>
2484 <dt><code>Require group <var>Gruppenname</var> [<var>Gruppenname</var>]
2485 ...</code></dt>
2486 <dd>Nur Benutzer der genannten Gruppen dürfen auf die
2487 Ressource zugreifen.</dd>
2489 <dt><code>Require valid-user</code></dt>
2490 <dd>Alle gültigen Benutzer dürfen auf die Ressource
2491 zugreifen.</dd>
2492 </dl>
2494 <p><code class="directive">Require</code> muss von den Direktiven
2495 <code class="directive"><a href="#authname">AuthName</a></code> und <code class="directive"><a href="#authtype">AuthType</a></code> sowie Direktiven wie
2496 <code class="directive"><a href="../mod/mod_authn_file.html#authuserfile">AuthUserFile</a></code>
2497 und <code class="directive"><a href="../mod/mod_authz_groupfile.html#authgroupfile">AuthGroupFile</a></code>
2498 (zur Definition von Benutzern und Gruppen) begleitet werden, um
2499 korrekt zu funktionieren. Beispiel:</p>
2501 <div class="example"><p><code>
2502 AuthType Basic<br />
2503 AuthName "Geschützte Ressource"<br />
2504 AuthUserFile /web/users<br />
2505 AuthGroupFile /web/groups<br />
2506 Require group admin
2507 </code></p></div>
2509 <p>Zugriffskontrollen, die in dieser Form angewandt werden, gelten
2510 für <strong>alle</strong> Methoden. <strong>Dies ist normalerweise
2511 gewünscht.</strong> Wenn Sie Zugriffskontrollen nur auf bestimmte
2512 Methoden anwenden möchten, während andere Methoden
2513 ungeschützt bleiben, dann müssen Sie die
2514 <code class="directive">Require</code>-Anweisung innerhalb eines
2515 <code class="directive"><a href="#limit">&lt;Limit&gt;</a></code>-Abschnitts
2516 platzieren.</p>
2518 <h3>Siehe auch</h3>
2519 <ul>
2520 <li><code class="directive"><a href="#satisfy">Satisfy</a></code></li>
2521 <li><code class="module"><a href="../mod/mod_authz_host.html">mod_authz_host</a></code></li>
2522 </ul>
2523 </div>
2524 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
2525 <div class="directive-section"><h2><a name="RLimitCPU" id="RLimitCPU">RLimitCPU</a>-<a name="rlimitcpu" id="rlimitcpu">Direktive</a></h2>
2526 <table class="directive">
2527 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Begrenzt den CPU-Verbrauch von Prozessen, die von
2528 Apache-Kindprozessen gestartet wurden</td></tr>
2529 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>RLimitCPU <var>Sekunden</var>|max [<var>Sekunden</var>|max]</code></td></tr>
2530 <tr><th><a href="directive-dict.html#Default">Voreinstellung:</a></th><td><code>unbestimmt; verwendet die Voreinstellung des Systems</code></td></tr>
2531 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Serverkonfiguration, Virtual Host, Verzeichnis, .htaccess</td></tr>
2532 <tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>All</td></tr>
2533 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
2534 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
2535 </table>
2536 <p>Akzeptiert einen oder zwei Parameter. Der erste Paramater setzt eine
2537 weiche Ressourcenbegrenzung für alle Prozesse, der zweite Parameter
2538 setzt die Maximalgrenze für die Ressourcennutzung. Jeder der
2539 Parameter kann eine Zahl oder <code>max</code> sein. <code>max</code>
2540 zeigt dem Server an, dass das vom Betriebssystem erlaubte Maximum
2541 verwendet werden soll. Das Anheben der maximal erlaubten Ressourcennutzung
2542 erfordert, dass der Server als <code>root</code> läuft, zumindest in
2543 der anfänglichen Startphase.</p>
2545 <p>Dies wird auf Prozesse angewendet, die von Anfragen bearbeitenden
2546 Apache-Kindprozessen abgespalten werden, nicht auf die
2547 Apache-Kindprozesse selbst. Das beinhaltet CGI-Skripte und
2548 SSI-exec-Befehle, nicht jedoch Prozesse, die vom Apache-Elternprozess
2549 abgespalten werden, wie z.B. Protokollierung.</p>
2551 <p>CPU-Ressourcenbegrenzung wird in Sekunden pro Prozess
2552 ausgedrückt.</p>
2554 <h3>Siehe auch</h3>
2555 <ul>
2556 <li><code class="directive"><a href="#rlimitmem">RLimitMEM</a></code></li>
2557 <li><code class="directive"><a href="#rlimitnproc">RLimitNPROC</a></code></li>
2558 </ul>
2559 </div>
2560 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
2561 <div class="directive-section"><h2><a name="RLimitMEM" id="RLimitMEM">RLimitMEM</a>-<a name="rlimitmem" id="rlimitmem">Direktive</a></h2>
2562 <table class="directive">
2563 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Begrenzt den Speicherverbrauch von Prozessen, die von
2564 Apache-Kindprozessen gestartet wurden</td></tr>
2565 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>RLimitMEM <var>Bytes</var>|max [<var>Bytes</var>|max]</code></td></tr>
2566 <tr><th><a href="directive-dict.html#Default">Voreinstellung:</a></th><td><code>unbestimmt; verwendet die Voreinstellung des Systems</code></td></tr>
2567 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Serverkonfiguration, Virtual Host, Verzeichnis, .htaccess</td></tr>
2568 <tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>All</td></tr>
2569 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
2570 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
2571 </table>
2572 <p>Akzeptiert einen oder zwei Parameter. Der erste Paramater setzt eine
2573 weiche Ressourcenbegrenzung für alle Prozesse, der zweite Parameter
2574 setzt die Maximalgrenze für die Ressourcennutzung. Jeder der
2575 Parameter kann eine Zahl oder <code>max</code> sein. <code>max</code>
2576 zeigt dem Server an, dass das vom Betriebssystem erlaubte Maximum
2577 verwendet werden soll. Das Anheben der maximal erlaubten Ressourcennutzung
2578 erfordert, dass der Server als <code>root</code> läuft, zumindest in
2579 der anfänglichen Startphase.</p>
2581 <p>Dies wird auf Prozesse angewendet, die von Anfragen bearbeitenden
2582 Apache-Kindprozessen abgespalten werden, nicht auf die
2583 Apache-Kindprozesse selbst. Das beinhaltet CGI-Skripte und
2584 SSI-exec-Befehle, nicht jedoch Prozesse, die vom Apache-Elternprozess
2585 abgespalten werden, wie z.B. Protokollierung.</p>
2587 <p>Die Begrenzung des Speicherverbrauchs wird in Bytes pro Prozess
2588 ausgedrückt.</p>
2590 <h3>Siehe auch</h3>
2591 <ul>
2592 <li><code class="directive"><a href="#rlimitcpu">RLimitCPU</a></code></li>
2593 <li><code class="directive"><a href="#rlimitnproc">RLimitNPROC</a></code></li>
2594 </ul>
2595 </div>
2596 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
2597 <div class="directive-section"><h2><a name="RLimitNPROC" id="RLimitNPROC">RLimitNPROC</a>-<a name="rlimitnproc" id="rlimitnproc">Direktive</a></h2>
2598 <table class="directive">
2599 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Begrenzt die Anzahl der Prozesse, die von Prozessen gestartet
2600 werden können, der ihrerseits von Apache-Kinprozessen gestartet
2601 wurden</td></tr>
2602 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>RLimitNPROC <var>Zahl</var>|max [<var>Zahl</var>|max]</code></td></tr>
2603 <tr><th><a href="directive-dict.html#Default">Voreinstellung:</a></th><td><code>unbestimmt; verwendet die Voreinstellung des Systems</code></td></tr>
2604 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Serverkonfiguration, Virtual Host, Verzeichnis, .htaccess</td></tr>
2605 <tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>All</td></tr>
2606 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
2607 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
2608 </table>
2609 <p>Akzeptiert einen oder zwei Parameter. Der erste Paramater setzt eine
2610 weiche Ressourcenbegrenzung für alle Prozesse, der zweite Parameter
2611 setzt die Maximalgrenze für die Ressourcennutzung. Jeder der
2612 Parameter kann eine Zahl oder <code>max</code> sein. <code>max</code>
2613 zeigt dem Server an, dass das vom Betriebssystem erlaubte Maximum
2614 verwendet werden soll. Das Anheben der maximal erlaubten Ressourcennutzung
2615 erfordert, dass der Server als <code>root</code> läuft, zumindest in
2616 der anfänglichen Startphase.</p>
2618 <p>Dies wird auf Prozesse angewendet, die von Anfragen bearbeitenden
2619 Apache-Kindprozessen abgespalten werden, nicht auf die
2620 Apache-Kindprozesse selbst. Dies beinhaltet CGI-Skripte und
2621 SSI-exec-Befehle, nicht jedoch Prozesse, die vom Apache-Elternprozess
2622 abgespalten werden, wie z.B. Protokollierung.</p>
2624 <p>Prozessbegrenzungen steuern die Anzahl der Prozesse pro Benutzer.</p>
2626 <div class="note"><h3>Anmerkung</h3>
2627 <p>Wenn CGI-Prozesse nicht unter anderen Benutzerkennungen als der
2628 User-ID des Webservers laufen, dann beschränkt diese Direktive
2629 die Anzahl der Prozesse, die der Server selbst erstellen kann.
2630 Kennzeichen einer solchen Situation sind
2631 <strong><code>cannot fork</code></strong>-Meldungen
2632 <span class="transnote">(<em>Anm.d.Ü.:</em> <code>kann nicht abspalten</code>)</span> in der
2633 Datei <code>error_log</code>.</p>
2634 </div>
2636 <h3>Siehe auch</h3>
2637 <ul>
2638 <li><code class="directive"><a href="#rlimitmem">RLimitMEM</a></code></li>
2639 <li><code class="directive"><a href="#rlimitcpu">RLimitCPU</a></code></li>
2640 </ul>
2641 </div>
2642 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
2643 <div class="directive-section"><h2><a name="Satisfy" id="Satisfy">Satisfy</a>-<a name="satisfy" id="satisfy">Direktive</a></h2>
2644 <table class="directive">
2645 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Zusammenspiel von rechnerbasierter Zugriffskontrolle und
2646 Benutzerauthentisierung</td></tr>
2647 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>Satisfy Any|All</code></td></tr>
2648 <tr><th><a href="directive-dict.html#Default">Voreinstellung:</a></th><td><code>Satisfy All</code></td></tr>
2649 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Verzeichnis, .htaccess</td></tr>
2650 <tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>AuthConfig</td></tr>
2651 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
2652 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
2653 <tr><th><a href="directive-dict.html#Compatibility">Kompatibilität:</a></th><td>Wird seit Version 2.0.51 von <code class="directive"><a href="#limit">&lt;Limit&gt;</a></code> und <code class="directive"><a href="#limitexcept">&lt;LimitExcept&gt;</a></code> beeinflusst</td></tr>
2654 </table>
2655 <p>Verfahrensweise für den Zugriff, falls sowohl <code class="directive"><a href="../mod/mod_authz_host.html#allow">Allow</a></code> als auch <code class="directive"><a href="#require">Require</a></code> verwendet werden. Der Parameter kann
2656 entweder <code>All</code> oder <code>Any</code> sein. Die Direktive ist
2657 nur dann nützlich, wenn der Zugriff zu einem bestimmten Bereich
2658 durch Benutzername/Passwort <em>und</em> Clientrechner-Adressen
2659 eingeschränkt ist. In diesem Fall verlangt die Voreinstellung
2660 (<code>All</code>), dass der Client die Adressbeschränkung passiert
2661 <em>und</em> eine gültige Benutzerkennung und ein gültiges
2662 Passwort übermittelt. Mit der Auswahl <code>Any</code> wird dem
2663 Client der Zugriff erlaubt, wenn er entweder die Rechner-Beschänkung
2664 passiert oder einen gültigen Benutzernamen und ein gültiges
2665 Passwort übermittelt. Dies kann verwendet werden, um einen Bereich
2666 mit einem Passwort zu schützen, jedoch Clients von bestimmten
2667 Adressen ohne Abfrage des Passwortes zuzulassen.</p>
2669 <p>Wenn Sie beispielsweise möchten, dass Personen aus Ihrem
2670 privaten Netzwerk unbechänkten Zugriff zu Teilen Ihres
2671 Webangebots haben, jedoch verlangen, dass Personen außerhalb
2672 Ihres privaten Netzwerks ein Passwort übergeben müssen,
2673 können Sie eine Konfiguration ähnlich der folgenden
2674 verwenden:</p>
2676 <div class="example"><p><code>
2677 Require valid-user<br />
2678 Allow from 192.168.1<br />
2679 Satisfy Any
2680 </code></p></div>
2682 <p>Seit Version 2.0.51 können
2683 <code class="directive">Satisfy</code>-Anweisungen durch <code class="directive"><a href="#limit">&lt;Limit&gt;</a></code>- und <code class="directive"><a href="#limitexcept">&lt;LimitExcept&gt;</a></code>-Abschnitte auf bestimmte Methoden
2684 beschränkt werden.</p>
2686 <h3>Siehe auch</h3>
2687 <ul>
2688 <li><code class="directive"><a href="../mod/mod_authz_host.html#allow">Allow</a></code></li>
2689 <li><code class="directive"><a href="#require">Require</a></code></li>
2690 </ul>
2691 </div>
2692 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
2693 <div class="directive-section"><h2><a name="ScriptInterpreterSource" id="ScriptInterpreterSource">ScriptInterpreterSource</a>-<a name="scriptinterpretersource" id="scriptinterpretersource">Direktive</a></h2>
2694 <table class="directive">
2695 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Methode zur Ermittlung des Interpreters von
2696 CGI-Skripten</td></tr>
2697 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>ScriptInterpreterSource Registry|Registry-Strict|Script</code></td></tr>
2698 <tr><th><a href="directive-dict.html#Default">Voreinstellung:</a></th><td><code>ScriptInterpreterSource Script</code></td></tr>
2699 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Serverkonfiguration, Virtual Host, Verzeichnis, .htaccess</td></tr>
2700 <tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>FileInfo</td></tr>
2701 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
2702 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
2703 <tr><th><a href="directive-dict.html#Compatibility">Kompatibilität:</a></th><td>ausschließlich Win32;
2704 Die Option <code>Registry-Strict</code> ist verfügbar seit Apache
2705 2.0.</td></tr>
2706 </table>
2707 <p>Die Direktive steuert, wie der Apache den Interpreter zur Ausführung
2708 von CGI-Skripten bestimmt. Die Voreinstellung ist <code>Script</code>. Dies
2709 veranlaßt den Apache, den Interpreter zu verwenden, auf den die
2710 Shebang-Zeile (erste Zeile, beginnt mit <code>#!</code>) im Skript zeigt.
2711 Auf Win32-Systemen sieht diese Zeile üblicherweise so aus:</p>
2713 <div class="example"><p><code>
2714 #!C:/Perl/bin/perl.exe
2715 </code></p></div>
2717 <p>oder, wenn <code>perl</code> im Pfad (Umgebungsvariable <code>PATH</code>) liegt,
2718 einfach:</p>
2720 <div class="example"><p><code>
2721 #!perl
2722 </code></p></div>
2724 <p>Die Einstellung <code>ScriptInterpreterSource Registry</code>
2725 veranlaßt eine Suche in <code>HKEY_CLASSES_ROOT</code> der
2726 Windows-Registrierungsdatenbank und verwendet die Endung der Skript-Datei
2727 (z.B. <code>.pl</code>) als Suchargument. Der durch den Unterschlüssel
2728 <code>Shell\ExecCGI\Command</code> oder, falls dieser nicht existiert,
2729 <code>Shell\Open\Command</code> definierte Befehl wird zum Öffnen der
2730 Skript-Datei verwendet. Wenn der Schlüssel zur Dateiendung oder
2731 beide Unterschlüssel fehlen, dann verwendet der Apache die Option
2732 <code>Script</code>.</p>
2734 <div class="warning"><h3>Sicherheit</h3>
2735 <p>Seien Sie vorsichtig, <code>ScriptInterpreterSource Registry</code> bei
2736 Verzeichnissen zu verwenden, auf die eine <code class="directive"><a href="../mod/mod_alias.html#scriptalias">ScriptAlias</a></code>-Anweisung zeigt, denn der
2737 Apache versucht <strong>jede</strong> Datei innerhalb des Verzeichnisses
2738 auszuführen. Die Einstellung <code>Registry</code> kann
2739 unerwünschte Programmaufrufe bei Dateien verursachen, die
2740 üblicherweise nicht ausgeführt werden. Auf den meisten
2741 Windows-Systemen beispielsweise startet der voreingestellte
2742 Öffnen-Befehl für <code>.htm</code>-Dateien den Microsoft
2743 Internet Explorer, so dass jede HTTP-Anfrage nach einer existierenden
2744 <code>.htm</code>-Datei im Skript-Verzeichnis den Browser im Hintergrund
2745 starten würde. Dies ist eine wirksame Methode, Ihr System binnen
2746 etwa einer Minute zum Absturz zu bringen.</p>
2747 </div>
2749 <p>Die seit Apache 2.0 neue Option <code>Registry-Strict</code>
2750 macht das gleiche wie <code>Registry</code>, verwendet jedoch nur den
2751 Unterschlüssel <code>Shell\ExecCGI\Command</code>. Der Schlüssel
2752 <code>ExecCGI</code> ist gewöhnlich nicht voreingestellt. Er muss
2753 manuell eingerichtet werden und schützt Ihr System so for
2754 versehentlichen Programmaufrufen.</p>
2756 </div>
2757 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
2758 <div class="directive-section"><h2><a name="ServerAdmin" id="ServerAdmin">ServerAdmin</a>-<a name="serveradmin" id="serveradmin">Direktive</a></h2>
2759 <table class="directive">
2760 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>E-Mail-Adresse, die der Server in Fehlermeldungen einfügt,
2761 welche an den Client gesendet werden</td></tr>
2762 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>ServerAdmin <var>E-Mail-Adresse</var>|<var>URL</var></code></td></tr>
2763 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Serverkonfiguration, Virtual Host</td></tr>
2764 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
2765 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
2766 </table>
2767 <p><code class="directive">ServerAdmin</code> legt die Kontaktadresse fest,
2768 die der Server in jede Fehlermeldung einfügt, die er an den
2769 Client zurückschickt. Wenn <code>httpd</code> das übergebene
2770 Argument nicht als URL erkennt, nimmt er an, dess es sich um eine
2771 <var>E-Mail-Adresse</var> handelt und stellt in Hyperlinks
2772 <code>mailto:</code> voran. Es ist jedoch sogar sinnvoll, eine
2773 E-Mail-Adresse zu verwenden, da viele CGI-Skripte davon ausgehen. Wenn Sie
2774 eine URL verwenden möchten, sollten Sie auf einem anderen unter Ihrer
2775 Kontrolle stehenden Server verweisen. Andernfalls können Besucher Sie
2776 im Fehlerfall möglicherweise nicht kontaktieren.</p>
2778 <p>Es kann sich lohnen, hierfür eine reservierte Adresse
2779 anzugeben, z.B.</p>
2781 <div class="example"><p><code>
2782 ServerAdmin www-admin@foo.example.com
2783 </code></p></div>
2785 <p>da Anwender nicht unbedingt erwähnen, dass sie vom Server
2786 sprechen!</p>
2788 </div>
2789 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
2790 <div class="directive-section"><h2><a name="ServerAlias" id="ServerAlias">ServerAlias</a>-<a name="serveralias" id="serveralias">Direktive</a></h2>
2791 <table class="directive">
2792 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Alternativer Name für einen Host, der verwendet wird, wenn
2793 Anfragen einem namensbasierten virtuellen Host zugeordnet werden</td></tr>
2794 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>ServerAlias <var>Hostname</var> [<var>Hostname</var>] ...</code></td></tr>
2795 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Virtual Host</td></tr>
2796 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
2797 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
2798 </table>
2799 <p>Die Direktive <code class="directive">ServerAlias</code> bestimmt die
2800 alternativen Namen eines Hosts zur Verwendung mit <a href="../vhosts/name-based.html">namensbasierten virtuellen Hosts</a>.</p>
2802 <div class="example"><p><code>
2803 &lt;VirtualHost *&gt;<br />
2804 ServerName server.domain.com<br />
2805 ServerAlias server server2.domain.com server2<br />
2806 # ...<br />
2807 &lt;/VirtualHost&gt;
2808 </code></p></div>
2810 <h3>Siehe auch</h3>
2811 <ul>
2812 <li><a href="../vhosts/">Apache-Dokumentation zu virtuellen
2813 Hosts</a></li>
2814 </ul>
2815 </div>
2816 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
2817 <div class="directive-section"><h2><a name="ServerName" id="ServerName">ServerName</a>-<a name="servername" id="servername">Direktive</a></h2>
2818 <table class="directive">
2819 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Rechnername und Port, die der Server dazu verwendet, sich
2820 selbst zu identifizieren</td></tr>
2821 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>ServerName
2822 <var>voll-qualifizierter-Domainname</var>[:<var>port</var>]</code></td></tr>
2823 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Serverkonfiguration, Virtual Host</td></tr>
2824 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
2825 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
2826 <tr><th><a href="directive-dict.html#Compatibility">Kompatibilität:</a></th><td>Diese Direktive löst in Version 2.0 die
2827 Funktionalität der Direktive <code class="directive">Port</code> aus
2828 Version 1.3 ab.</td></tr>
2829 </table>
2830 <p>Die Direktive <code class="directive">ServerName</code> bestimmt den
2831 Rechnernamen und Port, den der Server dazu verwendet, sich selbst
2832 zu identifizieren. Diese werden bei der Erstellung von Umleitungs-URLs
2833 benötigt. Wenn beispielsweise der Name der Maschine, die den Webserver
2834 beherbergt, <code>simple.example.com</code> lautet, die Maschine jedoch
2835 auch einen DNS-Alias <code>www.example.com</code> besitzt und Sie den
2836 Webserver so identifizieren möchten, sollten Sie die folgende
2837 Anweisung verwenden:</p>
2839 <div class="example"><p><code>
2840 ServerName www.example.com:80
2841 </code></p></div>
2843 <p>Wenn kein <code class="directive">ServerName</code> angegeben wurde,
2844 dann versucht der Server den Rechnernamen mittels eines Reverse-Lookup
2845 herzuleiten. Wenn kein Port in der
2846 <code class="directive">ServerName</code>-Anweisung angegeben wurde, dann
2847 verwendet der Server den Port der eingegangenen Anfrage. Für eine
2848 optimale Zuverlässigkeit und Berechenbarkeit sollten Sie einen
2849 eindeutigen Rechnernamen und Port angeben, in dem Sie die Direktive
2850 <code class="directive">ServerName</code> verwenden.</p>
2852 <p>Wenn Sie <a href="../vhosts/name-based.html">namensbasierte
2853 virtuelle Hosts</a> verwenden, gibt <code class="directive">ServerName</code>
2854 innerhalb eines <code class="directive"><a href="#virtualhost">&lt;VirtualHost&gt;</a></code>-Abschnitts an, welcher
2855 Hostname im <code>Host:</code>-Header der Anfrage auftauchen muss,
2856 damit sie diesem virtuellen Host zugeordnet wird.</p>
2858 <p>Lesen Sie bitte die Beschreibung der Direktive <code class="directive"><a href="#usecanonicalname">UseCanonicalName</a></code> für Einstellungen, die
2859 bestimmen, ob selbstreferenzierende URLs (z.B. vom Modul
2860 <code class="module"><a href="../mod/mod_dir.html">mod_dir</a></code>) auf den angegebenen Port zeigen oder auf die
2861 Portnummern die in der Anfrage des Clients angegeben ist.</p>
2863 <h3>Siehe auch</h3>
2864 <ul>
2865 <li><a href="../dns-caveats.html">Probleme bezüglich DNS und
2866 Apache</a></li>
2867 <li><a href="../vhosts/">Apache-Dokumentation zu virtuellen
2868 Hosts</a></li>
2869 <li><code class="directive"><a href="#usecanonicalname">UseCanonicalName</a></code></li>
2870 <li><code class="directive"><a href="#namevirtualhost">NameVirtualHost</a></code></li>
2871 <li><code class="directive"><a href="#serveralias">ServerAlias</a></code></li>
2872 </ul>
2873 </div>
2874 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
2875 <div class="directive-section"><h2><a name="ServerPath" id="ServerPath">ServerPath</a>-<a name="serverpath" id="serverpath">Direktive</a></h2>
2876 <table class="directive">
2877 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Veralteter URL-Pfad für einen namensbasierten
2878 virtuellen Host, auf den von einem inkompatiblen Browser zugegriffen
2879 wird</td></tr>
2880 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>ServerPath <var>URL-Pfad</var></code></td></tr>
2881 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Virtual Host</td></tr>
2882 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
2883 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
2884 </table>
2885 <p>Die Direktive <code class="directive">ServerPath</code> legt den
2886 veralteten <span class="transnote">(<em>Anm.d.Ü.:</em> Gemeint ist eigentlich "Altlast" aufgrund
2887 antiquierter Clients.)</span> URL-Pfad eines Hosts zur Verwendung mit
2888 <a href="../vhosts/">namensbasierten virtuellen Hosts</a> fest.</p>
2890 <h3>Siehe auch</h3>
2891 <ul>
2892 <li><a href="../vhosts/">Apache-Dokumentation zu virtuellen
2893 Hosts</a></li>
2894 </ul>
2895 </div>
2896 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
2897 <div class="directive-section"><h2><a name="ServerRoot" id="ServerRoot">ServerRoot</a>-<a name="serverroot" id="serverroot">Direktive</a></h2>
2898 <table class="directive">
2899 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Basisverzeichnis der Serverinstallation</td></tr>
2900 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>ServerRoot <var>Verzeichnis</var></code></td></tr>
2901 <tr><th><a href="directive-dict.html#Default">Voreinstellung:</a></th><td><code>ServerRoot /usr/local/apache</code></td></tr>
2902 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Serverkonfiguration</td></tr>
2903 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
2904 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
2905 </table>
2906 <p>Die Direktive <code class="directive">ServerRoot</code> bestimmt das
2907 Verzeichnis, in dem der Server installiert ist. Üblicherweise
2908 enthält es die Unterverzeichnisse <code>conf/</code> und
2909 <code>logs/</code>. Relative Pfadangaben anderer Direktiven (wie z.B.
2910 <code class="directive"><a href="#include">Include</a></code> oder <code class="directive"><a href="../mod/mod_so.html#loadmodule">LoadModule</a></code>) werden relativ zu diesem
2911 Verzeichnis betrachtet.</p>
2913 <div class="example"><h3>Beispiel</h3><p><code>
2914 ServerRoot /home/httpd
2915 </code></p></div>
2917 <h3>Siehe auch</h3>
2918 <ul>
2919 <li><a href="../invoking.html">Die <code>httpd</code>-Option
2920 <code>-d</code></a></li>
2921 <li><a href="../misc/security_tips.html#serverroot">Sicherheitshinweise</a>
2922 für Informationen, wie die Rechte auf das <code class="directive">ServerRoot</code>-Verzeichnis richtig gesetzt werden</li>
2923 </ul>
2924 </div>
2925 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
2926 <div class="directive-section"><h2><a name="ServerSignature" id="ServerSignature">ServerSignature</a>-<a name="serversignature" id="serversignature">Direktive</a></h2>
2927 <table class="directive">
2928 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Konfiguriert die Fußzeile von servergenerierten
2929 Dokumenten</td></tr>
2930 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>ServerSignature On|Off|EMail</code></td></tr>
2931 <tr><th><a href="directive-dict.html#Default">Voreinstellung:</a></th><td><code>ServerSignature Off</code></td></tr>
2932 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Serverkonfiguration, Virtual Host, Verzeichnis, .htaccess</td></tr>
2933 <tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>All</td></tr>
2934 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
2935 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
2936 </table>
2937 <p>Die Direktive <code class="directive">ServerSignature</code> ermöglicht
2938 die Gestaltung einer unter servergenerierten Dokumenten (z.B.
2939 Fehlerdokumente, FTP-Verzeichnislisten von <code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code>,
2940 <code class="module"><a href="../mod/mod_info.html">mod_info</a></code>-Ausgaben, ...) angefügten
2941 Fußzeile. Ein möglicher Grund für die Aktivierung einer
2942 solchen Fußzeile ist, dass der Anwender bei einer Kette von
2943 Proxy-Servern oft keine Möglichkeit hat, zu erkennen, welcher der
2944 verketteten Server gegenwärtig die zurückgegebene Fehlermeldung
2945 produziert hat.</p>
2947 <p>Die (Vor-)Einstellung <code>Off</code> unterdrückt die
2948 Fußzeile (und ist damit kompatibel zum Verhalten des Apache 1.2 und
2949 früher). Die Einstellung <code>On</code> fügt schlicht eine
2950 Zeile mit der Versionsnummer des Servers und dem Servernamen (<code class="directive"><a href="#servername">ServerName</a></code>) des bedienenden virtuellen Hosts an.
2951 Die Einstellung <code>EMail</code> erstellt zusätzlich einen
2952 "mailto:"-Verweis zum Serveradministrator (<code class="directive"><a href="#serveradmin">ServerAdmin</a></code>) des referenzierten Dokuments.</p>
2954 <p>Ab Version 2.0.44 werden die Details der angegebenen Versionsnummer des
2955 Servers von der Direktive <code class="directive"><a href="#servertokens">ServerTokens</a></code> kontrolliert.</p>
2957 <h3>Siehe auch</h3>
2958 <ul>
2959 <li><code class="directive"><a href="#servertokens">ServerTokens</a></code></li>
2960 </ul>
2961 </div>
2962 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
2963 <div class="directive-section"><h2><a name="ServerTokens" id="ServerTokens">ServerTokens</a>-<a name="servertokens" id="servertokens">Direktive</a></h2>
2964 <table class="directive">
2965 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Konfiguriert den HTTP-Response-Header
2966 <code>Server</code></td></tr>
2967 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>ServerTokens Major|Minor|Min[imal]|Prod[uctOnly]|OS|Full</code></td></tr>
2968 <tr><th><a href="directive-dict.html#Default">Voreinstellung:</a></th><td><code>ServerTokens Full</code></td></tr>
2969 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Serverkonfiguration</td></tr>
2970 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
2971 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
2972 </table>
2973 <p>die Direktive steuert, ob der Response-Header <code>Server</code>,
2974 der an den Client zurückgesendet wird, eine Beschreibung des
2975 allgemeinen Betriesbsystemtyps des Servers wie auch Informationen
2976 über einkompilierte Module enthält.</p>
2978 <dl>
2979 <dt><code>ServerTokens Prod[uctOnly]</code></dt>
2981 <dd>Der Server sendet (<em>z.B.</em>): <code>Server:
2982 Apache</code></dd>
2984 <dt><code>ServerTokens Major</code></dt>
2986 <dd>Der Server sendet (<em>z.B.</em>): <code>Server:
2987 Apache/2</code></dd>
2989 <dt><code>ServerTokens Minor</code></dt>
2991 <dd>Der Server sendet (<em>z.B.</em>): <code>Server:
2992 Apache/2.0</code></dd>
2994 <dt><code>ServerTokens Min[imal]</code></dt>
2996 <dd>Der Server sendet (<em>z.B.</em>): <code>Server:
2997 Apache/2.0.41</code></dd>
2999 <dt><code>ServerTokens OS</code></dt>
3001 <dd>Der Server sendet (<em>z.B.</em>): <code>Server: Apache/2.0.41
3002 (Unix)</code></dd>
3004 <dt><code>ServerTokens Full</code> (oder nicht angegeben)</dt>
3006 <dd>Der Server sendet (<em>z.B.</em>): <code>Server: Apache/2.0.41
3007 (Unix) PHP/4.2.2 MyMod/1.2</code></dd>
3008 </dl>
3010 <p>Diese Einstellung gilt für den gesamten Server und kann nicht
3011 auf Virtual-Host-Basis aktiviert oder deaktiviert werden.</p>
3013 <p>Ab Version 2.0.44 steuert diese Direktive auch die Informationen, die
3014 durch die Direktive <code class="directive"><a href="#serversignature">ServerSignature</a></code>
3015 angeboten werden.</p>
3017 <h3>Siehe auch</h3>
3018 <ul>
3019 <li><code class="directive"><a href="#serversignature">ServerSignature</a></code></li>
3020 </ul>
3021 </div>
3022 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
3023 <div class="directive-section"><h2><a name="SetHandler" id="SetHandler">SetHandler</a>-<a name="sethandler" id="sethandler">Direktive</a></h2>
3024 <table class="directive">
3025 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Erzwingt die Verarbeitung aller passenden Dateien durch
3026 einen Handler</td></tr>
3027 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>SetHandler <var>Handlername</var>|None</code></td></tr>
3028 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Serverkonfiguration, Virtual Host, Verzeichnis, .htaccess</td></tr>
3029 <tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>FileInfo</td></tr>
3030 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
3031 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
3032 <tr><th><a href="directive-dict.html#Compatibility">Kompatibilität:</a></th><td>Seit Apache 2.0 im Core</td></tr>
3033 </table>
3034 <p>Wenn die Direktive innerhalb einer <code>.htaccess</code>-Datei
3035 oder in einem <code class="directive"><a href="#directory">&lt;Directory&gt;</a></code>- oder
3036 <code class="directive"><a href="#location">&lt;Location&gt;</a></code>-Abschnitt
3037 angegeben wird, erzwingt sie, dass alle entsprechenden Dateien von dem
3038 durch <var>Handlername</var> angegebenen <a href="../handler.html">Handler</a> analysiert werden. Wenn Sie
3039 beispielsweise ein Verzeichnis haben, dessen Dateien unabhängig von
3040 der Endung gänzlich als Image-Maps interpretiert werden sollen,
3041 können Sie folgendes in eine <code>.htaccess</code>-Datei in
3042 dem Verzeichnis schreiben:</p>
3044 <div class="example"><p><code>
3045 SetHandler imap-file
3046 </code></p></div>
3048 <p>Noch ein Beispiel: wenn Sie den Server immer, wenn die URL
3049 <code>http://servername/status</code> aufgerufen wird, einen
3050 Statusbericht anzeigen lassen möchten, dann können
3051 Sie folgendes in die <code>httpd.conf</code> schreiben:</p>
3053 <div class="example"><p><code>
3054 &lt;Location /status&gt;<br />
3055 <span class="indent">
3056 SetHandler server-status<br />
3057 </span>
3058 &lt;/Location&gt;
3059 </code></p></div>
3060 <p>Sie können eine zuvor definierte
3061 <code class="directive">SetHandler</code>-Anweisung aufheben, indem Sie den Wert
3062 <code>None</code> verwenden.</p>
3064 <h3>Siehe auch</h3>
3065 <ul>
3066 <li><code class="directive"><a href="../mod/mod_mime.html#addhandler">AddHandler</a></code></li>
3067 </ul>
3068 </div>
3069 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
3070 <div class="directive-section"><h2><a name="SetInputFilter" id="SetInputFilter">SetInputFilter</a>-<a name="setinputfilter" id="setinputfilter">Direktive</a></h2>
3071 <table class="directive">
3072 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Bestimmt die Filter, die Client-Anfragen und POST-Eingaben
3073 verarbeiten</td></tr>
3074 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>SetInputFilter <var>Filter</var>[;<var>Filter</var>...]</code></td></tr>
3075 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Serverkonfiguration, Virtual Host, Verzeichnis, .htaccess</td></tr>
3076 <tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>FileInfo</td></tr>
3077 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
3078 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
3079 </table>
3080 <p>Die Direktive <code class="directive">SetInputFilter</code> bestimmt den oder
3081 die Filter, die Client-Anfragen und POST-Eingaben verarbeiten, wenn
3082 sie vom Server empfangen werden. Diese gelten zusätzlich zu
3083 anderweitig definierten Filtern, einschließlich denen der Direktive
3084 <code class="directive"><a href="../mod/mod_mime.html#addinputfilter">AddInputFilter</a></code>.</p>
3086 <p>Wenn mehr als ein Filter angegeben wird, dann müssen diese
3087 durch Semikolon voneinander getrennt in der Reihenfolge angegeben werden,
3088 in der sie die Daten verarbeiten sollen.</p>
3090 <h3>Siehe auch</h3>
3091 <ul>
3092 <li><a href="../filter.html">Filter</a>-Dokumentation</li>
3093 </ul>
3094 </div>
3095 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
3096 <div class="directive-section"><h2><a name="SetOutputFilter" id="SetOutputFilter">SetOutputFilter</a>-<a name="setoutputfilter" id="setoutputfilter">Direktive</a></h2>
3097 <table class="directive">
3098 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Bestimmt die Filter, die Antworten des Servers verarbeiten</td></tr>
3099 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>SetOutputFilter <var>Filter</var>[;<var>Filter</var>...]</code></td></tr>
3100 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Serverkonfiguration, Virtual Host, Verzeichnis, .htaccess</td></tr>
3101 <tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>FileInfo</td></tr>
3102 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
3103 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
3104 </table>
3105 <p>Die Direktive <code class="directive">SetOutputFilter</code> bestimmt
3106 die Filter, die Antworten des Servers verarbeiten, bevor sie an den
3107 Client gesendet werden. Diese gelten zusätzlich zu anderweitig
3108 definierten Filtern, einschließlich denen der Direktive
3109 <code class="directive"><a href="../mod/mod_mime.html#addoutputfilter">AddOutputFilter</a></code>.</p>
3111 <p>Die folgende Konfiguration verarbeitet zum Beispiel alle Dateien
3112 im Verzeichnis <code>/www/data</code> als Server Side Includes.</p>
3114 <div class="example"><p><code>
3115 &lt;Directory /www/data/&gt;<br />
3116 <span class="indent">
3117 SetOutputFilter INCLUDES<br />
3118 </span>
3119 &lt;/Directory&gt;
3120 </code></p></div>
3122 <p>Wenn mehr als ein Filter angegeben wird, dann müssen diese
3123 durch Semikolon voneinander getrennt in der Reihenfolge angegeben werden,
3124 in der sie die Daten verarbeiten sollen.</p>
3126 <h3>Siehe auch</h3>
3127 <ul>
3128 <li><a href="../filter.html">Filter</a>-Dokumentation</li>
3129 </ul>
3130 </div>
3131 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
3132 <div class="directive-section"><h2><a name="TimeOut" id="TimeOut">TimeOut</a>-<a name="timeout" id="timeout">Direktive</a></h2>
3133 <table class="directive">
3134 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Zeitspanne, die der Server auf verschiedene Ereignisse wartet,
3135 bevor er die Anfrage abbricht</td></tr>
3136 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>TimeOut <var>Sekunden</var></code></td></tr>
3137 <tr><th><a href="directive-dict.html#Default">Voreinstellung:</a></th><td><code>TimeOut 300</code></td></tr>
3138 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Serverkonfiguration</td></tr>
3139 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
3140 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
3141 </table>
3142 <p>Die Direktive <code class="directive">TimeOut</code> definiert derzeit die
3143 Zeitspanne, die der Apache auf drei Dinge wartet:</p>
3145 <ol>
3146 <li>Die gesamte Zeispanne, die benötigt wird, um eine GET-Anfrage
3147 zu empfangen.</li>
3149 <li>Die Zeitspanne zwischen dem Empfang von TCP-Paketen einer
3150 POST- oder PUT-Anfrage.</li>
3152 <li>Die Zeitspanne zwischen ACKs bei der Übermittlung der
3153 TCP-Pakete der Antwort.</li>
3154 </ol>
3156 <p>Wir haben vor, diese Zeitspannen in Zukunft separat konfigurierbar zu
3157 machen. Vor Version 1.2 war der Zeitgeber auf 1200 voreingestellt, wurde
3158 dann aber auf 300 herabgesetzt, was immer noch weit mehr ist, als in den
3159 meisten Situationen benötigt wird. Die Voreinstellung wurde nicht
3160 weiter herabgesetzt, da gelegentlich noch Stellen im Code existieren
3161 können, wo der Zeitgeber nicht zurückgesetzt wird, wenn ein
3162 Paket verschickt wird.</p>
3164 </div>
3165 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
3166 <div class="directive-section"><h2><a name="UseCanonicalName" id="UseCanonicalName">UseCanonicalName</a>-<a name="usecanonicalname" id="usecanonicalname">Direktive</a></h2>
3167 <table class="directive">
3168 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Bestimmt, wie der Server seinen eigenen Namen und Port
3169 ermittelt</td></tr>
3170 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>UseCanonicalName On|Off|DNS</code></td></tr>
3171 <tr><th><a href="directive-dict.html#Default">Voreinstellung:</a></th><td><code>UseCanonicalName Off</code></td></tr>
3172 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Serverkonfiguration, Virtual Host, Verzeichnis</td></tr>
3173 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
3174 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
3175 </table>
3176 <p>In vielen Situationen muss der Apache eine
3177 <em>selbstreferenzierende</em> URL -- d.h. eine URL, die auf den selben
3178 Server zurück verweist -- zusammenbauen. Bei <code>UseCanonicalName
3179 On</code> verwendet der Apache den Hostnamen und Port, der in der
3180 <code class="directive"><a href="#servername">ServerName</a></code>-Anweisung angegeben ist,
3181 um den kanonischen Namen des Servers zu erstellen. Dieser Name wird in
3182 allen selbstreferenzierenden URLs sowie in CGI-Skripten für die
3183 Werte von <code>SERVER_NAME</code> und <code>SERVER_PORT</code>
3184 verwendet.</p>
3186 <p>Bei <code>UseCanonicalName Off</code> bildet der Apache
3187 selbstreferenzierende URLs, indem er den vom Client übermittelten
3188 Hostnamen und Port verwendet, sofern diese vorhanden sind (andernfalls
3189 wird der kanonische Name, wie oben beschrieben, benutzt). Die Werte
3190 sind die gleichen, die zur Anwendung von <a href="../vhosts/name-based.html">namensbasierten virtuellen Hosts</a>
3191 verwendet werden, und sie sind mit den gleichen Clients verfügbar
3192 <span class="transnote">(<em>Anm.d.Ü.:</em> , die auch in der Lage sind, auf namensbasierte virtuelle Hosts
3193 zuzugreifen, d.h. einen <code>Host</code>-Header mitschicken)</span>.
3194 Die CGI-Variablen <code>SERVER_NAME</code> und <code>SERVER_PORT</code>
3195 werden ebenfalls aus den vom Client angeboten Werten erstellt.</p>
3197 <p>Ein Intranet-Server, auf den Anwender mit kurzen Namen wie
3198 <code>www</code> zugreifen, ist ein Beispiel, wo dies sinnvoll sein kann.
3199 Sie werden bemerken, dass der Apache den Benutzer auf
3200 <code>http://www.domain.com/splat/</code> umleitet, wenn dieser einen
3201 Kurznamen und eine URL, die einem Verzeichnis entspricht, ohne
3202 abschließenden Schrägstrich eingibt, wie z.B.
3203 <code>http://www/splat</code>. Wenn Sie Authentisierung aktiviert haben,
3204 bewirkt dies, dass der Benutzer sich zweimal identifizieren muss
3205 (einmal für <code>www</code> und noch einmal für
3206 <code>www.domain.com</code> -- lesen Sie für weitere Informationen <a href="http://httpd.apache.org/docs/misc/FAQ.html#prompted-twice">die
3207 FAQ zu diesem Thema</a>). Wenn <code class="directive">UseCanonicalName</code>
3208 jedoch auf <code>Off</code> gesetzt ist, denn wird der Apache zu
3209 <code>http://www/splat/</code> umleiten.</p>
3211 <p>Es existiert noch eine dritte Option, <code>UseCanonicalName DNS</code>,
3212 die für den Betrieb von IP-basierten Massen-Virtual-Hosts gedacht ist,
3213 um antiquierte Clients zu unterstützen, die keinen
3214 <code>Host:</code>-Header bereit stellen. Um selbstreferenzierende
3215 URLs zu ermitteln, führt der Apache bei dieser Option ein
3216 Reverse-DNS-Lookup auf die IP-Adresse des Servers aus, zu der der Client
3217 Verbindung aufgenommen hat.</p>
3219 <div class="warning"><h3>Warnung</h3>
3220 <p>Wenn CGI-Skripte Vermutungen aufgrund des Wertes von
3221 <code>SERVER_NAME</code> anstellen, können sie durch diese
3222 Option fehlschlagen. Clients steht es im Wesentlichen frei, einen Wert
3223 für den Hostnamen anzugeben, wie er will. Wenn das
3224 CGI-Skript <code>SERVER_NAME</code> jedoch lediglich dazu verwendet,
3225 selbstreferenzierende URLs zu erstellen, sollte das gerade noch
3226 in Ordnung sein.</p>
3227 </div>
3229 <h3>Siehe auch</h3>
3230 <ul>
3231 <li><code class="directive"><a href="#servername">ServerName</a></code></li>
3232 <li><code class="directive"><a href="../mod/mpm_common.html#listen">Listen</a></code></li>
3233 </ul>
3234 </div>
3235 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
3236 <div class="directive-section"><h2><a name="VirtualHost" id="VirtualHost">&lt;VirtualHost&gt;</a>-<a name="virtualhost" id="virtualhost">Direktive</a></h2>
3237 <table class="directive">
3238 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Enthält Direktiven, die nur auf bestimmte Hostnamen oder
3239 IP-Adressen angewendet werden</td></tr>
3240 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>&lt;VirtualHost
3241 <var>Adresse</var>[:<var>Port</var>] [<var>Adresse</var>[:<var>Port</var>]]
3242 ...&gt; ... &lt;/VirtualHost&gt;</code></td></tr>
3243 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Serverkonfiguration</td></tr>
3244 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
3245 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
3246 </table>
3247 <p><code class="directive">&lt;VirtualHost&gt;</code> und
3248 <code>&lt;/VirtualHost&gt;</code> werden dazu verwendet, eine Gruppe
3249 von Direktiven zusammenzufassen, die nur auf einen bestimmten virtuellen
3250 Host angewendet werden. Jede Direktive, die im Virtual-Host-Kontext
3251 zulässig ist, kann verwendet werden. Wenn der Server eine Anfrage
3252 für ein bestimmtes Dokument eines bestimmten virtuellen Hosts
3253 empfängt, dann benutzt er die im
3254 <code class="directive">&lt;VirtualHost&gt;</code>-Container enthaltenen
3255 Konfigurationsanweisungen. <var>Adresse</var> kann sein:</p>
3257 <ul>
3258 <li>Die IP-Adresse des virtuellen Hosts.</li>
3260 <li>Ein voll qualifizierter Domainname für die IP-Adresse des
3261 virtuellen Hosts.</li>
3263 <li>Das Zeichen <code>*</code>, welches nur in Kombination mit
3264 <code>NameVirtualHost *</code> verwendet wird, um allen IP-Adressen
3265 zu entsprechen.</li>
3267 <li>Die Zeichenkette <code>_default_</code>, die nur mit IP-basierten
3268 virtuellen Hosts verwendet wird, um nicht zugewiesene IP-Adressen
3269 aufzufangen.</li>
3270 </ul>
3272 <div class="example"><h3>Beispiel</h3><p><code>
3273 &lt;VirtualHost 10.1.2.3&gt;<br />
3274 <span class="indent">
3275 ServerAdmin webmaster@host.foo.com<br />
3276 DocumentRoot /www/docs/host.foo.com<br />
3277 ServerName host.foo.com<br />
3278 ErrorLog logs/host.foo.com-error_log<br />
3279 TransferLog logs/host.foo.com-access_log<br />
3280 </span>
3281 &lt;/VirtualHost&gt;
3282 </code></p></div>
3284 <p>IPv6-Adressen müssen in eckigen Klammern angegeben werden, da die
3285 optionale Portnummer sonst nicht erkannt werden kann. Hier ein
3286 IPv6-Beispiel:</p>
3288 <div class="example"><p><code>
3289 &lt;VirtualHost [2001:db8::a00:20ff:fea7:ccea]&gt;<br />
3290 <span class="indent">
3291 ServerAdmin webmaster@host.example.com<br />
3292 DocumentRoot /www/docs/host.example.com<br />
3293 ServerName host.example.com<br />
3294 ErrorLog logs/host.example.com-error_log<br />
3295 TransferLog logs/host.example.com-access_log<br />
3296 </span>
3297 &lt;/VirtualHost&gt;
3298 </code></p></div>
3300 <p>Jeder virtuelle Host muss einer anderen IP-Adresse, einem anderen Port
3301 oder einem anderen Hostnamen für den Server entsprechen. Im ersten
3302 Fall muss die Servermaschine so eingerichtet sein, dass sie IP-Pakete
3303 für mehrere Adressen akzeptiert. (Wenn der Rechner nicht mehrere
3304 Netzwerkkarten besitzt, kann dies mit dem Befehl <code>ifconfig
3305 alias</code> durchgeführt werden -- sofern Ihr Betriebssystem das
3306 unterstützt).</p>
3308 <div class="note"><h3>Anmerkung</h3>
3309 <p>Die Verwendung von <code class="directive">&lt;VirtualHost&gt;</code>
3310 beeinflusst <strong>nicht</strong>, an welchen Adressen der Apache
3311 lauscht. Sie müssen mit <code class="directive"><a href="../mod/mpm_common.html#listen">Listen</a></code> sicherstellen, dass der Apache
3312 an der richtigen Adresse lauscht.</p>
3313 </div>
3315 <p>Bei der Verwendung IP-basierter virtuellen Hosts kann der spezielle
3316 Name <code>_default_</code> benutzt werden. In diesem Fall weist
3317 der Apache jede IP-Adresse diesem virtuellen Host zu, die nicht explizit in
3318 einem anderen virtuellen Host angegeben ist. Falls kein virtueller Host
3319 <code>_default_</code> angegeben ist, wird die "Hauptserver"-Konfiguration,
3320 die aus allen Definitionen außerhalb der Virtual-Host-Abschnitte
3321 besteht, für nicht passende IPs verwendet. (Beachten Sie jedoch,
3322 dass eine IP-Adressen die zu einer <code class="directive"><a href="#namevirtualhost">NameVirtualHost</a></code>-Anweisung passt, weder den
3323 "Hauptserver" noch den virtuellen Host <code>_default_</code> verwendet.
3324 Lesen Sie für weitere Details die Dokumentation zu <a href="../vhosts/name-based.html">namensbasierten virtuell Hosts</a>.)</p>
3326 <p>Sie können einen speziellen <code>:Port</code> angeben,
3327 um den entsprechenden Port zu wechseln. Falls nicht angegeben, wird
3328 er auf den gleichen Port voreingestellt, wie die letzte
3329 <code class="directive"><a href="../mod/mpm_common.html#listen">Listen</a></code>-Anweisung des
3330 Hauptservers. Sie können auch <code>:*</code> angeben, um alle
3331 Ports dieser Adresse zu akzeptieren. (Dies wird zusammen mit
3332 <code>_default_</code> empfohlen.)</p>
3334 <div class="warning"><h3>Sicherheit</h3>
3335 <p>Lesen Sie das Dokument <a href="../misc/security_tips.html">Sicherheitshinweise</a> für
3336 Details, warum Ihre Sicherheit gefährdet sein kann, wenn das
3337 Verzeichnis, in dem Protokolldateien gespeichert werden, für
3338 jemanden anderes als den Benutzer beschreibbar ist, der den Server
3339 gestartet hat.</p>
3340 </div>
3342 <h3>Siehe auch</h3>
3343 <ul>
3344 <li><a href="../vhosts/">Apache-Dokumentation zu virtuellen
3345 Hosts</a></li>
3346 <li><a href="../dns-caveats.html">Probleme bezüglich DNS und
3347 Apache</a></li>
3348 <li><a href="../bind.html">Bestimmen, welche Adressen und Ports
3349 der Apache verwendet</a></li>
3350 <li><a href="../sections.html">Wie die Abschnitte &lt;Directory&gt;,
3351 &lt;Location&gt; und &lt;Files&gt; arbeiten</a> für eine
3352 Erläuterung, wie diese verschiedenen Abschnitte miteinander
3353 kombiniert werden, wenn eine Anfrage empfangen wird</li>
3354 </ul>
3355 </div>
3356 </div>
3357 <div class="bottomlang">
3358 <p><span>Verfügbare Sprachen: </span><a href="../de/mod/core.html" title="Deutsch">&nbsp;de&nbsp;</a> |
3359 <a href="../en/mod/core.html" hreflang="en" rel="alternate" title="English">&nbsp;en&nbsp;</a> |
3360 <a href="../ja/mod/core.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> |
3361 <a href="../tr/mod/core.html" hreflang="tr" rel="alternate" title="Türkçe">&nbsp;tr&nbsp;</a></p>
3362 </div><div id="footer">
3363 <p class="apache">Copyright 2009 The Apache Software Foundation.<br />Lizenziert unter der <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
3364 <p class="menu"><a href="../mod/">Module</a> | <a href="../mod/directives.html">Direktiven</a> | <a href="../faq/">FAQ</a> | <a href="../glossary.html">Glossar</a> | <a href="../sitemap.html">Seitenindex</a></p></div>
3365 </body></html>