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
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>
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="<-" alt="<-" src="../images/left.gif" /></a></div>
20 <a href="http://www.apache.org/">Apache</a> > <a href="http://httpd.apache.org/">HTTP-Server</a> > <a href="http://httpd.apache.org/docs/">Dokumentation</a> > <a href="../">Version 2.3</a> > <a href="./">Module</a></div>
21 <div id="page-content">
22 <div id="preamble"><h1>Apache-Kernfunktionen</h1>
24 <p><span>Verfügbare Sprachen: </span><a href="../de/mod/core.html" title="Deutsch"> de </a> |
25 <a href="../en/mod/core.html" hreflang="en" rel="alternate" title="English"> en </a> |
26 <a href="../ja/mod/core.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a></p>
28 <div class="outofdate">Diese Übersetzung ist möglicherweise
29 nicht mehr aktuell. Bitte prüfen Sie die englische Version auf
30 die neuesten Änderungen.</div>
31 <table class="module"><tr><th><a href="module-dict.html#Description">Beschreibung:</a></th><td>Ständig verfügbare Kernfunktionen des Apache HTTP
33 <tr><th><a href="module-dict.html#Status">Status:</a></th><td>Core</td></tr></table>
35 <div id="quickview"><h3 class="directives">Direktiven</h3>
37 <li><img alt="" src="../images/down.gif" /> <a href="#acceptpathinfo">AcceptPathInfo</a></li>
38 <li><img alt="" src="../images/down.gif" /> <a href="#accessfilename">AccessFileName</a></li>
39 <li><img alt="" src="../images/down.gif" /> <a href="#adddefaultcharset">AddDefaultCharset</a></li>
40 <li><img alt="" src="../images/down.gif" /> <a href="#addoutputfilterbytype">AddOutputFilterByType</a></li>
41 <li><img alt="" src="../images/down.gif" /> <a href="#allowencodedslashes">AllowEncodedSlashes</a></li>
42 <li><img alt="" src="../images/down.gif" /> <a href="#allowoverride">AllowOverride</a></li>
43 <li><img alt="" src="../images/down.gif" /> <a href="#authname">AuthName</a></li>
44 <li><img alt="" src="../images/down.gif" /> <a href="#authtype">AuthType</a></li>
45 <li><img alt="" src="../images/down.gif" /> <a href="#cgimapextension">CGIMapExtension</a></li>
46 <li><img alt="" src="../images/down.gif" /> <a href="#contentdigest">ContentDigest</a></li>
47 <li><img alt="" src="../images/down.gif" /> <a href="#defaulttype">DefaultType</a></li>
48 <li><img alt="" src="../images/down.gif" /> <a href="#directory"><Directory></a></li>
49 <li><img alt="" src="../images/down.gif" /> <a href="#directorymatch"><DirectoryMatch></a></li>
50 <li><img alt="" src="../images/down.gif" /> <a href="#documentroot">DocumentRoot</a></li>
51 <li><img alt="" src="../images/down.gif" /> <a href="#enablemmap">EnableMMAP</a></li>
52 <li><img alt="" src="../images/down.gif" /> <a href="#enablesendfile">EnableSendfile</a></li>
53 <li><img alt="" src="../images/down.gif" /> <a href="#errordocument">ErrorDocument</a></li>
54 <li><img alt="" src="../images/down.gif" /> <a href="#errorlog">ErrorLog</a></li>
55 <li><img alt="" src="../images/down.gif" /> <a href="#fileetag">FileETag</a></li>
56 <li><img alt="" src="../images/down.gif" /> <a href="#files"><Files></a></li>
57 <li><img alt="" src="../images/down.gif" /> <a href="#filesmatch"><FilesMatch></a></li>
58 <li><img alt="" src="../images/down.gif" /> <a href="#forcetype">ForceType</a></li>
59 <li><img alt="" src="../images/down.gif" /> <a href="#hostnamelookups">HostnameLookups</a></li>
60 <li><img alt="" src="../images/down.gif" /> <a href="#ifdefine"><IfDefine></a></li>
61 <li><img alt="" src="../images/down.gif" /> <a href="#ifmodule"><IfModule></a></li>
62 <li><img alt="" src="../images/down.gif" /> <a href="#include">Include</a></li>
63 <li><img alt="" src="../images/down.gif" /> <a href="#keepalive">KeepAlive</a></li>
64 <li><img alt="" src="../images/down.gif" /> <a href="#keepalivetimeout">KeepAliveTimeout</a></li>
65 <li><img alt="" src="../images/down.gif" /> <a href="#limit"><Limit></a></li>
66 <li><img alt="" src="../images/down.gif" /> <a href="#limitexcept"><LimitExcept></a></li>
67 <li><img alt="" src="../images/down.gif" /> <a href="#limitinternalrecursion">LimitInternalRecursion</a></li>
68 <li><img alt="" src="../images/down.gif" /> <a href="#limitrequestbody">LimitRequestBody</a></li>
69 <li><img alt="" src="../images/down.gif" /> <a href="#limitrequestfields">LimitRequestFields</a></li>
70 <li><img alt="" src="../images/down.gif" /> <a href="#limitrequestfieldsize">LimitRequestFieldSize</a></li>
71 <li><img alt="" src="../images/down.gif" /> <a href="#limitrequestline">LimitRequestLine</a></li>
72 <li><img alt="" src="../images/down.gif" /> <a href="#limitxmlrequestbody">LimitXMLRequestBody</a></li>
73 <li><img alt="" src="../images/down.gif" /> <a href="#location"><Location></a></li>
74 <li><img alt="" src="../images/down.gif" /> <a href="#locationmatch"><LocationMatch></a></li>
75 <li><img alt="" src="../images/down.gif" /> <a href="#loglevel">LogLevel</a></li>
76 <li><img alt="" src="../images/down.gif" /> <a href="#maxkeepaliverequests">MaxKeepAliveRequests</a></li>
77 <li><img alt="" src="../images/down.gif" /> <a href="#namevirtualhost">NameVirtualHost</a></li>
78 <li><img alt="" src="../images/down.gif" /> <a href="#options">Options</a></li>
79 <li><img alt="" src="../images/down.gif" /> <a href="#require">Require</a></li>
80 <li><img alt="" src="../images/down.gif" /> <a href="#rlimitcpu">RLimitCPU</a></li>
81 <li><img alt="" src="../images/down.gif" /> <a href="#rlimitmem">RLimitMEM</a></li>
82 <li><img alt="" src="../images/down.gif" /> <a href="#rlimitnproc">RLimitNPROC</a></li>
83 <li><img alt="" src="../images/down.gif" /> <a href="#satisfy">Satisfy</a></li>
84 <li><img alt="" src="../images/down.gif" /> <a href="#scriptinterpretersource">ScriptInterpreterSource</a></li>
85 <li><img alt="" src="../images/down.gif" /> <a href="#serveradmin">ServerAdmin</a></li>
86 <li><img alt="" src="../images/down.gif" /> <a href="#serveralias">ServerAlias</a></li>
87 <li><img alt="" src="../images/down.gif" /> <a href="#servername">ServerName</a></li>
88 <li><img alt="" src="../images/down.gif" /> <a href="#serverpath">ServerPath</a></li>
89 <li><img alt="" src="../images/down.gif" /> <a href="#serverroot">ServerRoot</a></li>
90 <li><img alt="" src="../images/down.gif" /> <a href="#serversignature">ServerSignature</a></li>
91 <li><img alt="" src="../images/down.gif" /> <a href="#servertokens">ServerTokens</a></li>
92 <li><img alt="" src="../images/down.gif" /> <a href="#sethandler">SetHandler</a></li>
93 <li><img alt="" src="../images/down.gif" /> <a href="#setinputfilter">SetInputFilter</a></li>
94 <li><img alt="" src="../images/down.gif" /> <a href="#setoutputfilter">SetOutputFilter</a></li>
95 <li><img alt="" src="../images/down.gif" /> <a href="#timeout">TimeOut</a></li>
96 <li><img alt="" src="../images/down.gif" /> <a href="#usecanonicalname">UseCanonicalName</a></li>
97 <li><img alt="" src="../images/down.gif" /> <a href="#virtualhost"><VirtualHost></a></li>
101 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
102 <div class="directive-section"><h2><a name="AcceptPathInfo" id="AcceptPathInfo">AcceptPathInfo</a>-<a name="acceptpathinfo" id="acceptpathinfo">Direktive</a></h2>
103 <table class="directive">
104 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Ressourcen lassen angehängte Pfadangaben zu</td></tr>
105 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>AcceptPathInfo On|Off|Default</code></td></tr>
106 <tr><th><a href="directive-dict.html#Default">Voreinstellung:</a></th><td><code>AcceptPathInfo Default</code></td></tr>
107 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Serverkonfiguration, Virtual Host, Verzeichnis, .htaccess</td></tr>
108 <tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>FileInfo</td></tr>
109 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
110 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
111 <tr><th><a href="directive-dict.html#Compatibility">Kompatibilität:</a></th><td>Verfügbar ab Apache 2.0.30</td></tr>
113 <p>Die Direktive steuert, ob Anfragen akzeptiert oder
114 abgewiesen werden, bei denen nach der tatsächlichen
115 Datei (oder einer nicht existierenden Datei in einem existierenden
116 Verzeichnis) zusätzliche Pfadangaben folgen. Die angehängte
117 Pfadangabe kann Skripten in der Umgebungsvariable <code>PATH_INFO</code>
118 verfügbar gemacht werden.</p>
120 <p>Nehmen wir beispielsweise an, dass <code>/test/</code> auf ein
121 Verzeichnis zeigt, welches lediglich eine Datei <code>here.html</code>
122 enthält. Dann wird bei Anfragen nach
123 <code>/test/here.html/more</code> und
124 <code>/test/nothere.html/more</code> beides Mal <code>/more</code>
125 als <code>PATH_INFO</code> ermittelt.</p>
127 <p>Die drei möglichen Argumente für die Direktive
128 <code class="directive">AcceptPathInfo</code> sind:</p>
131 <dt><code>Off</code></dt><dd>Eine Anfrage wird nur dann akzeptiert,
132 wenn sie exakt auf ein existierendes Verzeichnis (oder eine Datei)
133 abgebildet werden kann. Daher würde eine Anfrage mit einer nach dem
134 tatsächlichen Dateinamen angehängten Pfadangabe, wie
135 <code>/test/here.html/more</code> im obigen Beispiel, den Fehler
136 404 NOT FOUND <span class="transnote">(<em>Anm.d.Ü.:</em> nicht gefunden)</span>
139 <dt><code>On</code></dt>
140 <dd>Eine Anfrage wird akzeptiert, wenn eine vorangestellte Pfadangabe
141 auf ein existierendes Verzeichnis abgebildet werden kann. Das
142 obige Beispiel <code>/test/here.html/more</code> wird akzeptiert,
143 wenn <code>/test/here.html</code> auf eine gültige Datei
146 <dt><code>Default</code></dt>
147 <dd>Die Behandlung von Anfragen mit angehängten Pfadangaben
148 wird von dem für die Anfrage verantwortlichen <a href="../handler.html">Handler</a> bestimmt. Der Core-Handler
149 für gewöhnliche Dateien weist <code>PATH_INFO</code>-Zugriffe
150 standardmäßig zurück. Handler, die Skripte bedienen,
151 wie z.B. <a href="mod_cgi.html">cgi-script</a> und
152 <a href="mod_isapi.html">isapi-handler</a>, sind im Allgemeinen darauf
153 voreingestellt, <code>PATH_INFO</code> zu akzeptieren.</dd>
156 <p>Das eigentliche Ziel von <code>AcceptPathInfo</code> ist es, Ihnen
157 das Überschreiben der Voreinstellung der Handler bezüglich
158 der Akzeptanz oder Ablehnung von <code>PATH_INFO</code> zu erlauben.
159 Eine solche Änderung ist zum Beispiel notwendig, wenn Sie einen
160 <a href="../filter.html">Filter</a> wie <a href="mod_include.html">INCLUDES</a> verwenden, um Inhalte
161 abhängig von <code>PATH_INFO</code> zu generieren. Der
162 Core-Handler würde die Anfrage normalerweise abweisen. Verwenden
163 Sie die folgende Konfiguration, um dennoch solch ein Skript zu
166 <div class="example"><p><code>
167 <Files "mypaths.shtml"><br />
168 <span class="indent">
169 Options +Includes<br />
170 SetOutputFilter INCLUDES<br />
171 AcceptPathInfo On<br />
178 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
179 <div class="directive-section"><h2><a name="AccessFileName" id="AccessFileName">AccessFileName</a>-<a name="accessfilename" id="accessfilename">Direktive</a></h2>
180 <table class="directive">
181 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Name der dezentralen Konfigurationsdateien</td></tr>
182 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>AccessFileName <var>Dateiname</var> [<var>Dateiname</var>] ...</code></td></tr>
183 <tr><th><a href="directive-dict.html#Default">Voreinstellung:</a></th><td><code>AccessFileName .htaccess</code></td></tr>
184 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Serverkonfiguration, Virtual Host</td></tr>
185 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
186 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
188 <p>Aus dieser Namensliste sucht der Server während der
189 Bearbeitung einer Anfrage in jedem Verzeichnis nach der ersten
190 existierenden Datei, sofern im betreffenden Verzeichnis dezentrale
191 Konfigurationsdateien <a href="#allowoverride">erlaubt sind</a>.
194 <div class="example"><p><code>
198 <p>Vor der Rücksendung des Dokuments
199 <code>/usr/local/web/index.html</code> wird der Server
200 <code>/.acl</code>, <code>/usr/.acl</code>,
201 <code>/usr/local/.acl</code> und <code>/usr/local/web/.acl</code>
202 einlesen, solange diese nicht mit</p>
204 <div class="example"><p><code>
205 <Directory /><br />
206 <span class="indent">
207 AllowOverride None<br />
212 <p>deaktiviert wurden.</p>
216 <li><code class="directive"><a href="#allowoverride">AllowOverride</a></code></li>
217 <li><a href="../configuring.html">Konfigurationsdateien</a></li>
218 <li><a href="../howto/htaccess.html">.htaccess-Dateien</a></li>
221 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
222 <div class="directive-section"><h2><a name="AddDefaultCharset" id="AddDefaultCharset">AddDefaultCharset</a>-<a name="adddefaultcharset" id="adddefaultcharset">Direktive</a></h2>
223 <table class="directive">
224 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Standard-Charset-Parameter, der bei Antworten vom Content-Type
225 <code>text/plain</code> oder <code>text/html</code> hinzugefügt wird
227 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>AddDefaultCharset On|Off|<var>Zeichenkodierung</var></code></td></tr>
228 <tr><th><a href="directive-dict.html#Default">Voreinstellung:</a></th><td><code>AddDefaultCharset Off</code></td></tr>
229 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Serverkonfiguration, Virtual Host, Verzeichnis, .htaccess</td></tr>
230 <tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>FileInfo</td></tr>
231 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
232 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
234 <p>Die Direktive gibt einen Standardwert für den Charset-Paramter des
235 Medientyps (den Namen einer Zeichencodierung) an, der einer Antwort
236 genau dann hinzugefügt wird, wenn der Content-Type der Antwort entweder
237 <code>text/plain</code> oder <code>text/html</code> ist. Dies sollte jedes
238 mittels <code>META</code>-Element im Datenteil der Antwort angegebene
239 Charset überschreiben. Das genaue Verhalten hängt jedoch oft von
240 der Client-Konfiguration des Benutzers ab. Die Einstellung
241 <code>AddDefaultCharset Off</code> deaktiviert diese Funktionalität.
242 <code>AddDefaultCharset On</code> aktiviert die Standard-Zeichenkodierung
243 <code>iso-8859-1</code>. Jeder andere Wert wird als die zu verwendende
244 <var>Zeichenkodierung</var> aufgefaßt, die eines der bei <a href="http://www.iana.org/assignments/character-sets">IANA registrierten
245 Charset-Werte</a> zur Verwendung in MIME-Medientypen sein sollte. Zum
248 <div class="example"><p><code>
249 AddDefaultCharset utf-8
252 <p><code class="directive">AddDefaultCharset</code> sollte nur verwendet werden,
253 wenn von allen Textressourcen, für die es gilt, bekannt ist, dass sie
254 in dieser Zeichkodierung vorliegen, oder wenn es zu unbequem ist, ihre
255 Zeichenkodierung indivuell zu benennen. Ein solches Beispiel ist das
256 Hinzufügen des Charset-Parameters zu Ressourcen, die generierte
257 Inhalte enthalten. Ein Beispiel sind CGI-Skript-Altlasten, die aufgrund von
258 in die Ausgabe integrierten Daten, die durch den Benutzer übermittelt
259 wurden, gegen Cross-Site-Scripting-Angriffe verwundbar sind. Eine bessere
260 Lösung wäre jedoch, diese Skripte zu korrigieren (oder zu
261 löschen), da die Angabe einer Standard-Zeichencodierung keine
262 Anwender schützt, die in ihrem Browser die Funktion zur
263 automatischen Erkennung der Zeichenkodierung aktiviert haben.</p>
267 <li><code class="directive"><a href="../mod/mod_mime.html#addcharset">AddCharset</a></code></li>
270 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
271 <div class="directive-section"><h2><a name="AddOutputFilterByType" id="AddOutputFilterByType">AddOutputFilterByType</a>-<a name="addoutputfilterbytype" id="addoutputfilterbytype">Direktive</a></h2>
272 <table class="directive">
273 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>einen Ausgabefilter einem bestimmten MIME-Type
275 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>AddOutputFilterByType <var>Filter</var>[;<var>Filter</var>...]
276 <var>MIME-Type</var> [<var>MIME-Type</var>] ...</code></td></tr>
277 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Serverkonfiguration, Virtual Host, Verzeichnis, .htaccess</td></tr>
278 <tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>FileInfo</td></tr>
279 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
280 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
281 <tr><th><a href="directive-dict.html#Compatibility">Kompatibilität:</a></th><td>Verfügbar ab Apache 2.0.33</td></tr>
283 <p>Die Direktive aktiviert für eine Anfrage abhängig vom
284 MIME-Type der Antwort einen bestimmten Ausgabe-<a href="../filter.html">Filter</a>.</p>
286 <p>Das folgende Beispiel verwendet den Filter <code>DEFLATE</code>,
287 der von <code class="module"><a href="../mod/mod_deflate.html">mod_deflate</a></code> angeboten wird. Er komprimiert
288 jede Ausgabe, die als <code>text/html</code> oder <code>text/plain</code>
289 gekennzeichnet ist, (gleichgültig, ob statisch oder dynamisch)
290 bevor sie an den Client gesendet wird.</p>
292 <div class="example"><p><code>
293 AddOutputFilterByType DEFLATE text/html text/plain
296 <p>Wenn Sie den Inhalt von mehr als einem Filter verarbeiten lassen
297 wollen, dann müssen deren Namen durch Semikolons voneinander
298 getrennt werden. Es ist ebenfalls möglich, eine
299 <code class="directive">AddOutputFilterByType</code>-Direktive für
300 jeden von diesen Filtern zu verwenden.</p>
302 <p>Die folgende Konfiguration sorgt dafür, dass alle
303 Skriptausgaben, die als <code>text/html</code> gekennzeichnet
304 sind, zuerst vom <code>INCLUDES</code>-Filter und dann vom
305 <code>DEFLATE</code>-Filter verarbeitet werden.</p>
307 <div class="example"><p><code>
308 <Location /cgi-bin/><br />
309 <span class="indent">
310 Options Includes<br />
311 AddOutputFilterByType INCLUDES;DEFLATE text/html<br />
316 <div class="warning"><h3>Hinweis:</h3>
317 <p>Die Aktivierung von Filtern mittels
318 <code class="directive">AddOutputFilterByType</code> kann in einigen
319 Fällen ganz oder teilweise fehlschlagen. Beispielsweise
320 werden keine Filter angewendet, wenn der MIME-Type nicht bestimmt
321 werden kann und auf die Einstellung der <code class="directive"><a href="#defaulttype">DefaultType</a></code>-Anweisung zurückfällt,
322 selbst wenn die <code class="directive"><a href="#defaulttype">DefaultType</a></code>-Einstellung die gleiche ist.</p>
324 <p>Wenn Sie jedoch sicherstellen wollen, dass der Filter
325 angewendet wird, sollten Sie den Content-Type z.B. mit
326 <code class="directive"><a href="../mod/mod_mime.html#addtype">AddType</a></code> oder
327 <code class="directive"><a href="#forcetype">ForceType</a></code> der Ressource
328 explizit zuordnen. Das Setzen des Content-Types innerhalb
329 eines (nicht-nph) CGI-Skriptes funktioniert ebenfalls
332 <p>Die Typ-gebundenen Ausgabefilter werden niemals auf
333 Proxy-Anfragen angewendet.</p>
338 <li><code class="directive"><a href="../mod/mod_mime.html#addoutputfilter">AddOutputFilter</a></code></li>
339 <li><code class="directive"><a href="#setoutputfilter">SetOutputFilter</a></code></li>
340 <li><a href="../filter.html">Filter</a></li>
343 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
344 <div class="directive-section"><h2><a name="AllowEncodedSlashes" id="AllowEncodedSlashes">AllowEncodedSlashes</a>-<a name="allowencodedslashes" id="allowencodedslashes">Direktive</a></h2>
345 <table class="directive">
346 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Legt fest, ob kodierte Pfadtrennzeichen in URLs durchgereicht
347 werden dürfen</td></tr>
348 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>AllowEncodedSlashes On|Off</code></td></tr>
349 <tr><th><a href="directive-dict.html#Default">Voreinstellung:</a></th><td><code>AllowEncodedSlashes Off</code></td></tr>
350 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Serverkonfiguration, Virtual Host</td></tr>
351 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
352 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
353 <tr><th><a href="directive-dict.html#Compatibility">Kompatibilität:</a></th><td>Verfügbar ab Apache 2.0.46</td></tr>
355 <p>Die <code class="directive">AllowEncodedSlashes</code>-Direktive erlaubt die
356 Verwendung von URLs, welche kodierte Pfadtrennzeichen (<code>%2F</code>
357 für <code>/</code> und auf entsprechenden Systemen zusätzlich
358 <code>%5C</code> für <code>\</code>) enthalten. Normalerweise werden
359 derartige URLs mit einem 404-Fehler (Nicht gefunden) abgewiesen.</p>
361 <p><code class="directive">AllowEncodedSlashes</code> <code>On</code> ist
362 vor allem in Verbindung mit <code>PATH_INFO</code> hilfreich.</p>
364 <div class="note"><h3>Anmerkung</h3>
365 <p>Das Erlauben von Schrägstrichen impliziert <em>nicht</em> deren
366 <em>Dekodierung</em>. Vorkommen von <code>%2F</code> oder <code>%5C</code>
367 (<em>nur</em> auf entsprechenden Systemen) werden unverändert in der
368 ansonsten dekodierten URL belassen.</p>
373 <li><code class="directive"><a href="#acceptpathinfo">AcceptPathInfo</a></code></li>
376 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
377 <div class="directive-section"><h2><a name="AllowOverride" id="AllowOverride">AllowOverride</a>-<a name="allowoverride" id="allowoverride">Direktive</a></h2>
378 <table class="directive">
379 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Direktiven-Typen, die in <code>.htaccess</code>-Dateien
380 erlaubt sind.</td></tr>
381 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>AllowOverride All|None|<var>Direktiven-Typ</var>
382 [<var>Direktiven-Typ</var>] ...</code></td></tr>
383 <tr><th><a href="directive-dict.html#Default">Voreinstellung:</a></th><td><code>AllowOverride All</code></td></tr>
384 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Verzeichnis</td></tr>
385 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
386 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
388 <p>Wenn der Server eine <code>.htaccess</code>-Datei (wie durch
389 <code class="directive"><a href="#accessfilename">AccessFileName</a></code> definiert)
390 findet, muss er wissen, welche in der Datei angegebenen Direktiven
391 frühere Konfigurationsanweisungen überschreiben
394 <div class="note"><h3>Nur in <Directory>-Abschnitten verfügbar</h3>
395 <code class="directive">AllowOverride</code> ist nur in <code class="directive"><a href="#directory"><Directory></a></code>-Abschnitten
396 gültig, die ohne reguläre Ausdrücke definiert wurden, nicht
397 in <code class="directive"><a href="#location"><Location></a></code>-,
398 <code class="directive"><a href="#directorymatch"><DirectoryMatch></a></code>- oder
399 <code class="directive"><a href="#files"><Files></a></code>-Abschnitten.
402 <p>Wenn diese Anweisung auf <code>None</code> gesetzt wird, dann
403 werden <a href="#accessfilename">.htaccess</a>-Dateien komplett
404 ignoriert. In diesem Fall wird der Server nicht einmal versuchen,
405 die <code>.htaccess</code>-Dateien im Dateisystem zu lesen.</p>
407 <p>Wenn diese Anweisung auf <code>All</code> gesetzt wird, dann
408 ist jede Direktive in den <code>.htaccess</code>-Dateien erlaubt,
409 die den <a href="directive-dict.html#Context">Kontext</a>
410 .htaccess besitzt.</p>
412 <p>Der <var>Direktiven-Typ</var> kann eine der folgenden
413 Anweisungsgruppen sein.</p>
419 Erlaubt die Verwendung von Autorisierungs-Anweisungen (<code class="directive"><a href="../mod/mod_authn_dbm.html#authdbmgroupfile">AuthDBMGroupFile</a></code>,
420 <code class="directive"><a href="../mod/mod_authn_dbm.html#authdbmuserfile">AuthDBMUserFile</a></code>,
421 <code class="directive"><a href="../mod/mod_authz_groupfile.html#authgroupfile">AuthGroupFile</a></code>,
422 <code class="directive"><a href="#authname">AuthName</a></code>,
423 <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>
428 Erlaubt die Verwendung von Direktiven zur Steuerung der
429 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>,
430 <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
431 <code class="module"><a href="../mod/mod_mime.html">mod_mime</a></code>-Direktiven Add* und Remove*
437 Erlaubt die Verwendung von Direktiven zur Steuerung von
438 Verzeichnisindizes (<code class="directive"><a href="../mod/mod_autoindex.html#adddescription">AddDescription</a></code>,
439 <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>,
440 <code class="directive"><a href="../mod/mod_autoindex.html#addiconbytype">AddIconByType</a></code>,
441 <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>
447 Erlaubt die Verwendung von Direktiven zur Steuerung des
448 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>
450 <dt>Options[=<var>Option</var>,...]</dt>
453 Erlaubt die Verwendung von Direktiven zur Steuerung spezieller
454 Verzeichniseigenschaften (<code class="directive"><a href="#options">Options</a></code>
455 und <code class="directive"><a href="../mod/mod_include.html#xbithack">XBitHack</a></code>). Sie
456 können mit einem Gleichheitszeichen gefolgt von einer
457 kommaseparierten Liste (ohne Leerzeichen) angeben, welche Optionen mit
458 der <code class="directive"><a href="#options">Options</a></code>-Direktive gesetzt
464 <div class="example"><p><code>
465 AllowOverride AuthConfig Indexes
468 <p>Im obigen Beispiel erzeugen alle Direktiven einen internal server
469 error <span class="transnote">(<em>Anm.d.Ü.:</em> Server-interner Fehler)</span>, die weder der
470 Gruppe <code>AuthConfig</code> noch der Gruppe <code>Indexes</code>
475 <li><code class="directive"><a href="#accessfilename">AccessFileName</a></code></li>
476 <li><a href="../configuring.html">Konfigurationsdateien</a></li>
477 <li><a href="../howto/htaccess.html">.htaccess-Dateien</a></li>
480 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
481 <div class="directive-section"><h2><a name="AuthName" id="AuthName">AuthName</a>-<a name="authname" id="authname">Direktive</a></h2>
482 <table class="directive">
483 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Autorisierungsbereich zur Verwendung in der
484 HTTP-Authentisierung</td></tr>
485 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>AuthName <var>auth-Bereich</var></code></td></tr>
486 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Verzeichnis, .htaccess</td></tr>
487 <tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>AuthConfig</td></tr>
488 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
489 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
491 <p>Die Direktive legt den Namen des Autorisierungsbereiches
492 <span class="transnote">(<em>Anm.d.Ü.:</em> Der Autorisierungsbereich wird auch Realm genannt.)</span>
493 für ein Verzeichnis fest. Dieser Realm wird dem Client mitgeteilt,
494 damit der Anwender weiß, welchen Benutzernamen und welches Passwort
495 er zu übermitteln hat. <code class="directive">AuthName</code> akzeptiert ein
496 Argument. Falls der Name des Realm Leerzeichen enthält, muss er in
497 Anführungszeichen eingeschlossen werden. Um zu funktionieren, muss
498 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
499 Direktiven wie <code class="directive"><a href="../mod/mod_authn_file.html#authuserfile">AuthUserFile</a></code>
500 und <code class="directive"><a href="../mod/mod_authz_groupfile.html#authgroupfile">AuthGroupFile</a></code>
501 begleitet werden.</p>
505 <div class="example"><p><code>
506 AuthName "Top Secret"
509 <p>Die <code>AuthName</code> übergebene Zeichenkette ist das,
510 was in dem von den meisten Browsern angebotenen Passwort-Dialog
515 <li><a href="../howto/auth.html">Authentisierung, Autorisierung und
516 Zugriffskontrolle</a></li>
519 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
520 <div class="directive-section"><h2><a name="AuthType" id="AuthType">AuthType</a>-<a name="authtype" id="authtype">Direktive</a></h2>
521 <table class="directive">
522 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Art der Authentisierung</td></tr>
523 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>AuthType Basic|Digest</code></td></tr>
524 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Verzeichnis, .htaccess</td></tr>
525 <tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>AuthConfig</td></tr>
526 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
527 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
529 <p>Die Direktive wählt die Art der Benutzer-Authentisierung
530 für ein Verzeichnis aus. Derzeit sind lediglich <code>Basic</code>
531 und <code>Digest</code> implementiert.
532 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
533 Direktiven wie <code class="directive"><a href="../mod/mod_authn_file.html#authuserfile">AuthUserFile</a></code>
534 und <code class="directive"><a href="../mod/mod_authz_groupfile.html#authgroupfile">AuthGroupFile</a></code>
535 begleitet werden.</p>
539 <li><a href="../howto/auth.html">Authentisierung, Autorisierung und
540 Zugriffskontrolle</a></li>
543 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
544 <div class="directive-section"><h2><a name="CGIMapExtension" id="CGIMapExtension">CGIMapExtension</a>-<a name="cgimapextension" id="cgimapextension">Direktive</a></h2>
545 <table class="directive">
546 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Technik zur Bestimmung des Interpreters für
547 CGI-Skripte</td></tr>
548 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>CGIMapExtension <var>CGI-Pfad</var> <var>.Endung</var></code></td></tr>
549 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Verzeichnis, .htaccess</td></tr>
550 <tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>FileInfo</td></tr>
551 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
552 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
553 <tr><th><a href="directive-dict.html#Compatibility">Kompatibilität:</a></th><td>ausschließlich NetWare</td></tr>
555 <p>Die Direktive wird zur Steuerung verwendet, wie Apache
556 den Interpreter ermittelt, der zur Ausführung von
557 CGI-Skripten verwendet wird. Beispielsweise bestimmt die Angabe
558 von <code>CGIMapExtension sys:\foo.nlm .foo</code>, dass
559 alle CGI-Scripte mit der Endung <code>.foo</code> an den
560 FOO-Interpreter übergeben werden.</p>
563 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
564 <div class="directive-section"><h2><a name="ContentDigest" id="ContentDigest">ContentDigest</a>-<a name="contentdigest" id="contentdigest">Direktive</a></h2>
565 <table class="directive">
566 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Aktiviert die Generierung von <code>Content-MD5</code>
567 HTTP-Response-Headern</td></tr>
568 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>ContentDigest On|Off</code></td></tr>
569 <tr><th><a href="directive-dict.html#Default">Voreinstellung:</a></th><td><code>ContentDigest Off</code></td></tr>
570 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Serverkonfiguration, Virtual Host, Verzeichnis, .htaccess</td></tr>
571 <tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>Options</td></tr>
572 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
573 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
575 <p>Die Direktive aktiviert die Generierung von
576 <code>Content-MD5</code>-Headern, wie sie in RFC1864 bzw. RFC2068
579 <p>MD5 ist ein Algorithmus zur Berechnung eines "Datenextrakts"
580 (zuweilen "Fingerabdruck" genannt) <span class="transnote">(<em>Anm.d.Ü.:</em> Der "Datenextrakt" wird im
581 Englischen als "message digest" oder "fingerprint" bezeichnet.)</span>
582 aus beliebig langen Daten. Es gilt als zuverlässig, dass
583 Veränderungen an den Daten sich in Veränderungen des
584 Extrakts wiederspiegeln.</p>
586 <p>Der <code>Content-MD5</code>-Header bietet eine
587 End-to-End-Integritätsprüfung (MIC) <span class="transnote">(<em>Anm.d.Ü.:</em> MIC steht für
588 "message integrity check".)</span> des Daten-Inhalts. Ein Proxy oder
589 Client kann diesen Header prüfen, um zufällige Veränderungen
590 des Entity-Inhalts bei der Übertragung festzustellen.
593 <div class="example"><p><code>
594 Content-MD5: AuLb7Dp1rqtRtxz2m9kRpA==
597 <p>Beachten Sie bitte, dass dies Performanceprobleme auf Ihrem
598 System verursachen kann, da der Extrakt bei jeder Anfrage
599 berechnet wird (der Wert wird nicht zwischengespeichert).</p>
601 <p><code>Content-MD5</code> wird nur für Dokumente gesendet,
602 die von <code class="module"><a href="../mod/core.html">core</a></code> bedient werden, nicht jedoch bei
603 Modulen. SSI-Dokumente, CGI-Skript-Ausgaben und Byte-Range-Antworten
604 besitzen diesen Header beispielsweise nicht.</p>
607 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
608 <div class="directive-section"><h2><a name="DefaultType" id="DefaultType">DefaultType</a>-<a name="defaulttype" id="defaulttype">Direktive</a></h2>
609 <table class="directive">
610 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>MIME-Content-Type, der gesendet wird, wenn der Server den Typ
611 nicht auf andere Weise ermitteln kann.</td></tr>
612 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>DefaultType <var>MIME-Type</var></code></td></tr>
613 <tr><th><a href="directive-dict.html#Default">Voreinstellung:</a></th><td><code>DefaultType text/plain</code></td></tr>
614 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Serverkonfiguration, Virtual Host, Verzeichnis, .htaccess</td></tr>
615 <tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>FileInfo</td></tr>
616 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
617 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
619 <p>Es kann vorkommen, dass der Server ein Dokument ausliefern muss,
620 dessen Typ er nicht mit Hilfe seiner MIME-Type-Zuordnungen bestimmen
623 <p>Der Server muss den Client über den Content-Type des
624 Dokumentes informieren. Daher verwendet er im Falle eines
625 unbekannten Typs die <code>DefaultType</code>-Einstellung.
628 <div class="example"><p><code>
629 DefaultType image/gif
632 <p>wäre angemessen für ein Verzeichnis, das viele GIF-Bilder
633 enthält, deren Dateinamen nicht Endung <code>.gif</code>
636 <p>Beachten Sie bitte, dass die Direktive anders als <code class="directive"><a href="#forcetype">ForceType</a></code> lediglich den Standard-MIME-Type
637 bestimmt. Alle anderen MIME-Type-Definitionen, einschließlich
638 Dateierweiterungen, die den Medien-Typ anzeigen können,
639 überschreiben diese Voreinstellung.</p>
642 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
643 <div class="directive-section"><h2><a name="Directory" id="Directory"><Directory></a>-<a name="directory" id="directory">Direktive</a></h2>
644 <table class="directive">
645 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Umschließt eine Gruppe von Direktiven, die nur auf
646 das genannte Verzeichnis des Dateisystems und Unterverzeichnisse angewendet
648 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code><Directory <var>Verzeichnispfad</var>>
649 ... </Directory></code></td></tr>
650 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Serverkonfiguration, Virtual Host</td></tr>
651 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
652 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
654 <p><code class="directive"><Directory></code> und
655 <code></Directory></code> werden dazu verwendet, eine Gruppe
656 von Direktiven zusammenzufassen, die nur für das genannte
657 Verzeichnis und dessen Unterverzeichnisse gelten. Jede Direktive,
658 die im Verzeichnis-Kontext erlaubt ist, kann verwendet werden.
659 <var>Verzeichnispfad</var> ist entweder der vollständige Pfad zu
660 einem Verzeichnis oder eine Zeichenkette mit Platzhaltern wie sie von der
661 Unix-Shell zum Abgleich verwendet werden. In einer Zeichenkette
662 mit Platzhaltern <span class="transnote">(<em>Anm.d.Ü.:</em> sogenannte wild-cards)</span> entspricht
663 <code>?</code> einem einzelnen Zeichen und <code>*</code> einer
664 Zeichenkette beliebiger Länge. Sie können auch auch
665 <code>[]</code>-Zeichenbereiche verwenden. Keiner der Platzhalter
666 entspricht dem Zeichen "/". Daher passt <code><Directory
667 /*/public_html></code> nicht auf <code>/home/user/public_html</code>,
668 <code><Directory /home/*/public_html></code> jedoch tut es.
671 <div class="example"><p><code>
672 <Directory /usr/local/httpd/htdocs><br />
673 <span class="indent">
674 Options Indexes FollowSymLinks<br />
680 <p>Seien Sie vorsichtig mit den <var>Verzeichnispfad</var>-Argumenten.
681 Sie müssen buchstäblich mit dem Dateisystempfad
682 übereinstimmen, den der Apache für den Zugriff auf die
683 Dateien verwendet. Direktiven, die für ein bestimmtes
684 Verzeichnis gelten, gelten nicht für Dateien in dem Verzeichnis,
685 auf die über einen anderen Pfad zugegriffen wird, wie z.B.
686 über verschiedene symbolische Links.</p>
689 <p>Erweiterte reguläre Ausdrücke können ebenfalls
690 verwendet werden, indem das Zeichen <code>~</code> hinzugefügt
691 wird. Beispielsweise würde</p>
693 <div class="example"><p><code>
694 <Directory ~ "^/www/.*/[0-9]{3}">
697 <p>auf Verzeichnisse in <code>/www/</code> passen, die aus drei
700 <p>Wenn mehrere <code class="directive"><Directory></code>-Abschnitte
701 (ohne reguläre Ausdrücke) auf ein Verzeichnis (oder
702 ein ihm übergeordnetes Verzeichnis) passen, welches ein Dokument
703 enthält, dann werden die Direktiven der Reihe nach, angefangen
704 beim kürzesten passenden Muster, vermischt mit den Direktiven
705 aus den <a href="#accessfilename">.htaccess</a>-Dateien, angewendet.
708 <div class="example"><p><code>
709 <Directory /><br />
710 <span class="indent">
711 AllowOverride None<br />
713 </Directory><br />
715 <Directory /home/><br />
716 <span class="indent">
717 AllowOverride FileInfo<br />
722 <p>Beim Zugriff auf das Dokument <code>/home/web/dir/doc.html</code>
723 sind die einzelnen Schritte:</p>
726 <li>Wende die Direktive <code>AllowOverride None</code> an
727 (deaktiviere <code>.htaccess</code>-Dateien).</li>
729 <li>Wende die Direktive <code>AllowOverride FileInfo</code>
730 (auf das Verzeichnis <code>/home</code>) an.</li>
732 <li>Wende jede <code>FileInfo</code>-Direktive aus
733 <code>/home/.htaccess</code>, <code>/home/web/.htaccess</code> und
734 <code>/home/web/dir/.htaccess</code> der Reihe nach an.</li>
737 <p>Reguläre Ausdrücke werden solange nicht berücksichtigt,
738 bis alle normalen Abschnitte angewendet wurden. Anschließend
739 werden alle regulären Ausdrücke in der Reihenfolge
740 geprüft, in der sie in der Konfigurationsdatei auftauchen.
741 Beispielsweise wird bei</p>
743 <div class="example"><p><code>
744 <Directory ~ abc$><br />
745 <span class="indent">
746 # ... hier die Direktiven ...<br />
751 <p>der Abschnitt mit dem regulären Ausdruck nicht
752 berücksichtigt, bis alle normalen
753 <code class="directive"><Directory></code>-Abschnitte und
754 <code>.htaccess</code>-Dateien angewendet wurden. Dann erst wird
755 der reguläre Ausdruck mit <code>/home/abc/public_html/abc</code>
756 abgeglichen und der entsprechende <code class="directive"><Directory></code>-Abschnitt angewendet.</p>
758 <p><strong>Beachten Sie bitte, dass der vom Apache voreingestellte
759 Zugriff für <code><Directory /></code>
760 <code>Allow from All</code> ist. Das bedeutet, dass der Apache
761 jede Datei ausliefert, die durch eine URL abgebildet wird. Es wird
762 empfohlen, dass Sie dies durch einen Block wie</strong></p>
764 <div class="example"><p><code>
765 <Directory /><br />
766 <span class="indent">
767 Order Deny,Allow<br />
773 <p><strong>ändern und anschließend für
774 Verzeichnisse überschreiben, die Sie verfügbar machen
775 <em>wollen</em>. Für weitere Einzelheiten lesen Sie bitte
776 die Seite zu den <a href="../misc/security_tips.html">Sicherheitshinweisen</a>.</strong></p>
778 <p>Die Verzeichnisabschnitte erscheinen in der Datei
779 <code>httpd.conf</code>. <code class="directive"><Directory></code>-Direktiven dürfen nicht
780 ineinander verschachtelt werden oder innerhalb von <code class="directive"><a href="#limit"><Limit></a></code>- oder <code class="directive"><a href="#limitexcept"><LimitExcept></a></code>-Abschnitten auftauchen.</p>
784 <li><a href="../sections.html">Wie die Abschnitte <Directory>,
785 <Location> und <Files> arbeiten</a> für eine
786 Erläuterung, wie diese verschiedenen Abschnitte miteinander
787 kombiniert werden, wenn eine Anfrage empfangen wird</li>
790 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
791 <div class="directive-section"><h2><a name="DirectoryMatch" id="DirectoryMatch"><DirectoryMatch></a>-<a name="directorymatch" id="directorymatch">Direktive</a></h2>
792 <table class="directive">
793 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Umschließt eine Gruppe von Direktiven, die auf
794 Verzeichnisse des Dateisystems und ihre Unterverzeichnisse abgebildet
795 werden, welche auf einen regulären Ausdruck passen</td></tr>
796 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code><DirectoryMatch <var>regex</var>>
797 ... </DirectoryMatch></code></td></tr>
798 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Serverkonfiguration, Virtual Host</td></tr>
799 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
800 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
802 <p><code class="directive"><DirectoryMatch></code> und
803 <code></DirectoryMatch></code> werden dazu verwendet, eine
804 Gruppe von Direktiven zusammenzufassen, die nur für das
805 genannte Verzeichnis und dessen Unterverzeichnisse gelten, genauso
806 wie bei <code class="directive"><a href="#directory"><Directory></a></code>.
807 Als Argument dient jedoch ein regulärer Ausdruck.
808 Beispielsweise würde</p>
810 <div class="example"><p><code>
811 <DirectoryMatch "^/www/.*/[0-9]{3}">
814 <p>auf Verzeichnisse in <code>/www/</code> passen, die aus drei
815 Zeichen bestehen.</p>
819 <li><code class="directive"><a href="#directory"><Directory></a></code>
820 für eine Beschreibung, wie reguläre Ausdrücke mit
821 normalen <code class="directive"><Directory></code>-Anweisungen
822 vermischt werden.</li>
823 <li><a href="../sections.html">Wie die Abschnitte <Directory>,
824 <Location> und <Files> arbeiten</a> für eine
825 Erläuterung, wie diese verschiedenen Abschnitte miteinander
826 kombiniert werden, wenn eine Anfrage empfangen wird</li>
829 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
830 <div class="directive-section"><h2><a name="DocumentRoot" id="DocumentRoot">DocumentRoot</a>-<a name="documentroot" id="documentroot">Direktive</a></h2>
831 <table class="directive">
832 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Verzeichnis, welches den Haupt-Dokumentenbaum bildet, der im
833 Web sichtbar ist.</td></tr>
834 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>DocumentRoot <var>Verzeichnis</var></code></td></tr>
835 <tr><th><a href="directive-dict.html#Default">Voreinstellung:</a></th><td><code>DocumentRoot /usr/local/apache/htdocs</code></td></tr>
836 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Serverkonfiguration, Virtual Host</td></tr>
837 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
838 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
840 <p>Die Direktive setzt das Verzeichnis, von dem aus
841 <code class="program"><a href="../programs/httpd.html">httpd</a></code> Dateien ausliefert. Sofern nicht eine Direktive
842 wie <code class="directive"><a href="../mod/mod_alias.html#alias">Alias</a></code> greift, hängt
843 der Server Pfade aus der angeforderten URL an das Wurzelverzeichnis
844 an, um den Pfad zum Dokument zu bilden. Beispiel:</p>
846 <div class="example"><p><code>
847 DocumentRoot /usr/web
850 <p>Damit bezieht sich ein Zugriff auf
851 <code>http://www.my.host.com/index.html</code> auf
852 <code>/usr/web/index.html</code>. Wenn das <var>Verzeichnis</var> nicht
853 absolut angegeben ist, wird es relativ zu <code class="directive"><a href="#serverroot">ServerRoot</a></code> betrachtet.</p>
855 <p><code class="directive">DocumentRoot</code> sollte ohne einen
856 Schrägstrich am Ende angegeben werden.</p>
860 <li><a href="../urlmapping.html">URLs auf das Dateisystem
864 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
865 <div class="directive-section"><h2><a name="EnableMMAP" id="EnableMMAP">EnableMMAP</a>-<a name="enablemmap" id="enablemmap">Direktive</a></h2>
866 <table class="directive">
867 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Verwende Memory-Mapping, um Dateien während der
868 Auslieferung zu lesen</td></tr>
869 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>EnableMMAP On|Off</code></td></tr>
870 <tr><th><a href="directive-dict.html#Default">Voreinstellung:</a></th><td><code>EnableMMAP On</code></td></tr>
871 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Serverkonfiguration, Virtual Host, Verzeichnis, .htaccess</td></tr>
872 <tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>FileInfo</td></tr>
873 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
874 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
876 <p>Die Direktive steuert, ob <code class="program"><a href="../programs/httpd.html">httpd</a></code> Memory-Mapping
877 verwenden darf, wenn er während der Auslieferung den Inhalt einer
878 Datei lesen muss. Wenn die Bearbeitung einer Anfrage es erfordert,
879 auf die Daten in einer Datei zuzugreifen -- zum Beispiel bei der
880 Auslieferung einer mittels <code class="module"><a href="../mod/mod_include.html">mod_include</a></code> serverseitig
881 analysierten Datei --, dann verwendet der Apache standardmäßig
882 Memory-Mapping für diese Datei, sofern das Betriebssystem es
885 <p>Memory-Mapping bedeutet zuweilen eine Performanceverbesserung.
886 In einigen Umgebungen ist es jedoch besser, Memory-Mapping zu
887 deaktivieren, um Problemen während des Betriebs vorzubeugen:</p>
890 <li>Bei einigen Multiprozessorsystemen kann Memory-Mapping die
891 Performance von <code class="program"><a href="../programs/httpd.html">httpd</a></code> reduzieren.</li>
892 <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
893 einem Speicherzugriffsfehler <span class="transnote">(<em>Anm.d.Ü.:</em> ein so genannter "segmentation
894 fault")</span> abstürzen, wenn eine Datei gelöscht oder
895 gekürzt wird, während <code class="program"><a href="../programs/httpd.html">httpd</a></code> sie im Speicher
899 <p>Bei Serverkonfigurationen, die für dieses Problem
900 anfällig sind, sollten Sie das Memory-Mapping für
901 auszuliefernde Dateien deaktivieren, indem Sie schreiben:</p>
903 <div class="example"><p><code>
907 <p>Bei per NFS eingebundenen Dateien kann diese Funktion
908 explizit für die störenden Dateien deaktiviert werden,
909 indem Sie angeben:</p>
911 <div class="example"><p><code>
912 <Directory "/pfad-zu-den-nfs-dateien">
913 <span class="indent">
920 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
921 <div class="directive-section"><h2><a name="EnableSendfile" id="EnableSendfile">EnableSendfile</a>-<a name="enablesendfile" id="enablesendfile">Direktive</a></h2>
922 <table class="directive">
923 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Verwende die sendfile-Unterstützung des Kernels, um
924 Dateien an den Client auszuliefern</td></tr>
925 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>EnableSendfile On|Off</code></td></tr>
926 <tr><th><a href="directive-dict.html#Default">Voreinstellung:</a></th><td><code>EnableSendfile On</code></td></tr>
927 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Serverkonfiguration, Virtual Host, Verzeichnis, .htaccess</td></tr>
928 <tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>FileInfo</td></tr>
929 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
930 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
931 <tr><th><a href="directive-dict.html#Compatibility">Kompatibilität:</a></th><td>Verfügbar ab Apache Version 2.0.44</td></tr>
933 <p>Die Direktive steuert, ob <code class="program"><a href="../programs/httpd.html">httpd</a></code> die
934 sendfile-Unterstützung des Kernels verwenden kann, um
935 Dateiinhalte an den Client zu übermitteln. Wenn die Bearbeitung
936 einer Anfrage keinen Zugriff auf die Daten in der Datei erfordert --
937 zum Beispiel bei der Auslieferung einer statischen Datei -- und das
938 Betriebssystem es unterstützt, verwendet der Apache
939 standardmäßig sendfile, um den Dateiinhalt zu
940 übertragen, ohne die Datei jemals zu lesen.</p>
942 <p>Der sendfile-Mechanismus vermeidet getrennte Lese- und
943 Sendeoperationen sowie Puffer-Zuweisungen. Bei einigen Plattformen bzw.
944 Dateisystemen deaktivieren Sie diese Funktion jedoch besser, um Probleme
945 während des Betriebs zu vermeiden:</p>
948 <li>Einige Plattformen besitzen u.U. eine fehlerhafte
949 sendfile-Unterstützung, die das Erstellungssystem nicht erkennt,
950 insbesondere wenn die Binärdateien auf einem anderen Rechner erstellt
951 und auf eine solche Maschine mit fehlerhafter sendfile-Unterstützung
952 übertragen wurden.</li>
953 <li>Bei einem über das Netzwerk eingebundenen <code class="directive"><a href="#documentroot">DocumentRoot</a></code> (z.B. NFS oder SMB) ist der
954 Kernel möglicherweise nicht in der Lage, die Netzwerkdatei
955 über seinen eigenen Cache zu bedienen.</li>
956 <li>Unter Linux löst die Verwendung von <code>sendfile</code>
957 in Verbindung mit bestimmten Netzwerkkarten und IPv6
958 TCP-Checksummenfehler aus.</li>
961 <p>Bei Serverkonfigurationen, die für dieses Problam
962 anfällig sind, sollten die diese Funktion deaktivieren, indem
965 <div class="example"><p><code>
969 <p>Bei per NFS oder SMB eingebundenen Dateien kann diese Funktion
970 explizit für die störenden Dateien deaktiviert werden, indem
973 <div class="example"><p><code>
974 <Directory "/pfad-zu-den-nfs-dateien">
975 <span class="indent">
982 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
983 <div class="directive-section"><h2><a name="ErrorDocument" id="ErrorDocument">ErrorDocument</a>-<a name="errordocument" id="errordocument">Direktive</a></h2>
984 <table class="directive">
985 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Das, was der Server im Fehlerfall an den Client
987 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>ErrorDocument <var>Fehlercode</var> <var>Dokument</var></code></td></tr>
988 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Serverkonfiguration, Virtual Host, Verzeichnis, .htaccess</td></tr>
989 <tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>FileInfo</td></tr>
990 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
991 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
992 <tr><th><a href="directive-dict.html#Compatibility">Kompatibilität:</a></th><td>Die Syntax der Anführungszeichen bei Textnachrichten hat
993 sich im Apache 2.0 geändert</td></tr>
995 <p>Im Falle eines Problems oder Fehlers kann der Apache
996 konfiguriert werden, eine der vier Aktionen auszuführen:</p>
999 <li>Ausgabe einer einfachen, hartkodierten Fehlermeldung</li>
1001 <li>Ausgabe einer angepassten Meldung</li>
1003 <li>Umleitung zu einem lokalen <var>URL-Pfad</var> der das
1004 Problem bzw. den Fehler behandelt</li>
1006 <li>Umleitung zu einer externen <var>URL</var>, die das Problem
1007 bzw. den Fehler behandelt</li>
1010 <p>Die erste Option ist Voreinstellung, während die Optionen
1011 2 bis 4 über die Direktive <code class="directive">ErrorDocument</code>
1012 eingestellt werden, welcher der HTTP-Statuscode und eine
1013 URL oder Nachricht folgen. Abhängig vom Problem bzw. Fehler bietet
1014 der Apache manchmal zusätzliche Informationen an.</p>
1016 <p>URLs können bei lokalen Webpfaden mit einem Schrägstrich
1017 (/) beginnen (relativ zum <code class="directive"><a href="#documentroot">DocumentRoot</a></code>-Verzeichnis) oder eine vollständige URL
1018 bilden, die der Client auflösen kann. Alternativ kann eine
1019 Nachricht für die Anzeige im Browser angeboten werden. Beispiel:</p>
1021 <div class="example"><p><code>
1022 ErrorDocument 500 http://foo.example.com/cgi-bin/tester<br />
1023 ErrorDocument 404 /cgi-bin/falsche_urls.pl<br />
1024 ErrorDocument 401 /info_zur_anmeldung.html<br />
1025 ErrorDocument 403 "Der Zugriff ist nicht erlaubt."
1028 <p>Außerdem kann der spezielle Wert <code>default</code> angegeben
1029 werden, um die schlichte, hartkodierte Nachricht des Apache zu verwenden.
1030 Es wird normalerweise nicht benötigt, doch <code>default</code>
1031 stellt die einfach, im Apache hartkodierte Meldung in Konfigurationen
1032 wieder her, die ansonsten von einem existierenden <span class="transnote">(<em>Anm.d.Ü.:</em> zuvor
1033 konfigurierten)</span> <code class="directive">ErrorDocument</code> erben
1036 <div class="example"><p><code>
1037 ErrorDocument 404 /cgi-bin/bad_urls.pl<br /><br />
1038 <Directory /web/docs><br />
1039 <span class="indent">
1040 ErrorDocument 404 default<br />
1045 <p>Wenn Sie eine <code class="directive">ErrorDocument</code>-Anweisung
1046 angeben, die auf eine entfernte URL weist (d.h. irgendetwas mit der
1047 Methode <code>http</code> davor), beachten Sie bitte, dass der Apache
1048 eine Umleitung zum Client sendet, um diesem mitzuteilen, wo das
1049 Dokument zu finden ist, auch wenn das Dokument letztlich wieder zum
1050 gleichen Server führt. Das hat mehrere Auswirkungen. Die
1051 wichtigste ist, dass der Client nicht den Original-Statuscode
1052 erhält sondern statt dessen einen Umleitungs-Statuscode. Dies
1053 wiederum kann Web-Robots und andere Clients verwirren, die den
1054 Statuscode dazu verwenden, herauszufinden ob eine URL gültig ist.
1055 Wenn Sie eine entfernte URL in einer Anweisung
1056 <code>ErrorDocument 401</code> verwenden, wird der Client
1057 darüber hinaus nicht wissen, dass er den Benutzer zur Eingabe
1058 eines Passwortes auffordern muss, da er den Statuscode 401 nicht
1059 erhält. <strong>Deshalb müssen Sie sich auf ein lokales
1060 Dokument beziehen, wenn Sie eine Anweisung <code>ErrorDocument
1061 401</code> verwenden.</strong></p>
1063 <p>Der Microsoft Internet Explorer (MSIE) ignoriert
1064 standardmäßig serverseitig generierte Fehlermeldungen, wenn
1065 sie "zu kurz" sind und ersetzt sie durch eigene "freundliche"
1066 Fehlermeldungen. Die Größe variiert abhängig von der
1067 Art des Fehlers, im Allgemeinen zeigt der MSIE jedoch den
1068 serverseitig generierten Fehler, anstatt ihn zu verstecken, wenn Ihr
1069 Fehlerdokument größer als 512 Bytes ist. Weitere Informationen
1070 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>
1072 <p>Obwohl die meisten Fehlermeldungen überschrieben werden
1073 können, werden unter bestimmten Umständen die internen
1074 Meldungen ungeachtet der Einstellung der <code class="directive"><a href="#errordocument">ErrorDocument</a></code>-Direktive verwendet. Insbesondere bei
1075 einer fehlerhaften Anfrage werden der normale Bearbeitungsprozess sofort
1076 beendet und die interne Meldung zurückgegeben. Das ist notwendig, um
1077 Sicherheitsprobleme zu vermeiden, die auf Grund fehlerhafter Anfragen
1080 <p>In Versionen vor 2.0 wurden Meldungen durch ein einzelnes
1081 vorangestelltes Anführungszeichen (") erkannt.</p>
1085 <li><a href="../custom-error.html">Dokumentation zu individuellen
1086 Fehlermeldungen</a></li>
1089 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
1090 <div class="directive-section"><h2><a name="ErrorLog" id="ErrorLog">ErrorLog</a>-<a name="errorlog" id="errorlog">Direktive</a></h2>
1091 <table class="directive">
1092 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Ablageort, an dem der Server Fehler protokolliert</td></tr>
1093 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code> ErrorLog <var>Dateiname</var>|syslog[:<var>facility</var>]</code></td></tr>
1094 <tr><th><a href="directive-dict.html#Default">Voreinstellung:</a></th><td><code>ErrorLog logs/error_log (Unix) ErrorLog logs/error.log (Windows and
1095 OS/2)</code></td></tr>
1096 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Serverkonfiguration, Virtual Host</td></tr>
1097 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
1098 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
1100 <p>Die Direktive <code class="directive">ErrorLog</code> bestimmt den Namen
1101 der Datei, in welcher der Server alle auftretenden Fehler protokolliert.
1102 Wenn <var>Dateiname</var> nicht absolut ist, wird er relativ zu <code class="directive"><a href="#serverroot">ServerRoot</a></code> betrachtet.</p>
1104 <div class="example"><h3>Beispiel</h3><p><code>
1105 ErrorLog /var/log/httpd/error_log
1108 <p>Wenn der <var>Dateiname</var> mit einem senkrechten Strich (|,
1109 engl.: Pipe) beginnt, wird angenommen, dass es sich um einen Befehl
1110 handelt, der ausgeführt wird, um das Fehlerprotokolls zu
1113 <div class="example"><h3>Beispiel</h3><p><code>
1114 ErrorLog "|/usr/local/bin/httpd_errors"
1117 <p>Die Verwendung von <code>syslog</code> anstelle eines Dateinamens
1118 aktiviert die Protokollierung mittels syslogd(8), sofern das System
1119 es unterstützt. Als Voreinstellung wird der syslog-Typ (syslog
1120 facility) <code>local7</code> verwendet, Sie können dies jedoch
1121 auch überschreiben, indem Sie die Syntax
1122 <code>syslog:<var>facility</var></code> verwenden, wobei
1123 <var>facility</var> einer der Namen sein kann, die üblicherweise
1124 in syslog(1) dokumentiert sind.</p>
1126 <div class="example"><h3>Beispiel</h3><p><code>
1127 ErrorLog syslog:user
1130 <p>SICHERHEITSHINWEIS: Lesen Sie das Dokument <a href="../misc/security_tips.html#serverroot">Sicherheitshinweise</a>
1131 zu Einzelheiten darüber, warum Ihre Sicherheit gefährdet
1132 sein kann, wenn das Verzeichnis, in dem die Log-Dateien gespeichert
1133 werden, für jemand anderen, als den Benutzer, der den Server
1134 gestartet hat, beschreibbar ist.</p>
1136 <div class="warning"><h3>Anmerkung</h3>
1137 <p>Bei der Eingabe eines Dateipfads auf nicht-Unix-Plattformen sollte
1138 darauf geachtet werden, nur (Vorwärts-)Schrägstriche zu
1139 verwenden, auch wenn die Plattform rückwärts gerichtete
1140 Schrägstriche (Backslashes) erlaubt. Im Allgemeinen ist es eine gute
1141 Idee, innerhalb der Konfigurationsdateien immer
1142 Vorwärts-Schrägstriche zu verwenden.</p>
1147 <li><code class="directive"><a href="#loglevel">LogLevel</a></code></li>
1148 <li><a href="../logs.html">Apache-Log-Dateien</a></li>
1151 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
1152 <div class="directive-section"><h2><a name="FileETag" id="FileETag">FileETag</a>-<a name="fileetag" id="fileetag">Direktive</a></h2>
1153 <table class="directive">
1154 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Dateiattribute, die zur Erstellung des HTTP-Response-Headers
1155 ETag verwendet werden</td></tr>
1156 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>FileETag <var>Komponente</var> ...</code></td></tr>
1157 <tr><th><a href="directive-dict.html#Default">Voreinstellung:</a></th><td><code>FileETag INode MTime Size</code></td></tr>
1158 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Serverkonfiguration, Virtual Host, Verzeichnis, .htaccess</td></tr>
1159 <tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>FileInfo</td></tr>
1160 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
1161 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
1163 <p>Wenn dem Dokument eine Datei zugrundeliegt, bestimmt die Direktive
1164 <code class="directive">FileETag</code> die Dateiattribute, die zur Erstellung
1165 des HTTP-Response-Headers <code>ETag</code> (Entity-Tag) verwendet
1166 werden. (Der Wert von <code>ETag</code> wird bei der Cache-Verwaltung
1167 zur Einsparung von Netzwerk-Bandbreite benutzt.) Im Apache 1.3.22 und
1168 früher wurde der <code>ETag</code>-Wert <em>stets</em> aus
1169 der I-Node, der Größe und dem Datum der letzten
1170 Änderung (mtime) der Datei gebildet. Die Direktive
1171 <code class="directive">FileETag</code> erlaubt es Ihnen, zu bestimmen,
1172 welche dieser Eigenschaften -- falls überhaupt -- verwendet
1173 werden sollen. Die gültigen Schlüsselworte lauten:</p>
1176 <dt><strong>INode</strong></dt>
1177 <dd>Die I-Node-Nummer wird in die Berechnung mit einbezogen</dd>
1178 <dt><strong>MTime</strong></dt>
1179 <dd>Datum und Uhrzeit der letzten Änderung werden mit einbezogen</dd>
1180 <dt><strong>Size</strong></dt>
1181 <dd>Die Anzahl der Bytes in der Datei wird mit einbezogen</dd>
1182 <dt><strong>All</strong></dt>
1183 <dd>Alle verfügbaren Angaben werden verwendet. Die ist
1184 gleichbedeutend mit:
1185 <div class="example"><p><code>FileETag INode MTime Size</code></p></div></dd>
1186 <dt><strong>None</strong></dt>
1187 <dd>Es wird keine <code>ETag</code>-Angabe in die Antwort eingefügt,
1188 wenn dem Dokument eine Datei zugrundeliegt.</dd>
1191 <p>Den Schlüsselwörtern <code>INode</code>, <code>MTime</code>
1192 und <code>Size</code> kann entweder ein <code>+</code> oder ein
1193 <code>-</code> vorangestellt werden, was die Änderung einer
1194 Vorgabe erlaubt, die von einem größeren Umfeld
1195 geerbt wurde. Jedes Schlüselwort ohne ein solches Prefix
1196 hebt die ererbte Einstellung sofort und vollständig auf.</p>
1198 <p>Wenn die Konfiguration für ein Verzeichnis
1199 <code>FileETag INode MTime Size</code> enthält
1200 und die eines Unterverzeichnisses <code>FileETag -INode</code>,
1201 dann ist die Einstellung für das Unterverzeichnis (die an
1202 jedes Unter-Unterverzeichnis weitervererbt wird, welches dies nicht
1203 überschreibt) äquivalent mit
1204 <code>FileETag MTime Size</code>.</p>
1207 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
1208 <div class="directive-section"><h2><a name="Files" id="Files"><Files></a>-<a name="files" id="files">Direktive</a></h2>
1209 <table class="directive">
1210 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Enthält Direktiven, die sich nur auf passende Dateinamen
1212 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code><Files <var>Dateiname</var>> ... </Files></code></td></tr>
1213 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Serverkonfiguration, Virtual Host, Verzeichnis, .htaccess</td></tr>
1214 <tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>All</td></tr>
1215 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
1216 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
1218 <p>Die Direktive <code class="directive"><Files></code>
1219 begrenzt die Reichweite der enthaltenen Anweisungen auf Dateinamen.
1220 Sie ist vergleichbar mit den Direktiven <code class="directive"><a href="#directory"><Directory></a></code> und <code class="directive"><a href="#location"><Location></a></code>. Sie muss eine
1221 passende <code></Files></code>-Anweisung besitzen.
1222 Die innerhalb dieses Abschnittes angegebenen Direktiven werden auf
1223 jedes Objekt mit einem Basisnamen (letzte Komponente des Dateinamens)
1224 angewendet, der auf die angegebenen Dateinamen passt. <code class="directive"><Files></code>-Container werden, nachdem die
1225 <code class="directive"><a href="#directory"><Directory></a></code>-Container
1226 und <code>.htaccess</code>-Dateien gelesen sind, jedoch vor den
1227 <code class="directive"><a href="#location"><Location></a></code>-Containern,
1228 in der Reihenfolge ihres Auftretens ausgeführt. Beachten Sie, dass
1229 <code class="directive"><Files></code>-Anweisungen innerhalb von
1230 <code class="directive"><a href="#directory"><Directory></a></code>-Containern
1231 auftreten können, um den Teil des Dateisystems einzuschränken,
1232 den sie betreffen.</p>
1234 <p>Das Argument <var>Dateiname</var> kann einen Dateinamen oder eine
1235 Zeichenkette mit Platzhaltern enthalten, wobei <code>?</code> auf ein
1236 einzelnes Zeichen passt und <code>*</code> auf eine beliebige Folge von
1237 Zeichen. Erweiterte reguläre Ausdrücke können ebenfalls
1238 verwendet werden, indem das Zeichen <code>~</code> hinzugefügt wird.
1239 Beispielsweise würde</p>
1241 <div class="example"><p><code>
1242 <Files ~ "\.(gif|jpe?g|png)$">
1245 <p>auf die gebräuchlichsten Grafikformate im Internet passen.
1246 <code class="directive"><a href="#filesmatch"><FilesMatch></a></code> wird
1247 jedoch bevorzugt.</p>
1249 <p>Beachten Sie bitte, dass die <code class="directive"><Files></code>-Container anders als <code class="directive"><a href="#directory"><Directory></a></code>- und <code class="directive"><a href="#location"><Location></a></code>-Container innerhalb
1250 von <code>.htaccess</code>-Dateien verwendet werden können.
1251 Dies erlaubt den Anwendern auf Dateiebene die Kontrolle über ihre
1252 eigenen Dateien.</p>
1256 <li><a href="../sections.html">Wie die Abschnitte <Directory>,
1257 <Location> und <Files> arbeiten</a> für eine
1258 Erläuterung, wie diese verschiedenen Abschnitte miteinander
1259 kombiniert werden, wenn eine Anfrage empfangen wird</li>
1262 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
1263 <div class="directive-section"><h2><a name="FilesMatch" id="FilesMatch"><FilesMatch></a>-<a name="filesmatch" id="filesmatch">Direktive</a></h2>
1264 <table class="directive">
1265 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Enthält Direktiven, die für Dateinamen gelten, die
1266 auf einen regulären Ausdruck passen</td></tr>
1267 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code><FilesMatch <var>regex</var>> ... </FilesMatch></code></td></tr>
1268 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Serverkonfiguration, Virtual Host, Verzeichnis, .htaccess</td></tr>
1269 <tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>All</td></tr>
1270 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
1271 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
1273 <p>Die Direktive <code class="directive"><FilesMatch></code>
1274 begrenzt wie die Direktive <code class="directive"><a href="#files"><Files></a></code> die enthaltenen Anweisungen auf
1275 Dateinamen. Sie akzeptiert jedoch reguläre Ausdrücke.
1276 Beispielsweise würde</p>
1278 <div class="example"><p><code>
1279 <FilesMatch "\.(gif|jpe?g|png)$">
1282 <p>auf die gebräuchlichsten Grafikformate im Internet passen.</p>
1286 <li><a href="../sections.html">Wie die Abschnitte <Directory>,
1287 <Location> und <Files> arbeiten</a> für eine
1288 Erläuterung, wie diese verschiedenen Abschnitte miteinander
1289 kombiniert werden, wenn eine Anfrage empfangen wird</li>
1292 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
1293 <div class="directive-section"><h2><a name="ForceType" id="ForceType">ForceType</a>-<a name="forcetype" id="forcetype">Direktive</a></h2>
1294 <table class="directive">
1295 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Erzwingt die Auslieferung aller passendenden Dateien mit dem
1296 angegebenen MIME-Content-Type</td></tr>
1297 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>ForceType <var>MIME-Type</var>|None</code></td></tr>
1298 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Verzeichnis, .htaccess</td></tr>
1299 <tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>FileInfo</td></tr>
1300 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
1301 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
1302 <tr><th><a href="directive-dict.html#Compatibility">Kompatibilität:</a></th><td>Wurde im Apache 2.0 in den Core verschoben</td></tr>
1304 <p>Wenn sie innerhalb einer <code>.htaccess</code>-Datei, eines
1305 <code class="directive"><a href="#directory"><Directory></a></code>-,
1306 <code class="directive"><a href="#location"><Location></a></code>-
1307 <code class="directive"><a href="#files"><Files></a></code>-Containers
1308 angegeben wird, erzwingt die Direktive die Auslieferung aller
1309 entsprechenden Dateien mit dem Content-Type, der durch
1310 <var>MIME-Type</var> definiert wurde. Wenn Sie zum Beispiel ein
1311 Verzeichnis voller GIF-Dateien haben, die Sie nicht alle durch
1312 <code>.gif</code> kennzeichnen wollen, können Sie angeben:</p>
1314 <div class="example"><p><code>
1318 <p>Beachten Sie bitte, dass die Direktive anders als <code class="directive"><a href="#defaulttype">DefaultType</a></code> alle MIME-Type-Zuordnungen
1319 überschreibt, einschließlich Dateiendungen, die einen
1320 Medientyp bezeichnen könnten.</p>
1322 <p>Sie können jede <code class="directive">ForceType</code>-Angabe
1323 durch die Verwendung des Wertes <code>None</code> überschreiben:</p>
1325 <div class="example"><p><code>
1326 # erzwinge image/gif für alle Dateien:<br />
1327 <Location /images><br />
1328 <span class="indent">
1329 ForceType image/gif<br />
1331 </Location><br />
1333 # hier jedoch normale MIME-Type-Zuordnungen:<br />
1334 <Location /images/mixed><br />
1335 <span class="indent">
1336 ForceType None<br />
1342 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
1343 <div class="directive-section"><h2><a name="HostnameLookups" id="HostnameLookups">HostnameLookups</a>-<a name="hostnamelookups" id="hostnamelookups">Direktive</a></h2>
1344 <table class="directive">
1345 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Aktiviert DNS-Lookups auf Client-IP-Adressen</td></tr>
1346 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>HostnameLookups On|Off|Double</code></td></tr>
1347 <tr><th><a href="directive-dict.html#Default">Voreinstellung:</a></th><td><code>HostnameLookups Off</code></td></tr>
1348 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Serverkonfiguration, Virtual Host, Verzeichnis</td></tr>
1349 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
1350 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
1352 <p>Diese Direktive aktiviert die DNS-Abfrage <span class="transnote">(<em>Anm.d.Ü.:</em> ein sogenannter
1353 DNS-Lookup)</span>, so dass Hostnamen protokolliert (und in
1354 <code>REMOTE_HOST</code> an CGIs/SSIs übergeben) werden könnnen.
1355 Der Wert <code>Double</code> bezieht sich auf ein
1356 Double-Reverse-DNS-Lookup. D.h. nachdem ein Reverse-Lookup
1357 durchgeführt wurde, wird dann auf dem Ergebnis ein
1358 Forward-Lookup ausgeführt. Wenigstens eine der IP-Adressen
1359 aus dem Forward-Lookup muss der Originaladresse entsprechen.
1360 (In der "tcpwrappers"-Terminologie wird dies <code>PARANOID</code>
1363 <p>Unabhängig von der Einstellung wird ein Double-Reverse-Lookup
1364 durchgeführt, wenn <code class="module"><a href="../mod/mod_authz_host.html">mod_authz_host</a></code> zur
1365 Zugriffskontrolle per Hostnamen eingesetzt wird. Dies ist aus
1366 Sicherheitsgründen notwendig. Beachten Sie, dass das Ergebnis dieses
1367 Double-Reverse-Lookups nicht generell verfügbar ist, solange Sie
1368 nicht <code>HostnameLookups Double</code> setzen. Wenn beispielsweise
1369 nur <code>HostnameLookups On</code> angegeben ist und eine Anfrage
1370 für ein Objekt erfolgt, welches durch Hostnamen-Beschränkungen
1371 geschützt ist, dann wird CGIs nur das Ergebnis des
1372 Singel-Reverse-Lookups in <code>REMOTE_HOST</code> übergeben,
1373 egal ob das Doble-Reverse-Lookup fehlschlug oder nicht.</p>
1375 <p>Die Voreinstellung ist <code>Off</code>, um Netzwerktraffic bei den
1376 Angeboten einzusparen, die nicht tatsächlich Reverse-Lookups
1377 benötigen. Es ist auch für die Endanwender besser, da sie nicht
1378 die zusätzliche Wartezeit ertragen müssen, die ein Lookup mit
1379 sich bringt. Hoch frequentierte Angebote sollten diese Direktive auf
1380 <code>Off</code>lassen. Das Hilfsprogramm <code class="program"><a href="../programs/logresolve.html">logresolve</a></code>, das standardmäßig in das
1381 Unterverzeichnis <code>bin</code> Ihres Installationsverzeichnisses
1382 kompiliert wird, kann dazu verwendet werden, um offline Hostnamen von
1383 protokollierten IP-Adressen nachzuschlagen.</p>
1386 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
1387 <div class="directive-section"><h2><a name="IfDefine" id="IfDefine"><IfDefine></a>-<a name="ifdefine" id="ifdefine">Direktive</a></h2>
1388 <table class="directive">
1389 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Schließt Direktiven ein, die nur ausgeführt werden,
1390 wenn eine Testbedingung beim Start wahr ist</td></tr>
1391 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code><IfDefine [!]<var>Parametername</var>> ...
1392 </IfDefine></code></td></tr>
1393 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Serverkonfiguration, Virtual Host, Verzeichnis, .htaccess</td></tr>
1394 <tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>All</td></tr>
1395 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
1396 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
1398 <p>Der Container <code><IfDefine <var>Test</var>>...</IfDefine>
1399 </code> wird dazu verwendet, Direktiven als bedingt zu kennzeichnen.
1400 Die Direktiven innerhalb eines <code class="directive"><IfDefine></code>-Abschnittes werden nur ausgeführt,
1401 wenn <var>Test</var> wahr ist. Ist <var>Test</var> falsch, wird alles
1402 zwischen der Start- und Endemarkierung ignoriert.</p>
1404 <p>In der <code class="directive"><IfDefine></code>-Anweisung kann
1405 <var>Test</var> eine von zwei Formen annehmen:</p>
1408 <li><var>Parametername</var></li>
1410 <li><code>!</code><var>Parametername</var></li>
1413 <p>Im ersten Fall werden die Direktiven zwischen der Start- und
1414 Endemarkierung nur ausgeführt, wenn der Parameter namens
1415 <var>Parametername</var> definiert ist. Die zweite Form kehrt den
1416 Test um und führt die Direktiven nur dann aus, wenn
1417 <var>Parametername</var> <strong>nicht</strong> definiert ist.</p>
1419 <p>Das Argument <var>Parametername</var> ist ein sogenanntes
1420 "Define", das beim beim Start des Servers in der
1421 <code class="program"><a href="../programs/httpd.html">httpd</a></code>-Befehlszeile durch
1422 <code>-D<var>Parameter</var></code> angegeben wird.</p>
1424 <p><code class="directive"><IfDefine></code>-Container können
1425 ineinander verschachtelt werden, um einfache Multi-Parameter-Tests
1426 zu implementieren. Beispiel:</p>
1428 <div class="example"><p><code>
1429 httpd -DReverseProxy ...<br />
1432 <IfDefine ReverseProxy><br />
1433 <span class="indent">
1434 LoadModule rewrite_module modules/mod_rewrite.so<br />
1435 LoadModule proxy_module modules/libproxy.so<br />
1441 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
1442 <div class="directive-section"><h2><a name="IfModule" id="IfModule"><IfModule></a>-<a name="ifmodule" id="ifmodule">Direktive</a></h2>
1443 <table class="directive">
1444 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Schließt Direktiven ein, die abhängig vom
1445 Vorhandensein oder Fehlen eines speziellen Moduls ausgeführt
1447 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code><IfModule [!]<var>Modulname</var>|<var>Modulbezeichner</var>>
1448 ... </IfModule></code></td></tr>
1449 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Serverkonfiguration, Virtual Host, Verzeichnis, .htaccess</td></tr>
1450 <tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>All</td></tr>
1451 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
1452 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
1453 <tr><th><a href="directive-dict.html#Compatibility">Kompatibilität:</a></th><td>Modulbezeichner sind ab Version 2.1
1454 verfügbar.</td></tr>
1456 <p>Der Container <code><IfModule
1457 <var>Test</var>>...</IfModule></code> wird dazu verwendet,
1458 Direktiven als abhängig von dem Vorhandensein eines speziellen
1459 Moduls zu kennzeichnen. Die Direktiven innerhalb eines <code class="directive"><IfModule></code>-Abschnitts werden nur
1460 ausgeführt, wenn <var>Test</var> wahr ist. Ist <var>Test</var>
1461 falsch, wird alles zwischen der Start- und Endemarkierung ignoriert.</p>
1463 <p>In der <code class="directive"><IfModule></code>-Anweisung
1464 kann <var>Test</var> eine von zwei Formen annehmen:</p>
1467 <li><var>Modul</var></li>
1469 <li><code>!</code><var>Modul</var></li>
1472 <p>Im ersten Fall werden die Direktiven zwischen der Start- und
1473 Endemarkierung nur ausgeführt, das Modul namens
1474 <var>Modul</var> im Apache enthalten ist -- entweder einkompiliert
1475 oder mittels <code class="directive"><a href="../mod/mod_so.html#loadmodule">LoadModule</a></code>
1476 dynamisch geladen. Die zweite Form dreht den Test um und führt die
1477 Direktiven nur aus, wenn <var>Modul</var> <strong>nicht</strong>
1480 <p>Das Argument <var>Modul</var> kann entweder der Modulbezeichner oder
1481 der Dateiname des Moduls zum Zeitpunkt seiner Kompilierung sein.
1482 <code>rewrite_module</code> beispielsweise ist der Bezeichner und
1483 <code>mod_rewrite.c</code> ist der Dateiname. Wenn ein Modul aus mehreren
1484 Quelltext-Dateien besteht, verwenden Sie den Namen der Datei, welche die
1485 Zeichenfolge <code>STANDARD20_MODULE_STUFF</code> enthält.</p>
1487 <p><code class="directive"><IfModule></code>-Container können
1488 inneinander verschachtelt werden, um einfache Multi-Modul-Tests
1491 <p>Dieser Container sollte verwendet werden, wenn Sie eine
1492 Konfigurationsdatei benötigen, die unabhängig davon funktioniert,
1493 ob ein bestimmtes Modul verfügbar ist oder nicht. Normalerweise
1494 ist es nicht notwendig, Direktiven in <code class="directive"><IfModule></code>-Containern unterzubringen.</p>
1497 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
1498 <div class="directive-section"><h2><a name="Include" id="Include">Include</a>-<a name="include" id="include">Direktive</a></h2>
1499 <table class="directive">
1500 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Fügt andere Konfigurationsdateien innerhalb der
1501 Server-Konfigurationsdatei ein</td></tr>
1502 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>Include <var>Dateiname</var>|<var>Verzeichnis</var></code></td></tr>
1503 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Serverkonfiguration, Virtual Host, Verzeichnis</td></tr>
1504 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
1505 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
1506 <tr><th><a href="directive-dict.html#Compatibility">Kompatibilität:</a></th><td>Die Platzhalter-Suche ist verfügbar seit
1509 <p>Die Direktive erlaubt das Einfügen anderer Konfigurationsdateien
1510 in die Konfigurationsdatei des Servers.</p>
1512 <p>Shell-typische (<code>fnmatch()</code>) Platzhlaterzeichen können
1513 dazu verwendet werden, mehrere Dateien auf einmal in alphabetischer
1514 Reihenfolge einzufügen. Wenn <code class="directive">Include</code>
1515 darüber hinaus auf ein Verzeichnis anstatt auf eine Datei zeigt,
1516 liest der Apache alle Dateien in diesem Verzeichnis und allen
1517 Unterverzeichnissen ein. Das Einfügen ganzer Verzeichnisse ist
1518 jedoch nicht empfehlenswert, da temporäre Dateien sehr leicht
1519 versehentlich in einem Verzeichnis zurückgelassen werden, was
1520 <code class="program"><a href="../programs/httpd.html">httpd</a></code> scheitern lassen kann.</p>
1522 <p>Der angegebene Dateiname kann ein absoluter Pfad sein oder relativ zum
1523 <code class="directive"><a href="#serverroot">ServerRoot</a></code>-Verzeichnis angegeben
1528 <div class="example"><p><code>
1529 Include /usr/local/apache2/conf/ssl.conf<br />
1530 Include /usr/local/apache2/conf/vhosts/*.conf
1533 <p>Oder Sie geben Pfade relativ zu Ihrem <code class="directive"><a href="#serverroot">ServerRoot</a></code>-Verzeichnis an:</p>
1535 <div class="example"><p><code>
1536 Include conf/ssl.conf<br />
1537 Include conf/vhosts/*.conf
1540 <p>Der Aufruf von <code>apachectl configtest</code> liefert eine Liste
1541 der Dateien, die während des Konfigurations-Tests verarbeitet
1544 <div class="example"><p><code>
1545 root@host# apachectl configtest<br />
1546 Processing config file: /usr/local/apache2/conf/ssl.conf<br />
1547 Processing config file: /usr/local/apache2/conf/vhosts/vhost1.conf<br />
1548 Processing config file: /usr/local/apache2/conf/vhosts/vhost2.conf<br />
1554 <li><code class="program"><a href="../programs/apachectl.html">apachectl</a></code></li>
1557 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
1558 <div class="directive-section"><h2><a name="KeepAlive" id="KeepAlive">KeepAlive</a>-<a name="keepalive" id="keepalive">Direktive</a></h2>
1559 <table class="directive">
1560 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Aktiviert persistente HTTP-Verbindungen</td></tr>
1561 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>KeepAlive On|Off</code></td></tr>
1562 <tr><th><a href="directive-dict.html#Default">Voreinstellung:</a></th><td><code>KeepAlive On</code></td></tr>
1563 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Serverkonfiguration, Virtual Host</td></tr>
1564 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
1565 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
1567 <p>Die Keep-Alive-Erweiterung von HTTP/1.0 und die
1568 HTTP/1.1-Funktionalität persistenter Verbindungen unterstützt
1569 langlebige HTTP-Sitzungen, die es erlauben, mehrere Anfragen über
1570 die gleich TCP-Verbindung zu senden. In einigen Fällen wurde eine
1571 Beschleunigung der Wartezeiten von beinahe 50% für HTML-Dokumente
1572 mit vielen Bildern festgestellt. Um Keep-Alive-Verbindungen zu aktivieren,
1573 setzen Sie <code>KeepAlive On</code>.</p>
1575 <p>Bei HTTP/1.0-Clients werden Keep-Alive-Verbindungen nur dann verwendet,
1576 wenn sie vom Client eigens angefordert werden. Desweiteren können
1577 Keep-Alive-Verbindungen bei einem HTTP/1.0-Client nur dann verwendet
1578 werden, wenn die Länge des Inhalts im Voraus bekannt ist. Dies
1579 impliziert, dass dynamische Inhalte wie CGI-Ausgaben, SSI-Seiten und
1580 servergenerierte Verzeichnisauflistungen im Allgemeinen keine
1581 Keep-Alive-Verbindungen mit HTTP/1.0-Clients verwenden. Bei
1582 HTTP/1.1-Clients sind Keep-Alive-Verbindungen Voreinstellung, solange
1583 nichts anderes angegeben ist. Wenn der Client es anfordert, wird
1584 Chunked-Encoding verwendet, um Inhalte mit unbekannter Länge
1585 über persistente Verbindungen zu senden.</p>
1589 <li><code class="directive"><a href="#maxkeepaliverequests">MaxKeepAliveRequests</a></code></li>
1592 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
1593 <div class="directive-section"><h2><a name="KeepAliveTimeout" id="KeepAliveTimeout">KeepAliveTimeout</a>-<a name="keepalivetimeout" id="keepalivetimeout">Direktive</a></h2>
1594 <table class="directive">
1595 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Zeitspanne, die der Server während persistenter Verbindungen
1596 auf nachfolgende Anfragen wartet</td></tr>
1597 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>KeepAliveTimeout <var>Sekunden</var></code></td></tr>
1598 <tr><th><a href="directive-dict.html#Default">Voreinstellung:</a></th><td><code>KeepAliveTimeout 5</code></td></tr>
1599 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Serverkonfiguration, Virtual Host</td></tr>
1600 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
1601 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
1603 <p>Dies legt die Anzahl der Sekunden fest, die der Apache auf weitere
1604 Anfragen wartet, bevor er die Verbindung schließt. Nachdem einmal
1605 eine Anfrage entgegen genommen wurde, wird die durch die Direktive
1606 <code class="directive"><a href="#timeout">Timeout</a></code> festgelegte Auszeit
1609 <p>Auf stark belasteten Servern kann ein hoher
1610 <code class="directive">KeepAliveTimeout</code>-Wert zu Durchsatzminderungen
1611 führen. Je höher die Auszeit angegeben ist, desto länger
1612 ist der Apache damit beschäftigt, auf untätige Clients zu
1616 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
1617 <div class="directive-section"><h2><a name="Limit" id="Limit"><Limit></a>-<a name="limit" id="limit">Direktive</a></h2>
1618 <table class="directive">
1619 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Beschränkt die eingeschlossenen Zugriffskontrollen auf
1620 bestimmte HTTP-Methoden</td></tr>
1621 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code><Limit <var>Methode</var> [<var>Methode</var>] ... > ...
1622 </Limit></code></td></tr>
1623 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Serverkonfiguration, Virtual Host, Verzeichnis, .htaccess</td></tr>
1624 <tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>All</td></tr>
1625 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
1626 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
1628 <p>Zugriffskontrollen gelten normalerweise für <strong>alle</strong>
1629 Zugriffsmethoden, was normalerweise auch das gewünschte Verhalten ist.
1630 <strong>Im Allgemeinen sollten Zugriffskontrollen nicht in einen
1631 <code class="directive"><Limit></code>-Container gepackt
1632 werden.</strong></p>
1634 <p>Der Sinn der Direktive <code class="directive"><Limit></code>
1635 ist es, den Effekt der Zugriffskontrollen auf die angegebenen
1636 HTTP-Methoden zu beschränken. Bei allen anderen Methoden haben
1637 die in der <code class="directive"><Limit></code>-Gruppe
1638 enthaltenen Zugriffsbeschränkungen <strong>keine Wirkung</strong>.
1639 Im folgenden Beispiel gilt die Zugriffskontrolle nur für die
1640 Methoden <code>POST</code>, <code>PUT</code> und <code>DELETE</code>.
1641 Alle anderen Methoden bleiben ungeschützt:</p>
1643 <div class="example"><p><code>
1644 <Limit POST PUT DELETE><br />
1645 <span class="indent">
1646 Require valid-user<br />
1651 <p>Sie können eine oder mehrere der folgenden Methoden angeben:
1652 <code>GET</code>, <code>POST</code>, <code>PUT</code>, <code>DELETE</code>,
1653 <code>CONNECT</code>, <code>OPTIONS</code>,
1654 <code>PATCH</code>, <code>PROPFIND</code>, <code>PROPPATCH</code>,
1655 <code>MKCOL</code>, <code>COPY</code>, <code>MOVE</code>,
1656 <code>LOCK</code> und <code>UNLOCK</code>. <strong>Die Methodennamen
1657 unterscheiden zwischen Groß- und Kleinschreibung.</strong> Wenn
1658 <code>GET</code> verwendet wird, sind <code>HEAD</code>-Anfragen
1659 ebenfalls eingeschränkt. Die <code>TRACE</code>-Methode kann nicht
1660 limitiert werden.</p>
1662 <div class="warning">
1663 Wenn es um Zugriffsbeschränkungen geht, sollte
1664 ein <code class="directive"><a href="#limitexcept"><LimitExcept></a></code>-Container sollte immmer einem <code class="directive"><a href="#limit"><Limit></a></code>-Container vorgezogen
1665 werden, da <code class="directive"><a href="#limitexcept"><LimitExcept></a></code>
1666 einen Schutz gegen beliebige Methoden bietet.
1670 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
1671 <div class="directive-section"><h2><a name="LimitExcept" id="LimitExcept"><LimitExcept></a>-<a name="limitexcept" id="limitexcept">Direktive</a></h2>
1672 <table class="directive">
1673 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Beschränkt Zugriffskontrollen auf alle HTTP-Methoden
1674 außer den genannten</td></tr>
1675 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code><LimitExcept <var>Methode</var> [<var>Methode</var>] ... > ...
1676 </LimitExcept></code></td></tr>
1677 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Serverkonfiguration, Virtual Host, Verzeichnis, .htaccess</td></tr>
1678 <tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>All</td></tr>
1679 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
1680 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
1682 <p><code class="directive"><LimitExcept></code> und
1683 <code></LimitExcept></code> werden dazu verwendet, eine Gruppe
1684 von Anweisungen zur Zugriffskontrolle zusammenzufassen, die dann auf
1685 jede HTTP-Methode angewendet werden, die <strong>nicht</strong>
1686 als Argument angegeben ist. D.h. dies ist das Gegenteil des
1687 <code class="directive"><a href="#limit"><Limit></a></code>-Containers
1688 und kann zur Steuerung von Standard- und nicht-Standard-/unbekannten
1689 Methoden verwendet werden. Für weitere Einzelheiten lesen Sie bitte
1690 die Beschreibung zu <code class="directive"><a href="#limit"><Limit></a></code>.</p>
1694 <div class="example"><p><code>
1695 <LimitExcept POST GET><br />
1696 <span class="indent">
1697 Require valid-user<br />
1699 </LimitExcept>
1704 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
1705 <div class="directive-section"><h2><a name="LimitInternalRecursion" id="LimitInternalRecursion">LimitInternalRecursion</a>-<a name="limitinternalrecursion" id="limitinternalrecursion">Direktive</a></h2>
1706 <table class="directive">
1707 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Bestimmt die maximale Anzahl interner Umleitungen und
1708 verschachtelter Unteranfragen</td></tr>
1709 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>LimitInternalRecursion <var>Zahl</var> [<var>Zahl</var>]</code></td></tr>
1710 <tr><th><a href="directive-dict.html#Default">Voreinstellung:</a></th><td><code>LimitInternalRecursion 10</code></td></tr>
1711 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Serverkonfiguration, Virtual Host</td></tr>
1712 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
1713 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
1714 <tr><th><a href="directive-dict.html#Compatibility">Kompatibilität:</a></th><td>Verfügbar ab Apache 2.0.47</td></tr>
1716 <p>Eine interne Umleitung erfolgt beispielsweise, wenn die Direktive
1717 <code class="directive"><a href="../mod/mod_actions.html#action">Action</a></code> verwendet wird, welche
1718 die Originalanfrage intern zu einem CGI-Skript weiterleitet. Eine
1719 Unteranfrage <span class="transnote">(<em>Anm.d.Ü.:</em> engl. Subrequest)</span> ist ein Mechanismus des
1720 Apache, um herauszufinden, was bei einer URI geschehen würde, wäre
1721 sie angefordert worden. <code class="module"><a href="../mod/mod_dir.html">mod_dir</a></code> z.B. verwendet
1722 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
1725 <p><code class="directive">LimitInternalRecursion</code> bewahrt den Server vor
1726 einem Absturz, wenn er in eine Endlosschleife aus internen Umleitungen
1727 oder Unteranfragen hineinläuft. Derartige Schleifen werden
1728 gewöhnlich durch Fehlkonfiguration verursacht.</p>
1730 <p>Die Direktive setzt zwei verschiedene Begrenzungen, welche je Anfrage
1731 ausgewertet werden. Die erste <var>Zahl</var> bestimmt die maximale
1732 Anzahl der Umleitungen, die aufeinander folgen dürfen. Die zweite
1733 <var>Zahl</var> legt fest, wie tief Unteranfragen ineinander
1734 verschachtelt werden dürfen. Wenn Sie lediglich eine <var>Zahl</var>
1735 angeben, wird sie beiden Begrenzungen zugewiesen.</p>
1737 <div class="example"><h3>Beispiel</h3><p><code>
1738 LimitInternalRecursion 5
1742 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
1743 <div class="directive-section"><h2><a name="LimitRequestBody" id="LimitRequestBody">LimitRequestBody</a>-<a name="limitrequestbody" id="limitrequestbody">Direktive</a></h2>
1744 <table class="directive">
1745 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Begrenzt die Gesamtgröße des vom Client gesendeten
1746 HTTP-Request-Body</td></tr>
1747 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>LimitRequestBody <var>Bytes</var></code></td></tr>
1748 <tr><th><a href="directive-dict.html#Default">Voreinstellung:</a></th><td><code>LimitRequestBody 0</code></td></tr>
1749 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Serverkonfiguration, Virtual Host, Verzeichnis, .htaccess</td></tr>
1750 <tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>All</td></tr>
1751 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
1752 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
1754 <p>Die Direktive gibt die Anzahl der <var>Bytes</var> zwischen 0
1755 (unbegrenzt) und 2147483647 (2GB) an, die im Request-Body (Datenteil der
1756 Anfrage) erlaubt sind.</p>
1758 <p>Die Direktive <code class="directive">LimitRequestBody</code> erlaubt es dem
1759 Benutzer, die Größe des HTTP-Request-Bodys in dem Kontext zu
1760 begrenzen, in dem die Anweisung angegeben ist (Server, pro Verzeichnis,
1761 pro Datei oder pro Adresse). Wenn die Anfrage des Clients dieses Limit
1762 überschreitet, gibt der Server einen Fehler zurück anstatt die
1763 Anfrage zu bearbeiten. Die Größe des Datenteils einer Anfrage
1764 kann sehr stark variieren, abhängig von der Art der Ressource und
1765 den für diese Ressource erlaubten Methoden. CGI-Skripte verwenden
1766 den Datenteil üblicherweise zum Empfang von Formulardaten. Wird
1767 die <code>PUT</code>-Methode angewendet, dann muss der Wert mindestens
1768 so groß sein wie irgendeine Darstellungsform, die der Server
1769 für diese Ressource akzeptieren soll.</p>
1771 <p>Die Direktive gibt dem Serveradministrator eine größere
1772 Kontrolle gegenüber abnormalem Verhalten von Clients, was bei der
1773 Vermeidung einiger Formen von Denial-of-Service-Attacken hilfreich
1776 <p>Wenn Sie beispielsweise das Hochladen von Dateien zu einer bestimmten
1777 Adresse erlauben, aber die Größe der hochgeladenen Dateien
1778 auf 100K beschränken wollen, können Sie die folgende Anweisung
1781 <div class="example"><p><code>
1782 LimitRequestBody 102400
1787 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
1788 <div class="directive-section"><h2><a name="LimitRequestFields" id="LimitRequestFields">LimitRequestFields</a>-<a name="limitrequestfields" id="limitrequestfields">Direktive</a></h2>
1789 <table class="directive">
1790 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Begrenzt die Anzahl der HTTP-Request-Header, die vom Client
1791 entgegengenommen werden</td></tr>
1792 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>LimitRequestFields <var>Anzahl</var></code></td></tr>
1793 <tr><th><a href="directive-dict.html#Default">Voreinstellung:</a></th><td><code>LimitRequestFields 100</code></td></tr>
1794 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Serverkonfiguration</td></tr>
1795 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
1796 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
1798 <p><var>Anzahl</var> ist ein Integer-Wert (eine positive Ganzzahl)
1799 zwischen 0 (unbegrenzt) und 32767. Die Voreinstellung wird durch die
1800 Konstante <code>DEFAULT_LIMIT_REQUEST_FIELDS</code> (<code>100</code>
1801 bei der Auslieferung) zur Kompilierungszeit gesetzt.</p>
1803 <p>Die Direktive <code class="directive">LimitRequestFields</code> erlaubt es
1804 dem Serveradministrator, die maximale Anzahl der in einem HTTP-Request
1805 erlaubten HTTP-Request-Header zu verändern. Für den Server
1806 muss dieser Wert größer sein als die Anzahl der Headerzeilen,
1807 die ein normaler Client senden könnte. Die Anzahl der Request-Header,
1808 die ein gewöhnlicher Client verwendet, überschreitet selten 20
1809 Zeilen. Allerdings kann dies zwischen den verschiedenen
1810 Client-Ausführungen variieren, oft abhängig vom Ausmaß,
1811 mit dem der Anwender die genaue Content-Negotiation-Unterstützung
1812 seines Browsers konfiguriert hat. Optionale HTTP-Erweiterungen
1813 äußern sich oft in Form von HTTP-Headern.</p>
1815 <p>Die Direktive gibt dem Serveradministrator eine größere
1816 Kontrolle gegenüber abnormalem Verhalten von Clients, was bei der
1817 Vermeidung einiger Formen von Denial-of-Service-Attacken hilfreich
1818 sein kann. Der Wert sollte erhöht werden, wenn normale Clients
1819 eine Fehlermeldung vom Server erhalten, die besagt, dass mit der Anfrage
1820 zu viele Headerzeilen gesendet wurden.</p>
1824 <div class="example"><p><code>
1825 LimitRequestFields 50
1830 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
1831 <div class="directive-section"><h2><a name="LimitRequestFieldSize" id="LimitRequestFieldSize">LimitRequestFieldSize</a>-<a name="limitrequestfieldsize" id="limitrequestfieldsize">Direktive</a></h2>
1832 <table class="directive">
1833 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Begrenzt die Länge des vom Client gesendeten
1834 HTTP-Request-Headers</td></tr>
1835 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>LimitRequestFieldsize <var>Bytes</var></code></td></tr>
1836 <tr><th><a href="directive-dict.html#Default">Voreinstellung:</a></th><td><code>LimitRequestFieldsize 8190</code></td></tr>
1837 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Serverkonfiguration</td></tr>
1838 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
1839 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
1841 <p>Die Direktive gibt die Anzahl der <var>Bytes</var> an, die in einem
1842 HTTP-Header erlaubt sind.</p>
1844 <p>Die Direktive <code class="directive">LimitRequestFieldsize</code> erlaubt es
1845 dem Serveradministrator, die maximale Größe eines
1846 HTTP-Request-Headers zu verringern oder erhöhen. Für den Server
1847 muss der Wert groß genug sein, um eine beliebige Headerzeile einer
1848 normalen Client-Anfrage vorzuhalten. Die Größe variiert stark
1849 zwischen den verschiedenen Client-Ausführungen, oft abhängig vom
1850 Ausmaß, mit dem der Anwender die genaue
1851 Content-Negotiation-Unterstützung seines Browsers konfiguriert hat.
1852 SPNEGO-Authentisierungs-Header können bis zu 12392 Bytes lang
1855 <p>Die Direktive gibt dem Serveradministrator eine größere
1856 Kontrolle gegenüber abnormalem Verhalten von Clients, was bei der
1857 Vermeidung einiger Formen von Denial-of-Service-Attacken hilfreich
1862 <div class="example"><p><code>
1863 LimitRequestFieldSize 4094
1866 <div class="note">Unter normalen Umständen sollte die Voreinstellung nicht
1867 verändert werden.</div>
1870 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
1871 <div class="directive-section"><h2><a name="LimitRequestLine" id="LimitRequestLine">LimitRequestLine</a>-<a name="limitrequestline" id="limitrequestline">Direktive</a></h2>
1872 <table class="directive">
1873 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Begrenzt die Länge der vom Client entgegengenommenen
1874 HTTP-Anfragezeile</td></tr>
1875 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>LimitRequestLine <var>Bytes</var></code></td></tr>
1876 <tr><th><a href="directive-dict.html#Default">Voreinstellung:</a></th><td><code>LimitRequestLine 8190</code></td></tr>
1877 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Serverkonfiguration</td></tr>
1878 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
1879 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
1881 <p>Die Direktive legt die Anzahl der <var>Bytes</var> fest, die in der
1882 HTTP-Anfragezeile erlaubt sind.</p>
1884 <p>Die Direktive <code class="directive">LimitRequestLine</code> erlaubt es dem
1885 Serveradministrator, die maximale Größe der
1886 HTTP-Anfragezeile zu verringern oder erhöhen. Da
1887 die Anfragezeile aus der HTTP-Methode, der URI und der Protokollversion
1888 besteht, bedeutet die <code class="directive">LimitRequestLine</code>-Direktive
1889 eine Beschränkung der Länge der für eine Anfrage an den
1890 Server erlaubten Anfrage-URI. Für den Server muss der Wert groß
1891 genug sein, um jeden seiner Ressourcennamen vorzuhalten,
1892 einschließlich aller Informationen, die im Query-String einer
1893 <code>GET</code>-Anfrage übergeben werden können.</p>
1895 <p>Die Direktive gibt dem Serveradministrator eine größere
1896 Kontrolle gegenüber abnormalem Verhalten von Clients, was bei der
1897 Vermeidung einiger Formen von Denial-of-Service-Attacken hilfreich
1902 <div class="example"><p><code>
1903 LimitRequestLine 4094
1906 <div class="note">Unter normalen Umständen sollte die Voreinstellung nicht
1907 verändert werden.</div>
1910 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
1911 <div class="directive-section"><h2><a name="LimitXMLRequestBody" id="LimitXMLRequestBody">LimitXMLRequestBody</a>-<a name="limitxmlrequestbody" id="limitxmlrequestbody">Direktive</a></h2>
1912 <table class="directive">
1913 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Begrenzt die Größe eines XML-basierten
1914 Request-Bodys</td></tr>
1915 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>LimitXMLRequestBody <var>Bytes</var></code></td></tr>
1916 <tr><th><a href="directive-dict.html#Default">Voreinstellung:</a></th><td><code>LimitXMLRequestBody 1000000</code></td></tr>
1917 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Serverkonfiguration, Virtual Host, Verzeichnis, .htaccess</td></tr>
1918 <tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>All</td></tr>
1919 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
1920 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
1922 <p>Dies gibt die Grenze für die maximale Größe (in Bytes)
1923 des XML-basierten Request-Bodys an. Der Wert <code>0</code> deaktiviert
1928 <div class="example"><p><code>
1929 LimitXMLRequestBody 0
1934 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
1935 <div class="directive-section"><h2><a name="Location" id="Location"><Location></a>-<a name="location" id="location">Direktive</a></h2>
1936 <table class="directive">
1937 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Wendet die enthaltenen Direktiven nur auf die entsprechenden
1939 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code><Location
1940 <var>URL-Pfad</var>|<var>URL</var>> ... </Location></code></td></tr>
1941 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Serverkonfiguration, Virtual Host</td></tr>
1942 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
1943 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
1945 <p>Die Direktive <code class="directive"><Location></code>
1946 begrenzt die Reichweite der enthaltenen Anweisungen auf URLs.
1947 Sie ist der Direktive <code class="directive"><a href="#directory"><Directory></a></code> ähnlich und startet einen
1948 Abschnitt, der mit der Anweisung <code></Location></code>
1949 abgeschlossen wird. <code class="directive"><Location></code>-Container werden, nachdem die
1950 <code class="directive"><a href="#directory"><Directory></a></code>-Container
1951 und <code>.htaccess</code>-Dateien gelesen wurden, und nach den
1952 <code class="directive"><a href="#files"><Files></a></code>-Containern, in
1953 der Reihenfolge ausgeführt, in der sie in der Konfigurationsdatei
1956 <p><code class="directive"><Location></code>-Abschnitte operieren
1957 vollständig außerhalb des Dateisystems. Dies hat mehrere
1958 Konsequenzen. An Wichtigsten, <code class="directive"><Location></code>-Anweisungen sollten nicht dafür
1959 verwendet werden, den Zugriff zu Teilen des Dateisystems zu steuern. Da
1960 mehrere unterschiedliche URLs auf die gleiche Stelle des Dateisystems
1961 zeigen können, könnte eine solche Zugriffskontrolle u.U.
1962 umgangen werden.</p>
1964 <div class="note"><h3>Wann sollte<code class="directive"><Location></code> verwendet werden</h3>
1966 <p>Verwenden Sie <code class="directive"><Location></code>, um
1967 Anweisungen auf Inhalte anzuwenden, die außerhalb des Dateisystems
1968 abgelegt sind. Benutzen Sie <code class="directive"><a href="#directory"><Directory></a></code> und <code class="directive"><a href="#files"><Files></a></code> für Inhalte, die
1969 innerhalb des Dateisystems abgelegt sind. Eine Ausnahme bildet
1970 <code><Location /></code>, welches ein einfacher Weg ist, um eine
1971 Konfiguration auf den gesamten Server anzuwenden.</p>
1974 <p>Für alle nicht-Proxy-Anfragen ist die entsprechende URL
1975 ein URL-Pfad in der Form <code>/path/</code>. Es dürfen weder ein
1976 Schema, noch ein Hostname, noch ein Port, noch ein Query-String einbezogen
1977 werden. Für Proxy-Anfragen hat die Vergleichs-URL die Form
1978 <code>schema://servername/path</code>. Das Präfix muss angegeben
1981 <p>Die URL kann Platzhalter verwenden. In einer Zeichenfolge mit
1982 Platzhaltern entspricht <code>?</code> einem einzelnen Zeichen und
1983 <code>*</code>einer beliebigen Zeichenfolge.</p>
1985 <p>Erweiterte reguläre Ausdrücke können ebenfalls
1986 verwendet werden, indem das Zeichen <code>~</code> hinzugefügt
1987 wird. Beispielsweise würde</p>
1989 <div class="example"><p><code>
1990 <Location ~ "/(extra|special)/data">
1993 <p>auf URLs passen, welche die Zeichenfolge <code>/extra/data</code>
1994 oder <code>/special/data</code> enthalten. Die Direktive <code class="directive"><a href="#locationmatch"><LocationMatch></a></code> verhält sich
1995 genauso wie <code class="directive"><Location></code> mit
1996 regulären Ausdrücken.</p>
1998 <p>Die Funktionalität von <code class="directive"><Location></code> ist insbesondere dann nützlich,
1999 wenn sie mit der <code class="directive"><a href="#sethandler">SetHandler</a></code>-Direktive
2000 kombiniert wird. Um zum Beispiel Statusabfragen zu aktivieren, sie aber
2001 nur von Browsern aus <code>foo.com</code> zuzulassen, könnten Sie
2004 <div class="example"><p><code>
2005 <Location /status><br />
2006 <span class="indent">
2007 SetHandler server-status<br />
2008 Order Deny,Allow<br />
2010 Allow from .foo.com<br />
2015 <div class="note"><h3>Anmerkung zu / (Schrägstrich, Slash)</h3>
2016 <p>Das Slash-Zeichen hat eine besondere Bedeutung, je nachdem, wo es
2017 in der URL erscheint. Manche werden sein Verhalten vom Dateisystem
2018 gewohnt sein, wo mehrere aufeinanderfolgende Schrägstriche
2019 häufig zu einem Schrägstrich zusammengefaßt werden
2020 (<em>d.h.</em> <code>/home///foo</code> ist das gleiche wie
2021 <code>/home/foo</code>). Im URL-Raum ist dies nicht notwendigerweise
2022 genauso. Bei der Direktive <code class="directive"><a href="#locationmatch"><LocationMatch></a></code> und der <code class="directive"><Location></code>-Version mit regulären Ausdrücken
2023 müssen Sie explizit mehrere Schrägstriche angeben, wenn Sie
2024 genau dies beabsichtigen.</p>
2026 <p>Beispielsweise würde <code><LocationMatch ^/abc></code>
2027 auf die angeforderte URL <code>/abc</code> passen, nicht aber auf
2028 <code>//abc</code>. Die Direktive <code class="directive"><Location></code> (ohne reguläre Ausdrücke) verhält
2029 sich ähnlich, wenn sie für Proxy-Anfragen verwendet wird.
2030 Wenn <code class="directive"><Location></code> (ohne
2031 reguläre Ausdrücke) jedoch für nicht-Proxy-Anfragen
2032 verwendet wird, werden stillscheigend mehrere Schrächstriche mit
2033 mit einem einzigen Schrägstrich gleichgesetzt. Geben Sie
2034 beispielsweise <code><Location /abc/def></code> an und die
2035 Anfrage lautet auf <code>/abc//def</code>, dann greift die Anweisung.</p>
2040 <li><a href="../sections.html">Wie die Abschnitte <Directory>,
2041 <Location> und <Files> arbeiten</a> für eine
2042 Erläuterung, wie diese verschiedenen Abschnitte miteinander
2043 kombiniert werden, wenn eine Anfrage empfangen wird</li>
2046 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
2047 <div class="directive-section"><h2><a name="LocationMatch" id="LocationMatch"><LocationMatch></a>-<a name="locationmatch" id="locationmatch">Direktive</a></h2>
2048 <table class="directive">
2049 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Wendet die enthaltenen Direktiven nur auf URLs an, die auf
2050 reguläre Ausdrücke passen</td></tr>
2051 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code><LocationMatch
2052 <var>regex</var>> ... </LocationMatch></code></td></tr>
2053 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Serverkonfiguration, Virtual Host</td></tr>
2054 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
2055 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
2057 <p>Die Direktive <code class="directive"><LocationMatch></code>
2058 begrenzt die Reichweite der enthaltenen Anweisungen in der gleichen Weise
2059 wie <code class="directive"><a href="#location"><Location></a></code> auf URLs.
2060 Sie verwendet jedoch reguläre Ausdrücke als Argument anstelle
2061 einer einfachen Zeichenkette. Beispielsweise würde</p>
2063 <div class="example"><p><code>
2064 <LocationMatch "/(extra|special)/data">
2067 <p>auf URLs passen, welche die Zeichenfolge <code>/extra/data</code>
2068 oder <code>/special/data</code> enthalten.</p>
2072 <li><a href="../sections.html">Wie die Abschnitte <Directory>,
2073 <Location> und <Files> arbeiten</a> für eine
2074 Erläuterung, wie diese verschiedenen Abschnitte miteinander
2075 kombiniert werden, wenn eine Anfrage empfangen wird</li>
2078 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
2079 <div class="directive-section"><h2><a name="LogLevel" id="LogLevel">LogLevel</a>-<a name="loglevel" id="loglevel">Direktive</a></h2>
2080 <table class="directive">
2081 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Steuert die Ausführlichkeit des Fehlerprotokolls</td></tr>
2082 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>LogLevel <var>Level</var></code></td></tr>
2083 <tr><th><a href="directive-dict.html#Default">Voreinstellung:</a></th><td><code>LogLevel warn</code></td></tr>
2084 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Serverkonfiguration, Virtual Host</td></tr>
2085 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
2086 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
2088 <p><code class="directive">LogLevel</code> stellt die Ausführlichkeit
2089 der Nachrichten ein, die im Fehlerprotokoll aufgezeichnet werden (siehe
2090 Direktive <code class="directive"><a href="#errorlog">ErrorLog</a></code>). Die folgenden,
2091 nach absteigender Aussagekraft sortierten <var>Level</var> sind
2094 <table class="bordered">
2097 <th><strong>Level</strong> </th>
2099 <th><strong>Beschreibung</strong> </th>
2101 <th><strong>Beispiel</strong> </th>
2105 <td><code>emerg</code> </td>
2107 <td>Notfall - das System ist unbenutzbar.</td>
2109 <td>"Child cannot open lock file. Exiting"
2110 <span class="transnote">(<em>Anm.d.Ü.:</em> "Kindprozess kann die Lock-Datei nicht öffnen.
2111 Beende Programm")</span></td>
2115 <td><code>alert</code> </td>
2117 <td>Maßnahmen müssen unverzüglich ergriffen
2120 <td>"getpwuid: couldn't determine user name from uid"
2121 <span class="transnote">(<em>Anm.d.Ü.:</em> "getpwuid: kann keinen Benutzernamen aus der UID
2122 ermitteln")</span></td>
2126 <td><code>crit</code> </td>
2128 <td>Kritischer Zustand.</td>
2130 <td>"socket: Failed to get a socket, exiting child"
2131 <span class="transnote">(<em>Anm.d.Ü.:</em> "socket: Socket-Zuweisung fehlgeschlagen, beende
2132 Kindprozess")</span></td>
2136 <td><code>error</code> </td>
2138 <td>Fehlerbedingung.</td>
2140 <td>"Premature end of script headers"
2141 <span class="transnote">(<em>Anm.d.Ü.:</em> "Vorzeitiges Ende der Skript-Header")</span></td>
2145 <td><code>warn</code> </td>
2149 <td>"child process 1234 did not exit, sending another SIGHUP"
2150 <span class="transnote">(<em>Anm.d.Ü.:</em> "Kindprozess 1234 nicht beendet, sende ein weiteres
2151 SIGHUP")</span></td>
2155 <td><code>notice</code> </td>
2157 <td>Normaler, aber signifikanter Zustand.</td>
2159 <td>"httpd: caught SIGBUS, attempting to dump core in ..."
2160 <span class="transnote">(<em>Anm.d.Ü.:</em> "httpd: SIGBUS empfangen, versuche Speicherabbild nach ...
2161 zu schreiben")</span></td>
2165 <td><code>info</code> </td>
2167 <td>Information.</td>
2169 <td>"Server seems busy, (you may need to increase
2170 StartServers, or Min/MaxSpareServers)..."
2171 <span class="transnote">(<em>Anm.d.Ü.:</em> "Server scheint beschäftigt zu sein,
2172 (möglicherweise müssen Sie StartServers oder
2173 Min/MaxSpareServers erhöhen)")</span></td>
2177 <td><code>debug</code> </td>
2179 <td>Debug-Level-Nachrichten</td>
2181 <td>"Opening config file ..."
2182 <span class="transnote">(<em>Anm.d.Ü.:</em> "Öffne Konfigurationsdatei ...")</span></td>
2186 <p>Geben Sie einen bestimmten Level an, denn werden Nachrichten von
2187 allen höheren Leveln ebenso angezeigt. <em>Z.B.:</em> Wenn
2188 <code>LogLevel info</code> eingestellt ist, dann werden Nachrichten der
2189 Log-Level <code>notice</code> und <code>warn</code> ebenso eingetragen.</p>
2191 <p>Es wird empfohlen, mindestens den Level <code>crit</code> zu
2196 <div class="example"><p><code>
2200 <div class="note"><h3>Hinweis</h3>
2201 <p>Beim Protokollieren in eine reguläre Datei können
2202 Nachrichten des Levels <code>notice</code> nicht unterdrückt
2203 werden und werden daher immer protokolliert. Dies trifft allerdings
2204 nicht zu, wenn mittels <code>syslog</code> protokolliert wird.</p>
2208 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
2209 <div class="directive-section"><h2><a name="MaxKeepAliveRequests" id="MaxKeepAliveRequests">MaxKeepAliveRequests</a>-<a name="maxkeepaliverequests" id="maxkeepaliverequests">Direktive</a></h2>
2210 <table class="directive">
2211 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Anzahl der Anfragen, die bei einer persistenten Verbindung
2212 zulässig sind</td></tr>
2213 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>MaxKeepAliveRequests <var>Anzahl</var></code></td></tr>
2214 <tr><th><a href="directive-dict.html#Default">Voreinstellung:</a></th><td><code>MaxKeepAliveRequests 100</code></td></tr>
2215 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Serverkonfiguration, Virtual Host</td></tr>
2216 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
2217 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
2219 <p>Die Direktive <code class="directive">MaxKeepAliveRequests</code>
2220 begrenzt die Anzahl der Anfragen, die pro Verbindung zulässig sind,
2221 wenn <code class="directive"><a href="#keepalive">KeepAlive</a></code> eingeschaltet ist.
2222 Bei der Einstellung <code>0</code> sind unbegrenzt viele Anfragen
2223 erlaubt. Wir empfehlen für diese Einstellung einen hohen Wert
2224 für eine maximale Serverleistung.</p>
2228 <div class="example"><p><code>
2229 MaxKeepAliveRequests 500
2233 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
2234 <div class="directive-section"><h2><a name="NameVirtualHost" id="NameVirtualHost">NameVirtualHost</a>-<a name="namevirtualhost" id="namevirtualhost">Direktive</a></h2>
2235 <table class="directive">
2236 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Bestimmt eine IP-Adresse für den Betrieb namensbasierter
2237 virtueller Hosts</td></tr>
2238 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>NameVirtualHost <var>Adresse</var>[:<var>Port</var>]</code></td></tr>
2239 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Serverkonfiguration</td></tr>
2240 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
2241 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
2243 <p>Die Direktive <code class="directive">NameVirtualHost</code> ist erforderlich,
2244 wenn Sie <a href="../vhosts/">namensbasierte virtuelle Hosts</a>
2245 konfigurieren möchten.</p>
2247 <p>Obwohl <var>Adresse</var> eine Hostname sein kann, wird empfohlen,
2248 dass Sie stets eine IP-Adresse verwenden, z.B.:</p>
2250 <div class="example"><p><code>
2251 NameVirtualHost 111.22.33.44
2254 <p>Mit der <code class="directive">NameVirtualHost</code>-Anweisung geben Sie
2255 die IP-Adresse an, unter der der Server Anfragen für
2256 namensbasierte virtuelle Hosts entgegennimmt. Das ist üblicherweise
2257 die Adresse, zu der die Namen Ihrer namensbasierten virtuellen Hosts
2258 aufgelöst werden. Falls eine Firewall oder ein anderer Proxy die
2259 Anfrage in Empfang nimmt und Sie zu einer weiteren IP-Adresse des Servers
2260 weiterleitet, müssen Sie die IP-Adresse der physikalischen
2261 Schnittstelle der Maschine angeben, welche die Anfragen bedient.
2262 Wenn Sie mehrere namensbasierte Hosts an verschiedenen Adressen
2263 betreiben, wiederholen Sie einfach die Anweisung für jede
2266 <div class="note"><h3>Anmerkung</h3>
2267 <p>Beachten Sie, dass der "Hauptserver" und jeder
2268 <code>_default_</code>-Server <strong>niemals</strong> bei einer
2269 Anfrage an einer <code class="directive">NameVirtualHost</code>-IP-Adresse
2270 bedient wird (es sei denn, Sie geben aus irgendwelchen Gründen
2271 <code class="directive">NameVirtualHost</code> an, definieren dann aber keine
2272 <code class="directive">VirtualHost</code>s für diese Adresse).</p>
2275 <p>Optional können Sie die Nummer eines Ports angeben, an dem
2276 namensbasierte virtuelle Hosts verwendet werden sollen. Beispiel:</p>
2278 <div class="example"><p><code>
2279 NameVirtualHost 111.22.33.44:8080
2282 <p>IPv6-Adressen müssen, wie im folgenden Beispiel angegeben, in
2283 eckige Klammern eingeschlossen werden:</p>
2285 <div class="example"><p><code>
2286 NameVirtualHost [2001:db8::a00:20ff:fea7:ccea]:8080
2289 <p>Um an allen Schnittstellen Anfragen zu empfangen, können Sie
2290 <code>*</code> als Argument verwenden.</p>
2292 <div class="example"><p><code>
2296 <div class="note"><h3>Argument der Direktive <code class="directive"><VirtualHost></code></h3>
2297 <p>Beachten Sie, dass das Argument der <code class="directive"><VirtualHost></code>-Anweisung exakt auf das Argument
2298 der <code class="directive">NameVirtualHost</code>-Anweisung passen muss.</p>
2300 <div class="example"><p><code>
2301 NameVirtualHost 1.2.3.4<br />
2302 <VirtualHost 1.2.3.4><br />
2304 </VirtualHost><br />
2310 <li><a href="../vhosts/">Dokumentation zu virtuellen Hosts</a></li>
2313 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
2314 <div class="directive-section"><h2><a name="Options" id="Options">Options</a>-<a name="options" id="options">Direktive</a></h2>
2315 <table class="directive">
2316 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Definiert, welche Eigenschaften oder Funktionen in einem
2317 bestimmten Verzeichnis verfügbar sind</td></tr>
2318 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>Options
2319 [+|-]<var>Option</var> [[+|-]<var>Option</var>] ...</code></td></tr>
2320 <tr><th><a href="directive-dict.html#Default">Voreinstellung:</a></th><td><code>Options All</code></td></tr>
2321 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Serverkonfiguration, Virtual Host, Verzeichnis, .htaccess</td></tr>
2322 <tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>Options</td></tr>
2323 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
2324 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
2326 <p>Die Direktive <code class="directive">Options</code> steuert, welche
2327 Eigenschaften bzw. Funktionen in einem bestimmten Verzeichnis
2330 <p><var>Option</var> kann auf <code>None</code> gesetzt werden, wobei
2331 keine der besonderen Eigenschaften verfügbar sind, oder auf eines
2332 oder mehrere der folgenden:</p>
2335 <dt><code>All</code></dt>
2337 <dd>Alle Optionen außer <code>MultiViews</code>. Dies ist
2338 die Voreinstellung.</dd>
2340 <dt><code>ExecCGI</code></dt>
2342 <dd>Die Ausführung von CGI-Skripten, welche <code class="module"><a href="../mod/mod_cgi.html">mod_cgi</a></code>
2343 verwenden, ist erlaubt.</dd>
2345 <dt><code>FollowSymLinks</code></dt>
2347 <dd>Der Server folgt symbolischen Links in diesem Verzeichnis.
2349 <p>Auch wenn der Server symbolischen Links folgt, bedeutet dies
2350 <em>nicht</em>, dass der zum Abgleich gegen <code class="directive"><a href="#directory"><Directory></a></code>-Abschnitte verwendete Pfadname
2352 <p>Beachten Sie auch, dass diese Option innerhalb eines
2353 <code class="directive"><a href="#location"><Location></a></code>-Abschnitts
2354 <strong>ignoriert wird</strong>.</p>
2357 <dt><code>Includes</code></dt>
2360 Server Side Includes, die von <code class="module"><a href="../mod/mod_include.html">mod_include</a></code> bereitgestellt
2361 werden, sind erlaubt.</dd>
2363 <dt><code>IncludesNOEXEC</code></dt>
2365 <dd>Server Side Includes sind erlaubt, <code>#exec cmd</code>
2366 und <code>#exec cgi</code> sind jedoch deaktiviert. Es ist aber noch
2367 möglich, CGI-Skripte aus
2368 <code class="directive"><a href="../mod/mod_alias.html#scriptalias">ScriptAlias</a></code>-Verzeichnissen mittels
2369 <code>#include virtual</code> einzubinden.</dd>
2371 <dt><code>Indexes</code></dt>
2373 <dd>Wenn eine URL, die auf ein Verzeichnis zeigt, in dem sich keine durch
2374 <code class="directive"><a href="../mod/mod_dir.html#directoryindex">DirectoryIndex</a></code> definierte
2375 Indexdatei (<em>z.B.</em> <code>index.html</code>) befindet, dann liefert
2376 <code class="module"><a href="../mod/mod_autoindex.html">mod_autoindex</a></code> eine formatierte Auflistung des
2377 Verzeichnisses zurück.</dd>
2379 <dt><code>MultiViews</code></dt>
2381 <dd>"MultiViews" sind bei der Verwendung von
2382 <code class="module"><a href="../mod/mod_negotiation.html">mod_negotiation</a></code> erlaubt (siehe <a href="../content-negotiation.html">Content-Negotiation</a>).</dd>
2384 <dt><code>SymLinksIfOwnerMatch</code></dt>
2386 <dd>Der Server folgt nur symbolischen Links, bei denen die Zieldatei
2387 bzw. das Zielverzeichnis der gleichen Benutzerkennung gehört, wie
2389 <div class="note"><h3>Anmerkung</h3> Diese Option wird innerhalb eines
2390 <code class="directive"><a href="#location"><Location></a></code>-Abschnitts
2391 ignoriert.</div></dd>
2394 <p>Wenn mehrere <code class="directive">Options</code> auf ein Verzeichnis
2395 angewandt werden können, dann wird normalerweise die
2396 spezifischste <span class="transnote">(<em>Anm.d.Ü.:</em> Gemeint ist die zuletzt
2397 ausgeführte Option.)</span> verwendet und alle anderen werden
2398 ignoriert; die Optionen werden nicht vermischt. (Siehe auch <a href="../sections.html#mergin">Wie Abschnitte zusammengeführt
2399 werden.</a>.) Wenn jedoch <em>allen</em> Optionen der
2400 <code class="directive">Options</code>-Anweisung eines der Zeichen
2401 <code>+</code> oder <code>-</code> vorangestellt wird, werden die Optionen
2402 zusammengemischt. Jede Option mit vorangestelltem <code>+</code> wird
2403 zu den momentan gültigen Optionen hinzugefügt und jede Option
2404 mit vorangestelltem <code>-</code> wird aus den derzeit gültigen
2405 Optionen entfernt.</p>
2407 <p>So wird zum Beispiel ohne die Zeichen <code>+</code> und
2410 <div class="example"><p><code>
2411 <Directory /web/docs><br />
2412 <span class="indent">
2413 Options Indexes FollowSymLinks<br />
2415 </Directory><br />
2417 <Directory /web/docs/spec><br />
2418 <span class="indent">
2419 Options Includes<br />
2424 <p>für das Verzeichnis <code>/web/docs/spec</code> wird jetzt
2425 lediglich <code>Includes</code> gesetzt. Wenn die zweite
2426 <code class="directive">Options</code>-Anweisung jedoch <code>+</code>-
2427 und <code>-</code>-Zeichen verwenden würde,</p>
2429 <div class="example"><p><code>
2430 <Directory /web/docs><br />
2431 <span class="indent">
2432 Options Indexes FollowSymLinks<br />
2434 </Directory><br />
2436 <Directory /web/docs/spec><br />
2437 <span class="indent">
2438 Options +Includes -Indexes<br />
2443 <p>dann würden die Optionen <code>FollowSymLinks</code> und
2444 <code>Includes</code> für das Verzeichnis <code>/web/docs/spec</code>
2447 <div class="note"><h3>Anmerkung</h3>
2448 <p>Die Verwendung von <code>-IncludesNOEXEC</code> oder
2449 <code>-Includes</code> deaktiviert Server Side Includes unabhängig
2450 von der vorigen Einstellung vollständig.</p>
2453 <p>Die Voreinstellung ist <code>All</code>, sofern keine anderen Angaben
2457 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
2458 <div class="directive-section"><h2><a name="Require" id="Require">Require</a>-<a name="require" id="require">Direktive</a></h2>
2459 <table class="directive">
2460 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Wählt die authentisierten Benutzer aus, die auf eine
2461 Ressource zugreifen können</td></tr>
2462 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>Require <var>Name</var> [<var>Name</var>] ...</code></td></tr>
2463 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Verzeichnis, .htaccess</td></tr>
2464 <tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>AuthConfig</td></tr>
2465 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
2466 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
2468 <p>Die Direktive wählt aus, welche authentisierten Benutzer auf eine
2469 Ressource zugreifen dürfen. Folgende Syntax ist erlaubt:</p>
2472 <dt><code>Require user <var>User-ID</var> [<var>User-ID</var>]
2474 <dd>Nur die genannten Benutzer dürfen auf die Ressource
2477 <dt><code>Require group <var>Gruppenname</var> [<var>Gruppenname</var>]
2479 <dd>Nur Benutzer der genannten Gruppen dürfen auf die
2480 Ressource zugreifen.</dd>
2482 <dt><code>Require valid-user</code></dt>
2483 <dd>Alle gültigen Benutzer dürfen auf die Ressource
2487 <p><code class="directive">Require</code> muss von den Direktiven
2488 <code class="directive"><a href="#authname">AuthName</a></code> und <code class="directive"><a href="#authtype">AuthType</a></code> sowie Direktiven wie
2489 <code class="directive"><a href="../mod/mod_authn_file.html#authuserfile">AuthUserFile</a></code>
2490 und <code class="directive"><a href="../mod/mod_authz_groupfile.html#authgroupfile">AuthGroupFile</a></code>
2491 (zur Definition von Benutzern und Gruppen) begleitet werden, um
2492 korrekt zu funktionieren. Beispiel:</p>
2494 <div class="example"><p><code>
2495 AuthType Basic<br />
2496 AuthName "Geschützte Ressource"<br />
2497 AuthUserFile /web/users<br />
2498 AuthGroupFile /web/groups<br />
2502 <p>Zugriffskontrollen, die in dieser Form angewandt werden, gelten
2503 für <strong>alle</strong> Methoden. <strong>Dies ist normalerweise
2504 gewünscht.</strong> Wenn Sie Zugriffskontrollen nur auf bestimmte
2505 Methoden anwenden möchten, während andere Methoden
2506 ungeschützt bleiben, dann müssen Sie die
2507 <code class="directive">Require</code>-Anweisung innerhalb eines
2508 <code class="directive"><a href="#limit"><Limit></a></code>-Abschnitts
2513 <li><code class="directive"><a href="#satisfy">Satisfy</a></code></li>
2514 <li><code class="module"><a href="../mod/mod_authz_host.html">mod_authz_host</a></code></li>
2517 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
2518 <div class="directive-section"><h2><a name="RLimitCPU" id="RLimitCPU">RLimitCPU</a>-<a name="rlimitcpu" id="rlimitcpu">Direktive</a></h2>
2519 <table class="directive">
2520 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Begrenzt den CPU-Verbrauch von Prozessen, die von
2521 Apache-Kindprozessen gestartet wurden</td></tr>
2522 <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>
2523 <tr><th><a href="directive-dict.html#Default">Voreinstellung:</a></th><td><code>unbestimmt; verwendet die Voreinstellung des Systems</code></td></tr>
2524 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Serverkonfiguration, Virtual Host, Verzeichnis, .htaccess</td></tr>
2525 <tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>All</td></tr>
2526 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
2527 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
2529 <p>Akzeptiert einen oder zwei Parameter. Der erste Paramater setzt eine
2530 weiche Ressourcenbegrenzung für alle Prozesse, der zweite Parameter
2531 setzt die Maximalgrenze für die Ressourcennutzung. Jeder der
2532 Parameter kann eine Zahl oder <code>max</code> sein. <code>max</code>
2533 zeigt dem Server an, dass das vom Betriebssystem erlaubte Maximum
2534 verwendet werden soll. Das Anheben der maximal erlaubten Ressourcennutzung
2535 erfordert, dass der Server als <code>root</code> läuft, zumindest in
2536 der anfänglichen Startphase.</p>
2538 <p>Dies wird auf Prozesse angewendet, die von Anfragen bearbeitenden
2539 Apache-Kindprozessen abgespalten werden, nicht auf die
2540 Apache-Kindprozesse selbst. Das beinhaltet CGI-Skripte und
2541 SSI-exec-Befehle, nicht jedoch Prozesse, die vom Apache-Elternprozess
2542 abgespalten werden, wie z.B. Protokollierung.</p>
2544 <p>CPU-Ressourcenbegrenzung wird in Sekunden pro Prozess
2549 <li><code class="directive"><a href="#rlimitmem">RLimitMEM</a></code></li>
2550 <li><code class="directive"><a href="#rlimitnproc">RLimitNPROC</a></code></li>
2553 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
2554 <div class="directive-section"><h2><a name="RLimitMEM" id="RLimitMEM">RLimitMEM</a>-<a name="rlimitmem" id="rlimitmem">Direktive</a></h2>
2555 <table class="directive">
2556 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Begrenzt den Speicherverbrauch von Prozessen, die von
2557 Apache-Kindprozessen gestartet wurden</td></tr>
2558 <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>
2559 <tr><th><a href="directive-dict.html#Default">Voreinstellung:</a></th><td><code>unbestimmt; verwendet die Voreinstellung des Systems</code></td></tr>
2560 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Serverkonfiguration, Virtual Host, Verzeichnis, .htaccess</td></tr>
2561 <tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>All</td></tr>
2562 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
2563 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
2565 <p>Akzeptiert einen oder zwei Parameter. Der erste Paramater setzt eine
2566 weiche Ressourcenbegrenzung für alle Prozesse, der zweite Parameter
2567 setzt die Maximalgrenze für die Ressourcennutzung. Jeder der
2568 Parameter kann eine Zahl oder <code>max</code> sein. <code>max</code>
2569 zeigt dem Server an, dass das vom Betriebssystem erlaubte Maximum
2570 verwendet werden soll. Das Anheben der maximal erlaubten Ressourcennutzung
2571 erfordert, dass der Server als <code>root</code> läuft, zumindest in
2572 der anfänglichen Startphase.</p>
2574 <p>Dies wird auf Prozesse angewendet, die von Anfragen bearbeitenden
2575 Apache-Kindprozessen abgespalten werden, nicht auf die
2576 Apache-Kindprozesse selbst. Das beinhaltet CGI-Skripte und
2577 SSI-exec-Befehle, nicht jedoch Prozesse, die vom Apache-Elternprozess
2578 abgespalten werden, wie z.B. Protokollierung.</p>
2580 <p>Die Begrenzung des Speicherverbrauchs wird in Bytes pro Prozess
2585 <li><code class="directive"><a href="#rlimitcpu">RLimitCPU</a></code></li>
2586 <li><code class="directive"><a href="#rlimitnproc">RLimitNPROC</a></code></li>
2589 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
2590 <div class="directive-section"><h2><a name="RLimitNPROC" id="RLimitNPROC">RLimitNPROC</a>-<a name="rlimitnproc" id="rlimitnproc">Direktive</a></h2>
2591 <table class="directive">
2592 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Begrenzt die Anzahl der Prozesse, die von Prozessen gestartet
2593 werden können, der ihrerseits von Apache-Kinprozessen gestartet
2595 <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>
2596 <tr><th><a href="directive-dict.html#Default">Voreinstellung:</a></th><td><code>unbestimmt; verwendet die Voreinstellung des Systems</code></td></tr>
2597 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Serverkonfiguration, Virtual Host, Verzeichnis, .htaccess</td></tr>
2598 <tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>All</td></tr>
2599 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
2600 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
2602 <p>Akzeptiert einen oder zwei Parameter. Der erste Paramater setzt eine
2603 weiche Ressourcenbegrenzung für alle Prozesse, der zweite Parameter
2604 setzt die Maximalgrenze für die Ressourcennutzung. Jeder der
2605 Parameter kann eine Zahl oder <code>max</code> sein. <code>max</code>
2606 zeigt dem Server an, dass das vom Betriebssystem erlaubte Maximum
2607 verwendet werden soll. Das Anheben der maximal erlaubten Ressourcennutzung
2608 erfordert, dass der Server als <code>root</code> läuft, zumindest in
2609 der anfänglichen Startphase.</p>
2611 <p>Dies wird auf Prozesse angewendet, die von Anfragen bearbeitenden
2612 Apache-Kindprozessen abgespalten werden, nicht auf die
2613 Apache-Kindprozesse selbst. Dies beinhaltet CGI-Skripte und
2614 SSI-exec-Befehle, nicht jedoch Prozesse, die vom Apache-Elternprozess
2615 abgespalten werden, wie z.B. Protokollierung.</p>
2617 <p>Prozessbegrenzungen steuern die Anzahl der Prozesse pro Benutzer.</p>
2619 <div class="note"><h3>Anmerkung</h3>
2620 <p>Wenn CGI-Prozesse nicht unter anderen Benutzerkennungen als der
2621 User-ID des Webservers laufen, dann beschränkt diese Direktive
2622 die Anzahl der Prozesse, die der Server selbst erstellen kann.
2623 Kennzeichen einer solchen Situation sind
2624 <strong><code>cannot fork</code></strong>-Meldungen
2625 <span class="transnote">(<em>Anm.d.Ü.:</em> <code>kann nicht abspalten</code>)</span> in der
2626 Datei <code>error_log</code>.</p>
2631 <li><code class="directive"><a href="#rlimitmem">RLimitMEM</a></code></li>
2632 <li><code class="directive"><a href="#rlimitcpu">RLimitCPU</a></code></li>
2635 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
2636 <div class="directive-section"><h2><a name="Satisfy" id="Satisfy">Satisfy</a>-<a name="satisfy" id="satisfy">Direktive</a></h2>
2637 <table class="directive">
2638 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Zusammenspiel von rechnerbasierter Zugriffskontrolle und
2639 Benutzerauthentisierung</td></tr>
2640 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>Satisfy Any|All</code></td></tr>
2641 <tr><th><a href="directive-dict.html#Default">Voreinstellung:</a></th><td><code>Satisfy All</code></td></tr>
2642 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Verzeichnis, .htaccess</td></tr>
2643 <tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>AuthConfig</td></tr>
2644 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
2645 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
2646 <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"><Limit></a></code> und <code class="directive"><a href="#limitexcept"><LimitExcept></a></code> beeinflusst</td></tr>
2648 <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
2649 entweder <code>All</code> oder <code>Any</code> sein. Die Direktive ist
2650 nur dann nützlich, wenn der Zugriff zu einem bestimmten Bereich
2651 durch Benutzername/Passwort <em>und</em> Clientrechner-Adressen
2652 eingeschränkt ist. In diesem Fall verlangt die Voreinstellung
2653 (<code>All</code>), dass der Client die Adressbeschränkung passiert
2654 <em>und</em> eine gültige Benutzerkennung und ein gültiges
2655 Passwort übermittelt. Mit der Auswahl <code>Any</code> wird dem
2656 Client der Zugriff erlaubt, wenn er entweder die Rechner-Beschänkung
2657 passiert oder einen gültigen Benutzernamen und ein gültiges
2658 Passwort übermittelt. Dies kann verwendet werden, um einen Bereich
2659 mit einem Passwort zu schützen, jedoch Clients von bestimmten
2660 Adressen ohne Abfrage des Passwortes zuzulassen.</p>
2662 <p>Wenn Sie beispielsweise möchten, dass Personen aus Ihrem
2663 privaten Netzwerk unbechänkten Zugriff zu Teilen Ihres
2664 Webangebots haben, jedoch verlangen, dass Personen außerhalb
2665 Ihres privaten Netzwerks ein Passwort übergeben müssen,
2666 können Sie eine Konfiguration ähnlich der folgenden
2669 <div class="example"><p><code>
2670 Require valid-user<br />
2671 Allow from 192.168.1<br />
2675 <p>Seit Version 2.0.51 können
2676 <code class="directive">Satisfy</code>-Anweisungen durch <code class="directive"><a href="#limit"><Limit></a></code>- und <code class="directive"><a href="#limitexcept"><LimitExcept></a></code>-Abschnitte auf bestimmte Methoden
2677 beschränkt werden.</p>
2681 <li><code class="directive"><a href="../mod/mod_authz_host.html#allow">Allow</a></code></li>
2682 <li><code class="directive"><a href="#require">Require</a></code></li>
2685 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
2686 <div class="directive-section"><h2><a name="ScriptInterpreterSource" id="ScriptInterpreterSource">ScriptInterpreterSource</a>-<a name="scriptinterpretersource" id="scriptinterpretersource">Direktive</a></h2>
2687 <table class="directive">
2688 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Methode zur Ermittlung des Interpreters von
2689 CGI-Skripten</td></tr>
2690 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>ScriptInterpreterSource Registry|Registry-Strict|Script</code></td></tr>
2691 <tr><th><a href="directive-dict.html#Default">Voreinstellung:</a></th><td><code>ScriptInterpreterSource Script</code></td></tr>
2692 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Serverkonfiguration, Virtual Host, Verzeichnis, .htaccess</td></tr>
2693 <tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>FileInfo</td></tr>
2694 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
2695 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
2696 <tr><th><a href="directive-dict.html#Compatibility">Kompatibilität:</a></th><td>ausschließlich Win32;
2697 Die Option <code>Registry-Strict</code> ist verfügbar seit Apache
2700 <p>Die Direktive steuert, wie der Apache den Interpreter zur Ausführung
2701 von CGI-Skripten bestimmt. Die Voreinstellung ist <code>Script</code>. Dies
2702 veranlaßt den Apache, den Interpreter zu verwenden, auf den die
2703 Shebang-Zeile (erste Zeile, beginnt mit <code>#!</code>) im Skript zeigt.
2704 Auf Win32-Systemen sieht diese Zeile üblicherweise so aus:</p>
2706 <div class="example"><p><code>
2707 #!C:/Perl/bin/perl.exe
2710 <p>oder, wenn <code>perl</code> im Pfad (Umgebungsvariable <code>PATH</code>) liegt,
2713 <div class="example"><p><code>
2717 <p>Die Einstellung <code>ScriptInterpreterSource Registry</code>
2718 veranlaßt eine Suche in <code>HKEY_CLASSES_ROOT</code> der
2719 Windows-Registrierungsdatenbank und verwendet die Endung der Skript-Datei
2720 (z.B. <code>.pl</code>) als Suchargument. Der durch den Unterschlüssel
2721 <code>Shell\ExecCGI\Command</code> oder, falls dieser nicht existiert,
2722 <code>Shell\Open\Command</code> definierte Befehl wird zum Öffnen der
2723 Skript-Datei verwendet. Wenn der Schlüssel zur Dateiendung oder
2724 beide Unterschlüssel fehlen, dann verwendet der Apache die Option
2725 <code>Script</code>.</p>
2727 <div class="warning"><h3>Sicherheit</h3>
2728 <p>Seien Sie vorsichtig, <code>ScriptInterpreterSource Registry</code> bei
2729 Verzeichnissen zu verwenden, auf die eine <code class="directive"><a href="../mod/mod_alias.html#scriptalias">ScriptAlias</a></code>-Anweisung zeigt, denn der
2730 Apache versucht <strong>jede</strong> Datei innerhalb des Verzeichnisses
2731 auszuführen. Die Einstellung <code>Registry</code> kann
2732 unerwünschte Programmaufrufe bei Dateien verursachen, die
2733 üblicherweise nicht ausgeführt werden. Auf den meisten
2734 Windows-Systemen beispielsweise startet der voreingestellte
2735 Öffnen-Befehl für <code>.htm</code>-Dateien den Microsoft
2736 Internet Explorer, so dass jede HTTP-Anfrage nach einer existierenden
2737 <code>.htm</code>-Datei im Skript-Verzeichnis den Browser im Hintergrund
2738 starten würde. Dies ist eine wirksame Methode, Ihr System binnen
2739 etwa einer Minute zum Absturz zu bringen.</p>
2742 <p>Die seit Apache 2.0 neue Option <code>Registry-Strict</code>
2743 macht das gleiche wie <code>Registry</code>, verwendet jedoch nur den
2744 Unterschlüssel <code>Shell\ExecCGI\Command</code>. Der Schlüssel
2745 <code>ExecCGI</code> ist gewöhnlich nicht voreingestellt. Er muss
2746 manuell eingerichtet werden und schützt Ihr System so for
2747 versehentlichen Programmaufrufen.</p>
2750 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
2751 <div class="directive-section"><h2><a name="ServerAdmin" id="ServerAdmin">ServerAdmin</a>-<a name="serveradmin" id="serveradmin">Direktive</a></h2>
2752 <table class="directive">
2753 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>E-Mail-Adresse, die der Server in Fehlermeldungen einfügt,
2754 welche an den Client gesendet werden</td></tr>
2755 <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>
2756 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Serverkonfiguration, Virtual Host</td></tr>
2757 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
2758 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
2760 <p><code class="directive">ServerAdmin</code> legt die Kontaktadresse fest,
2761 die der Server in jede Fehlermeldung einfügt, die er an den
2762 Client zurückschickt. Wenn <code>httpd</code> das übergebene
2763 Argument nicht als URL erkennt, nimmt er an, dess es sich um eine
2764 <var>E-Mail-Adresse</var> handelt und stellt in Hyperlinks
2765 <code>mailto:</code> voran. Es ist jedoch sogar sinnvoll, eine
2766 E-Mail-Adresse zu verwenden, da viele CGI-Skripte davon ausgehen. Wenn Sie
2767 eine URL verwenden möchten, sollten Sie auf einem anderen unter Ihrer
2768 Kontrolle stehenden Server verweisen. Andernfalls können Besucher Sie
2769 im Fehlerfall möglicherweise nicht kontaktieren.</p>
2771 <p>Es kann sich lohnen, hierfür eine reservierte Adresse
2774 <div class="example"><p><code>
2775 ServerAdmin www-admin@foo.example.com
2778 <p>da Anwender nicht unbedingt erwähnen, dass sie vom Server
2782 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
2783 <div class="directive-section"><h2><a name="ServerAlias" id="ServerAlias">ServerAlias</a>-<a name="serveralias" id="serveralias">Direktive</a></h2>
2784 <table class="directive">
2785 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Alternativer Name für einen Host, der verwendet wird, wenn
2786 Anfragen einem namensbasierten virtuellen Host zugeordnet werden</td></tr>
2787 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>ServerAlias <var>Hostname</var> [<var>Hostname</var>] ...</code></td></tr>
2788 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Virtual Host</td></tr>
2789 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
2790 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
2792 <p>Die Direktive <code class="directive">ServerAlias</code> bestimmt die
2793 alternativen Namen eines Hosts zur Verwendung mit <a href="../vhosts/name-based.html">namensbasierten virtuellen Hosts</a>.</p>
2795 <div class="example"><p><code>
2796 <VirtualHost *><br />
2797 ServerName server.domain.com<br />
2798 ServerAlias server server2.domain.com server2<br />
2800 </VirtualHost>
2805 <li><a href="../vhosts/">Apache-Dokumentation zu virtuellen
2809 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
2810 <div class="directive-section"><h2><a name="ServerName" id="ServerName">ServerName</a>-<a name="servername" id="servername">Direktive</a></h2>
2811 <table class="directive">
2812 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Rechnername und Port, die der Server dazu verwendet, sich
2813 selbst zu identifizieren</td></tr>
2814 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>ServerName
2815 <var>voll-qualifizierter-Domainname</var>[:<var>port</var>]</code></td></tr>
2816 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Serverkonfiguration, Virtual Host</td></tr>
2817 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
2818 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
2819 <tr><th><a href="directive-dict.html#Compatibility">Kompatibilität:</a></th><td>Diese Direktive löst in Version 2.0 die
2820 Funktionalität der Direktive <code class="directive">Port</code> aus
2821 Version 1.3 ab.</td></tr>
2823 <p>Die Direktive <code class="directive">ServerName</code> bestimmt den
2824 Rechnernamen und Port, den der Server dazu verwendet, sich selbst
2825 zu identifizieren. Diese werden bei der Erstellung von Umleitungs-URLs
2826 benötigt. Wenn beispielsweise der Name der Maschine, die den Webserver
2827 beherbergt, <code>simple.example.com</code> lautet, die Maschine jedoch
2828 auch einen DNS-Alias <code>www.example.com</code> besitzt und Sie den
2829 Webserver so identifizieren möchten, sollten Sie die folgende
2830 Anweisung verwenden:</p>
2832 <div class="example"><p><code>
2833 ServerName www.example.com:80
2836 <p>Wenn kein <code class="directive">ServerName</code> angegeben wurde,
2837 dann versucht der Server den Rechnernamen mittels eines Reverse-Lookup
2838 herzuleiten. Wenn kein Port in der
2839 <code class="directive">ServerName</code>-Anweisung angegeben wurde, dann
2840 verwendet der Server den Port der eingegangenen Anfrage. Für eine
2841 optimale Zuverlässigkeit und Berechenbarkeit sollten Sie einen
2842 eindeutigen Rechnernamen und Port angeben, in dem Sie die Direktive
2843 <code class="directive">ServerName</code> verwenden.</p>
2845 <p>Wenn Sie <a href="../vhosts/name-based.html">namensbasierte
2846 virtuelle Hosts</a> verwenden, gibt <code class="directive">ServerName</code>
2847 innerhalb eines <code class="directive"><a href="#virtualhost"><VirtualHost></a></code>-Abschnitts an, welcher
2848 Hostname im <code>Host:</code>-Header der Anfrage auftauchen muss,
2849 damit sie diesem virtuellen Host zugeordnet wird.</p>
2851 <p>Lesen Sie bitte die Beschreibung der Direktive <code class="directive"><a href="#usecanonicalname">UseCanonicalName</a></code> für Einstellungen, die
2852 bestimmen, ob selbstreferenzierende URLs (z.B. vom Modul
2853 <code class="module"><a href="../mod/mod_dir.html">mod_dir</a></code>) auf den angegebenen Port zeigen oder auf die
2854 Portnummern die in der Anfrage des Clients angegeben ist.</p>
2858 <li><a href="../dns-caveats.html">Probleme bezüglich DNS und
2860 <li><a href="../vhosts/">Apache-Dokumentation zu virtuellen
2862 <li><code class="directive"><a href="#usecanonicalname">UseCanonicalName</a></code></li>
2863 <li><code class="directive"><a href="#namevirtualhost">NameVirtualHost</a></code></li>
2864 <li><code class="directive"><a href="#serveralias">ServerAlias</a></code></li>
2867 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
2868 <div class="directive-section"><h2><a name="ServerPath" id="ServerPath">ServerPath</a>-<a name="serverpath" id="serverpath">Direktive</a></h2>
2869 <table class="directive">
2870 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Veralteter URL-Pfad für einen namensbasierten
2871 virtuellen Host, auf den von einem inkompatiblen Browser zugegriffen
2873 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>ServerPath <var>URL-Pfad</var></code></td></tr>
2874 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Virtual Host</td></tr>
2875 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
2876 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
2878 <p>Die Direktive <code class="directive">ServerPath</code> legt den
2879 veralteten <span class="transnote">(<em>Anm.d.Ü.:</em> Gemeint ist eigentlich "Altlast" aufgrund
2880 antiquierter Clients.)</span> URL-Pfad eines Hosts zur Verwendung mit
2881 <a href="../vhosts/">namensbasierten virtuellen Hosts</a> fest.</p>
2885 <li><a href="../vhosts/">Apache-Dokumentation zu virtuellen
2889 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
2890 <div class="directive-section"><h2><a name="ServerRoot" id="ServerRoot">ServerRoot</a>-<a name="serverroot" id="serverroot">Direktive</a></h2>
2891 <table class="directive">
2892 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Basisverzeichnis der Serverinstallation</td></tr>
2893 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>ServerRoot <var>Verzeichnis</var></code></td></tr>
2894 <tr><th><a href="directive-dict.html#Default">Voreinstellung:</a></th><td><code>ServerRoot /usr/local/apache</code></td></tr>
2895 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Serverkonfiguration</td></tr>
2896 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
2897 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
2899 <p>Die Direktive <code class="directive">ServerRoot</code> bestimmt das
2900 Verzeichnis, in dem der Server installiert ist. Üblicherweise
2901 enthält es die Unterverzeichnisse <code>conf/</code> und
2902 <code>logs/</code>. Relative Pfadangaben anderer Direktiven (wie z.B.
2903 <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
2904 Verzeichnis betrachtet.</p>
2906 <div class="example"><h3>Beispiel</h3><p><code>
2907 ServerRoot /home/httpd
2912 <li><a href="../invoking.html">Die <code>httpd</code>-Option
2913 <code>-d</code></a></li>
2914 <li><a href="../misc/security_tips.html#serverroot">Sicherheitshinweise</a>
2915 für Informationen, wie die Rechte auf das <code class="directive">ServerRoot</code>-Verzeichnis richtig gesetzt werden</li>
2918 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
2919 <div class="directive-section"><h2><a name="ServerSignature" id="ServerSignature">ServerSignature</a>-<a name="serversignature" id="serversignature">Direktive</a></h2>
2920 <table class="directive">
2921 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Konfiguriert die Fußzeile von servergenerierten
2922 Dokumenten</td></tr>
2923 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>ServerSignature On|Off|EMail</code></td></tr>
2924 <tr><th><a href="directive-dict.html#Default">Voreinstellung:</a></th><td><code>ServerSignature Off</code></td></tr>
2925 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Serverkonfiguration, Virtual Host, Verzeichnis, .htaccess</td></tr>
2926 <tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>All</td></tr>
2927 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
2928 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
2930 <p>Die Direktive <code class="directive">ServerSignature</code> ermöglicht
2931 die Gestaltung einer unter servergenerierten Dokumenten (z.B.
2932 Fehlerdokumente, FTP-Verzeichnislisten von <code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code>,
2933 <code class="module"><a href="../mod/mod_info.html">mod_info</a></code>-Ausgaben, ...) angefügten
2934 Fußzeile. Ein möglicher Grund für die Aktivierung einer
2935 solchen Fußzeile ist, dass der Anwender bei einer Kette von
2936 Proxy-Servern oft keine Möglichkeit hat, zu erkennen, welcher der
2937 verketteten Server gegenwärtig die zurückgegebene Fehlermeldung
2940 <p>Die (Vor-)Einstellung <code>Off</code> unterdrückt die
2941 Fußzeile (und ist damit kompatibel zum Verhalten des Apache 1.2 und
2942 früher). Die Einstellung <code>On</code> fügt schlicht eine
2943 Zeile mit der Versionsnummer des Servers und dem Servernamen (<code class="directive"><a href="#servername">ServerName</a></code>) des bedienenden virtuellen Hosts an.
2944 Die Einstellung <code>EMail</code> erstellt zusätzlich einen
2945 "mailto:"-Verweis zum Serveradministrator (<code class="directive"><a href="#serveradmin">ServerAdmin</a></code>) des referenzierten Dokuments.</p>
2947 <p>Ab Version 2.0.44 werden die Details der angegebenen Versionsnummer des
2948 Servers von der Direktive <code class="directive"><a href="#servertokens">ServerTokens</a></code> kontrolliert.</p>
2952 <li><code class="directive"><a href="#servertokens">ServerTokens</a></code></li>
2955 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
2956 <div class="directive-section"><h2><a name="ServerTokens" id="ServerTokens">ServerTokens</a>-<a name="servertokens" id="servertokens">Direktive</a></h2>
2957 <table class="directive">
2958 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Konfiguriert den HTTP-Response-Header
2959 <code>Server</code></td></tr>
2960 <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>
2961 <tr><th><a href="directive-dict.html#Default">Voreinstellung:</a></th><td><code>ServerTokens Full</code></td></tr>
2962 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Serverkonfiguration</td></tr>
2963 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
2964 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
2966 <p>die Direktive steuert, ob der Response-Header <code>Server</code>,
2967 der an den Client zurückgesendet wird, eine Beschreibung des
2968 allgemeinen Betriesbsystemtyps des Servers wie auch Informationen
2969 über einkompilierte Module enthält.</p>
2972 <dt><code>ServerTokens Prod[uctOnly]</code></dt>
2974 <dd>Der Server sendet (<em>z.B.</em>): <code>Server:
2977 <dt><code>ServerTokens Major</code></dt>
2979 <dd>Der Server sendet (<em>z.B.</em>): <code>Server:
2980 Apache/2</code></dd>
2982 <dt><code>ServerTokens Minor</code></dt>
2984 <dd>Der Server sendet (<em>z.B.</em>): <code>Server:
2985 Apache/2.0</code></dd>
2987 <dt><code>ServerTokens Min[imal]</code></dt>
2989 <dd>Der Server sendet (<em>z.B.</em>): <code>Server:
2990 Apache/2.0.41</code></dd>
2992 <dt><code>ServerTokens OS</code></dt>
2994 <dd>Der Server sendet (<em>z.B.</em>): <code>Server: Apache/2.0.41
2997 <dt><code>ServerTokens Full</code> (oder nicht angegeben)</dt>
2999 <dd>Der Server sendet (<em>z.B.</em>): <code>Server: Apache/2.0.41
3000 (Unix) PHP/4.2.2 MyMod/1.2</code></dd>
3003 <p>Diese Einstellung gilt für den gesamten Server und kann nicht
3004 auf Virtual-Host-Basis aktiviert oder deaktiviert werden.</p>
3006 <p>Ab Version 2.0.44 steuert diese Direktive auch die Informationen, die
3007 durch die Direktive <code class="directive"><a href="#serversignature">ServerSignature</a></code>
3008 angeboten werden.</p>
3012 <li><code class="directive"><a href="#serversignature">ServerSignature</a></code></li>
3015 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
3016 <div class="directive-section"><h2><a name="SetHandler" id="SetHandler">SetHandler</a>-<a name="sethandler" id="sethandler">Direktive</a></h2>
3017 <table class="directive">
3018 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Erzwingt die Verarbeitung aller passenden Dateien durch
3019 einen Handler</td></tr>
3020 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>SetHandler <var>Handlername</var>|None</code></td></tr>
3021 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Serverkonfiguration, Virtual Host, Verzeichnis, .htaccess</td></tr>
3022 <tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>FileInfo</td></tr>
3023 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
3024 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
3025 <tr><th><a href="directive-dict.html#Compatibility">Kompatibilität:</a></th><td>Seit Apache 2.0 im Core</td></tr>
3027 <p>Wenn die Direktive innerhalb einer <code>.htaccess</code>-Datei
3028 oder in einem <code class="directive"><a href="#directory"><Directory></a></code>- oder
3029 <code class="directive"><a href="#location"><Location></a></code>-Abschnitt
3030 angegeben wird, erzwingt sie, dass alle entsprechenden Dateien von dem
3031 durch <var>Handlername</var> angegebenen <a href="../handler.html">Handler</a> analysiert werden. Wenn Sie
3032 beispielsweise ein Verzeichnis haben, dessen Dateien unabhängig von
3033 der Endung gänzlich als Image-Maps interpretiert werden sollen,
3034 können Sie folgendes in eine <code>.htaccess</code>-Datei in
3035 dem Verzeichnis schreiben:</p>
3037 <div class="example"><p><code>
3038 SetHandler imap-file
3041 <p>Noch ein Beispiel: wenn Sie den Server immer, wenn die URL
3042 <code>http://servername/status</code> aufgerufen wird, einen
3043 Statusbericht anzeigen lassen möchten, dann können
3044 Sie folgendes in die <code>httpd.conf</code> schreiben:</p>
3046 <div class="example"><p><code>
3047 <Location /status><br />
3048 <span class="indent">
3049 SetHandler server-status<br />
3053 <p>Sie können eine zuvor definierte
3054 <code class="directive">SetHandler</code>-Anweisung aufheben, indem Sie den Wert
3055 <code>None</code> verwenden.</p>
3059 <li><code class="directive"><a href="../mod/mod_mime.html#addhandler">AddHandler</a></code></li>
3062 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
3063 <div class="directive-section"><h2><a name="SetInputFilter" id="SetInputFilter">SetInputFilter</a>-<a name="setinputfilter" id="setinputfilter">Direktive</a></h2>
3064 <table class="directive">
3065 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Bestimmt die Filter, die Client-Anfragen und POST-Eingaben
3066 verarbeiten</td></tr>
3067 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>SetInputFilter <var>Filter</var>[;<var>Filter</var>...]</code></td></tr>
3068 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Serverkonfiguration, Virtual Host, Verzeichnis, .htaccess</td></tr>
3069 <tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>FileInfo</td></tr>
3070 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
3071 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
3073 <p>Die Direktive <code class="directive">SetInputFilter</code> bestimmt den oder
3074 die Filter, die Client-Anfragen und POST-Eingaben verarbeiten, wenn
3075 sie vom Server empfangen werden. Diese gelten zusätzlich zu
3076 anderweitig definierten Filtern, einschließlich denen der Direktive
3077 <code class="directive"><a href="../mod/mod_mime.html#addinputfilter">AddInputFilter</a></code>.</p>
3079 <p>Wenn mehr als ein Filter angegeben wird, dann müssen diese
3080 durch Semikolon voneinander getrennt in der Reihenfolge angegeben werden,
3081 in der sie die Daten verarbeiten sollen.</p>
3085 <li><a href="../filter.html">Filter</a>-Dokumentation</li>
3088 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
3089 <div class="directive-section"><h2><a name="SetOutputFilter" id="SetOutputFilter">SetOutputFilter</a>-<a name="setoutputfilter" id="setoutputfilter">Direktive</a></h2>
3090 <table class="directive">
3091 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Bestimmt die Filter, die Antworten des Servers verarbeiten</td></tr>
3092 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>SetOutputFilter <var>Filter</var>[;<var>Filter</var>...]</code></td></tr>
3093 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Serverkonfiguration, Virtual Host, Verzeichnis, .htaccess</td></tr>
3094 <tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>FileInfo</td></tr>
3095 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
3096 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
3098 <p>Die Direktive <code class="directive">SetOutputFilter</code> bestimmt
3099 die Filter, die Antworten des Servers verarbeiten, bevor sie an den
3100 Client gesendet werden. Diese gelten zusätzlich zu anderweitig
3101 definierten Filtern, einschließlich denen der Direktive
3102 <code class="directive"><a href="../mod/mod_mime.html#addoutputfilter">AddOutputFilter</a></code>.</p>
3104 <p>Die folgende Konfiguration verarbeitet zum Beispiel alle Dateien
3105 im Verzeichnis <code>/www/data</code> als Server Side Includes.</p>
3107 <div class="example"><p><code>
3108 <Directory /www/data/><br />
3109 <span class="indent">
3110 SetOutputFilter INCLUDES<br />
3115 <p>Wenn mehr als ein Filter angegeben wird, dann müssen diese
3116 durch Semikolon voneinander getrennt in der Reihenfolge angegeben werden,
3117 in der sie die Daten verarbeiten sollen.</p>
3121 <li><a href="../filter.html">Filter</a>-Dokumentation</li>
3124 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
3125 <div class="directive-section"><h2><a name="TimeOut" id="TimeOut">TimeOut</a>-<a name="timeout" id="timeout">Direktive</a></h2>
3126 <table class="directive">
3127 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Zeitspanne, die der Server auf verschiedene Ereignisse wartet,
3128 bevor er die Anfrage abbricht</td></tr>
3129 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>TimeOut <var>Sekunden</var></code></td></tr>
3130 <tr><th><a href="directive-dict.html#Default">Voreinstellung:</a></th><td><code>TimeOut 300</code></td></tr>
3131 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Serverkonfiguration</td></tr>
3132 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
3133 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
3135 <p>Die Direktive <code class="directive">TimeOut</code> definiert derzeit die
3136 Zeitspanne, die der Apache auf drei Dinge wartet:</p>
3139 <li>Die gesamte Zeispanne, die benötigt wird, um eine GET-Anfrage
3142 <li>Die Zeitspanne zwischen dem Empfang von TCP-Paketen einer
3143 POST- oder PUT-Anfrage.</li>
3145 <li>Die Zeitspanne zwischen ACKs bei der Übermittlung der
3146 TCP-Pakete der Antwort.</li>
3149 <p>Wir haben vor, diese Zeitspannen in Zukunft separat konfigurierbar zu
3150 machen. Vor Version 1.2 war der Zeitgeber auf 1200 voreingestellt, wurde
3151 dann aber auf 300 herabgesetzt, was immer noch weit mehr ist, als in den
3152 meisten Situationen benötigt wird. Die Voreinstellung wurde nicht
3153 weiter herabgesetzt, da gelegentlich noch Stellen im Code existieren
3154 können, wo der Zeitgeber nicht zurückgesetzt wird, wenn ein
3155 Paket verschickt wird.</p>
3158 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
3159 <div class="directive-section"><h2><a name="UseCanonicalName" id="UseCanonicalName">UseCanonicalName</a>-<a name="usecanonicalname" id="usecanonicalname">Direktive</a></h2>
3160 <table class="directive">
3161 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Bestimmt, wie der Server seinen eigenen Namen und Port
3163 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>UseCanonicalName On|Off|DNS</code></td></tr>
3164 <tr><th><a href="directive-dict.html#Default">Voreinstellung:</a></th><td><code>UseCanonicalName Off</code></td></tr>
3165 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Serverkonfiguration, Virtual Host, Verzeichnis</td></tr>
3166 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
3167 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
3169 <p>In vielen Situationen muss der Apache eine
3170 <em>selbstreferenzierende</em> URL -- d.h. eine URL, die auf den selben
3171 Server zurück verweist -- zusammenbauen. Bei <code>UseCanonicalName
3172 On</code> verwendet der Apache den Hostnamen und Port, der in der
3173 <code class="directive"><a href="#servername">ServerName</a></code>-Anweisung angegeben ist,
3174 um den kanonischen Namen des Servers zu erstellen. Dieser Name wird in
3175 allen selbstreferenzierenden URLs sowie in CGI-Skripten für die
3176 Werte von <code>SERVER_NAME</code> und <code>SERVER_PORT</code>
3179 <p>Bei <code>UseCanonicalName Off</code> bildet der Apache
3180 selbstreferenzierende URLs, indem er den vom Client übermittelten
3181 Hostnamen und Port verwendet, sofern diese vorhanden sind (andernfalls
3182 wird der kanonische Name, wie oben beschrieben, benutzt). Die Werte
3183 sind die gleichen, die zur Anwendung von <a href="../vhosts/name-based.html">namensbasierten virtuellen Hosts</a>
3184 verwendet werden, und sie sind mit den gleichen Clients verfügbar
3185 <span class="transnote">(<em>Anm.d.Ü.:</em> , die auch in der Lage sind, auf namensbasierte virtuelle Hosts
3186 zuzugreifen, d.h. einen <code>Host</code>-Header mitschicken)</span>.
3187 Die CGI-Variablen <code>SERVER_NAME</code> und <code>SERVER_PORT</code>
3188 werden ebenfalls aus den vom Client angeboten Werten erstellt.</p>
3190 <p>Ein Intranet-Server, auf den Anwender mit kurzen Namen wie
3191 <code>www</code> zugreifen, ist ein Beispiel, wo dies sinnvoll sein kann.
3192 Sie werden bemerken, dass der Apache den Benutzer auf
3193 <code>http://www.domain.com/splat/</code> umleitet, wenn dieser einen
3194 Kurznamen und eine URL, die einem Verzeichnis entspricht, ohne
3195 abschließenden Schrägstrich eingibt, wie z.B.
3196 <code>http://www/splat</code>. Wenn Sie Authentisierung aktiviert haben,
3197 bewirkt dies, dass der Benutzer sich zweimal identifizieren muss
3198 (einmal für <code>www</code> und noch einmal für
3199 <code>www.domain.com</code> -- lesen Sie für weitere Informationen <a href="http://httpd.apache.org/docs/misc/FAQ.html#prompted-twice">die
3200 FAQ zu diesem Thema</a>). Wenn <code class="directive">UseCanonicalName</code>
3201 jedoch auf <code>Off</code> gesetzt ist, denn wird der Apache zu
3202 <code>http://www/splat/</code> umleiten.</p>
3204 <p>Es existiert noch eine dritte Option, <code>UseCanonicalName DNS</code>,
3205 die für den Betrieb von IP-basierten Massen-Virtual-Hosts gedacht ist,
3206 um antiquierte Clients zu unterstützen, die keinen
3207 <code>Host:</code>-Header bereit stellen. Um selbstreferenzierende
3208 URLs zu ermitteln, führt der Apache bei dieser Option ein
3209 Reverse-DNS-Lookup auf die IP-Adresse des Servers aus, zu der der Client
3210 Verbindung aufgenommen hat.</p>
3212 <div class="warning"><h3>Warnung</h3>
3213 <p>Wenn CGI-Skripte Vermutungen aufgrund des Wertes von
3214 <code>SERVER_NAME</code> anstellen, können sie durch diese
3215 Option fehlschlagen. Clients steht es im Wesentlichen frei, einen Wert
3216 für den Hostnamen anzugeben, wie er will. Wenn das
3217 CGI-Skript <code>SERVER_NAME</code> jedoch lediglich dazu verwendet,
3218 selbstreferenzierende URLs zu erstellen, sollte das gerade noch
3219 in Ordnung sein.</p>
3224 <li><code class="directive"><a href="#servername">ServerName</a></code></li>
3225 <li><code class="directive"><a href="../mod/mpm_common.html#listen">Listen</a></code></li>
3228 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
3229 <div class="directive-section"><h2><a name="VirtualHost" id="VirtualHost"><VirtualHost></a>-<a name="virtualhost" id="virtualhost">Direktive</a></h2>
3230 <table class="directive">
3231 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Enthält Direktiven, die nur auf bestimmte Hostnamen oder
3232 IP-Adressen angewendet werden</td></tr>
3233 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code><VirtualHost
3234 <var>Adresse</var>[:<var>Port</var>] [<var>Adresse</var>[:<var>Port</var>]]
3235 ...> ... </VirtualHost></code></td></tr>
3236 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Serverkonfiguration</td></tr>
3237 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
3238 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
3240 <p><code class="directive"><VirtualHost></code> und
3241 <code></VirtualHost></code> werden dazu verwendet, eine Gruppe
3242 von Direktiven zusammenzufassen, die nur auf einen bestimmten virtuellen
3243 Host angewendet werden. Jede Direktive, die im Virtual-Host-Kontext
3244 zulässig ist, kann verwendet werden. Wenn der Server eine Anfrage
3245 für ein bestimmtes Dokument eines bestimmten virtuellen Hosts
3246 empfängt, dann benutzt er die im
3247 <code class="directive"><VirtualHost></code>-Container enthaltenen
3248 Konfigurationsanweisungen. <var>Adresse</var> kann sein:</p>
3251 <li>Die IP-Adresse des virtuellen Hosts.</li>
3253 <li>Ein voll qualifizierter Domainname für die IP-Adresse des
3254 virtuellen Hosts.</li>
3256 <li>Das Zeichen <code>*</code>, welches nur in Kombination mit
3257 <code>NameVirtualHost *</code> verwendet wird, um allen IP-Adressen
3258 zu entsprechen.</li>
3260 <li>Die Zeichenkette <code>_default_</code>, die nur mit IP-basierten
3261 virtuellen Hosts verwendet wird, um nicht zugewiesene IP-Adressen
3265 <div class="example"><h3>Beispiel</h3><p><code>
3266 <VirtualHost 10.1.2.3><br />
3267 <span class="indent">
3268 ServerAdmin webmaster@host.foo.com<br />
3269 DocumentRoot /www/docs/host.foo.com<br />
3270 ServerName host.foo.com<br />
3271 ErrorLog logs/host.foo.com-error_log<br />
3272 TransferLog logs/host.foo.com-access_log<br />
3274 </VirtualHost>
3277 <p>IPv6-Adressen müssen in eckigen Klammern angegeben werden, da die
3278 optionale Portnummer sonst nicht erkannt werden kann. Hier ein
3281 <div class="example"><p><code>
3282 <VirtualHost [2001:db8::a00:20ff:fea7:ccea]><br />
3283 <span class="indent">
3284 ServerAdmin webmaster@host.example.com<br />
3285 DocumentRoot /www/docs/host.example.com<br />
3286 ServerName host.example.com<br />
3287 ErrorLog logs/host.example.com-error_log<br />
3288 TransferLog logs/host.example.com-access_log<br />
3290 </VirtualHost>
3293 <p>Jeder virtuelle Host muss einer anderen IP-Adresse, einem anderen Port
3294 oder einem anderen Hostnamen für den Server entsprechen. Im ersten
3295 Fall muss die Servermaschine so eingerichtet sein, dass sie IP-Pakete
3296 für mehrere Adressen akzeptiert. (Wenn der Rechner nicht mehrere
3297 Netzwerkkarten besitzt, kann dies mit dem Befehl <code>ifconfig
3298 alias</code> durchgeführt werden -- sofern Ihr Betriebssystem das
3301 <div class="note"><h3>Anmerkung</h3>
3302 <p>Die Verwendung von <code class="directive"><VirtualHost></code>
3303 beeinflusst <strong>nicht</strong>, an welchen Adressen der Apache
3304 lauscht. Sie müssen mit <code class="directive"><a href="../mod/mpm_common.html#listen">Listen</a></code> sicherstellen, dass der Apache
3305 an der richtigen Adresse lauscht.</p>
3308 <p>Bei der Verwendung IP-basierter virtuellen Hosts kann der spezielle
3309 Name <code>_default_</code> benutzt werden. In diesem Fall weist
3310 der Apache jede IP-Adresse diesem virtuellen Host zu, die nicht explizit in
3311 einem anderen virtuellen Host angegeben ist. Falls kein virtueller Host
3312 <code>_default_</code> angegeben ist, wird die "Hauptserver"-Konfiguration,
3313 die aus allen Definitionen außerhalb der Virtual-Host-Abschnitte
3314 besteht, für nicht passende IPs verwendet. (Beachten Sie jedoch,
3315 dass eine IP-Adressen die zu einer <code class="directive"><a href="#namevirtualhost">NameVirtualHost</a></code>-Anweisung passt, weder den
3316 "Hauptserver" noch den virtuellen Host <code>_default_</code> verwendet.
3317 Lesen Sie für weitere Details die Dokumentation zu <a href="../vhosts/name-based.html">namensbasierten virtuell Hosts</a>.)</p>
3319 <p>Sie können einen speziellen <code>:Port</code> angeben,
3320 um den entsprechenden Port zu wechseln. Falls nicht angegeben, wird
3321 er auf den gleichen Port voreingestellt, wie die letzte
3322 <code class="directive"><a href="../mod/mpm_common.html#listen">Listen</a></code>-Anweisung des
3323 Hauptservers. Sie können auch <code>:*</code> angeben, um alle
3324 Ports dieser Adresse zu akzeptieren. (Dies wird zusammen mit
3325 <code>_default_</code> empfohlen.)</p>
3327 <div class="warning"><h3>Sicherheit</h3>
3328 <p>Lesen Sie das Dokument <a href="../misc/security_tips.html">Sicherheitshinweise</a> für
3329 Details, warum Ihre Sicherheit gefährdet sein kann, wenn das
3330 Verzeichnis, in dem Protokolldateien gespeichert werden, für
3331 jemanden anderes als den Benutzer beschreibbar ist, der den Server
3337 <li><a href="../vhosts/">Apache-Dokumentation zu virtuellen
3339 <li><a href="../dns-caveats.html">Probleme bezüglich DNS und
3341 <li><a href="../bind.html">Bestimmen, welche Adressen und Ports
3342 der Apache verwendet</a></li>
3343 <li><a href="../sections.html">Wie die Abschnitte <Directory>,
3344 <Location> und <Files> arbeiten</a> für eine
3345 Erläuterung, wie diese verschiedenen Abschnitte miteinander
3346 kombiniert werden, wenn eine Anfrage empfangen wird</li>
3350 <div class="bottomlang">
3351 <p><span>Verfügbare Sprachen: </span><a href="../de/mod/core.html" title="Deutsch"> de </a> |
3352 <a href="../en/mod/core.html" hreflang="en" rel="alternate" title="English"> en </a> |
3353 <a href="../ja/mod/core.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a></p>
3354 </div><div id="footer">
3355 <p class="apache">Copyright 2008 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>
3356 <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>