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.1</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-project/">Dokumentation</a> > <a href="../">Version 2.1</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-isa</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-Zeichenkodierung für Antworten ohne
225 explizit angegebene Zeichenkodierung
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 den Namen der Zeichenkodierung an, die
235 jeder Antwort hinzugefügt wird, welche in den HTTP-Headern
236 keinen Parameter zum Content-Type enthält. Dies überschreibt
237 jede Zeichenkodierung, die mittels <code>META</code>-Tag im Dokument
238 angegeben ist. Die Angabe von <code>AddDefaultCharset Off</code>
239 deaktiviert die Funktion. <code>AddDefaultCharset On</code>
240 ermöglicht es, mit der Direktive die Apache-interne
241 Standard-Zeichenkodierung <code>iso-8859-1</code> vorzuschreiben.
242 Sie können auch angeben, dass eine andere
243 <var>Zeichenkodierung</var> verwendet werden soll. Zum Beispiel:</p>
245 <div class="example"><p><code>
246 AddDefaultCharset utf-8
250 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
251 <div class="directive-section"><h2><a name="AddOutputFilterByType" id="AddOutputFilterByType">AddOutputFilterByType</a>-<a name="addoutputfilterbytype" id="addoutputfilterbytype">Direktive</a></h2>
252 <table class="directive">
253 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>einen Ausgabefilter einem bestimmten MIME-Type
255 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>AddOutputFilterByType <var>Filter</var>[;<var>Filter</var>...]
256 <var>MIME-Type</var> [<var>MIME-Type</var>] ...</code></td></tr>
257 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Serverkonfiguration, Virtual Host, Verzeichnis, .htaccess</td></tr>
258 <tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>FileInfo</td></tr>
259 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
260 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
261 <tr><th><a href="directive-dict.html#Compatibility">Kompatibilität:</a></th><td>Verfügbar ab Apache 2.0.33</td></tr>
263 <p>Die Direktive aktiviert für eine Anfrage abhängig vom
264 MIME-Type der Antwort einen bestimmten Ausgabe-<a href="../filter.html">Filter</a>.</p>
266 <p>Das folgende Beispiel verwendet den Filter <code>DEFLATE</code>,
267 der von <code class="module"><a href="../mod/mod_deflate.html">mod_deflate</a></code> angeboten wird. Er komprimiert
268 jede Ausgabe, die als <code>text/html</code> oder <code>text/plain</code>
269 gekennzeichnet ist, (gleichgültig, ob statisch oder dynamisch)
270 bevor sie an den Client gesendet wird.</p>
272 <div class="example"><p><code>
273 AddOutputFilterByType DEFLATE text/html text/plain
276 <p>Wenn Sie den Inhalt von mehr als einem Filter verarbeiten lassen
277 wollen, dann müssen deren Namen durch Semikolons voneinander
278 getrennt werden. Es ist ebenfalls möglich, eine
279 <code class="directive">AddOutputFilterByType</code>-Direktive für
280 jeden von diesen Filtern zu verwenden.</p>
282 <p>Die folgende Konfiguration sorgt dafür, dass alle
283 Skriptausgaben, die als <code>text/html</code> gekennzeichnet
284 sind, zuerst vom <code>INCLUDES</code>-Filter und dann vom
285 <code>DEFLATE</code>-Filter verarbeitet werden.</p>
287 <div class="example"><p><code>
288 <Location /cgi-bin/><br />
289 <span class="indent">
290 Options Includes<br />
291 AddOutputFilterByType INCLUDES;DEFLATE text/html<br />
296 <div class="warning"><h3>Hinweis:</h3>
297 <p>Die Aktivierung von Filtern mittels
298 <code class="directive">AddOutputFilterByType</code> kann in einigen
299 Fällen ganz oder teilweise fehlschlagen. Beispielsweise
300 werden keine Filter angewendet, wenn der MIME-Type nicht bestimmt
301 werden kann und auf die Einstellung der <code class="directive"><a href="#defaulttype">DefaultType</a></code>-Anweisung zurückfällt,
302 selbst wenn die <code class="directive"><a href="#defaulttype">DefaultType</a></code>-Einstellung die gleiche ist.</p>
304 <p>Wenn Sie jedoch sicherstellen wollen, dass der Filter
305 angewendet wird, sollten Sie den Content-Type z.B. mit
306 <code class="directive"><a href="../mod/mod_mime.html#addtype">AddType</a></code> oder
307 <code class="directive"><a href="#forcetype">ForceType</a></code> der Ressource
308 explizit zuordnen. Das Setzen des Content-Types innerhalb
309 eines (nicht-nph) CGI-Skriptes funktioniert ebenfalls
312 <p>Die Typ-gebundenen Ausgabefilter werden niemals auf
313 Proxy-Anfragen angewendet.</p>
318 <li><code class="directive"><a href="../mod/mod_mime.html#addoutputfilter">AddOutputFilter</a></code></li>
319 <li><code class="directive"><a href="#setoutputfilter">SetOutputFilter</a></code></li>
320 <li><a href="../filter.html">Filter</a></li>
323 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
324 <div class="directive-section"><h2><a name="AllowEncodedSlashes" id="AllowEncodedSlashes">AllowEncodedSlashes</a>-<a name="allowencodedslashes" id="allowencodedslashes">Direktive</a></h2>
325 <table class="directive">
326 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Legt fest, ob kodierte Pfadtrennzeichen in URLs durchgereicht
327 werden dürfen</td></tr>
328 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>AllowEncodedSlashes On|Off</code></td></tr>
329 <tr><th><a href="directive-dict.html#Default">Voreinstellung:</a></th><td><code>AllowEncodedSlashes Off</code></td></tr>
330 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Serverkonfiguration, Virtual Host</td></tr>
331 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
332 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
333 <tr><th><a href="directive-dict.html#Compatibility">Kompatibilität:</a></th><td>Verfügbar ab Apache 2.0.46</td></tr>
335 <p>Die <code class="directive">AllowEncodedSlashes</code>-Direktive erlaubt die
336 Verwendung von URLs, welche kodierte Pfadtrennzeichen (<code>%2F</code>
337 für <code>/</code> und auf entsprechenden Systemen zusätzlich
338 <code>%5C</code> für <code>\</code>) enthalten. Normalerweise werden
339 derartige URLs mit einem 404-Fehler (Nicht gefunden) abgewiesen.</p>
341 <p><code class="directive">AllowEncodedSlashes</code> <code>On</code> ist
342 vor allem in Verbindung mit <code>PATH_INFO</code> hilfreich.</p>
344 <div class="note"><h3>Anmerkung</h3>
345 <p>Das Erlauben von Schrägstrichen impliziert <em>nicht</em> deren
346 <em>Dekodierung</em>. Vorkommen von <code>%2F</code> oder <code>%5C</code>
347 (<em>nur</em> auf entsprechenden Systemen) werden unverändert in der
348 ansonsten dekodierten URL belassen.</p>
353 <li><code class="directive"><a href="#acceptpathinfo">AcceptPathInfo</a></code></li>
356 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
357 <div class="directive-section"><h2><a name="AllowOverride" id="AllowOverride">AllowOverride</a>-<a name="allowoverride" id="allowoverride">Direktive</a></h2>
358 <table class="directive">
359 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Direktiven-Typen, die in .htaccess-Dateien
360 erlaubt sind.</td></tr>
361 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>AllowOverride All|None|<var>Direktiven-Typ</var>
362 [<var>Direktiven-Typ</var>] ...</code></td></tr>
363 <tr><th><a href="directive-dict.html#Default">Voreinstellung:</a></th><td><code>AllowOverride All</code></td></tr>
364 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Verzeichnis</td></tr>
365 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
366 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
368 <p>Wenn der Server eine <code>.htaccess</code>-Datei (wie durch
369 <code class="directive"><a href="#accessfilename">AccessFileName</a></code> definiert)
370 findet, muss er wissen, welche in der Datei angegebenen Direktiven
371 frühere Konfigurationsanweisungen überschreiben
374 <div class="note"><h3>Nur in <Directory>-Abschnitten verfügbar</h3>
375 <code class="directive">AllowOverride</code> ist nur in <code class="directive"><a href="#directory"><Directory></a></code>-Abschnitten
376 gültig, die ohne reguläre Ausdrüke definiert wurden, nicht
377 in <code class="directive"><a href="#location"><Location></a></code>-,
378 <code class="directive"><a href="#directorymatch"><DirectoryMatch></a></code>- oder
379 <code class="directive"><a href="#files"><Files></a></code>-Abschnitten.
382 <p>Wenn diese Anweisung auf <code>None</code> gesetzt wird, dann
383 werden <a href="#accessfilename">.htaccess</a>-Dateien komplett
384 ignoriert. In diesem Fall wird der Server nicht einmal versuchen,
385 die <code>.htaccess</code>-Dateien im Dateisystem zu lesen.</p>
387 <p>Wenn diese Anweisung auf <code>All</code> gesetzt wird, dann
388 ist jede Direktive in den <code>.htaccess</code>-Dateien erlaubt,
389 die den <a href="directive-dict.html#Context">Kontext</a>
390 .htaccess besitzt.</p>
392 <p>Der <var>Direktiven-Typ</var> kann eine der folgenden
393 Anweisungsgruppen sein.</p>
399 Erlaubt die Verwendung von Autorisierungs-Anweisungen (<code class="directive"><a href="../mod/mod_authn_dbm.html#authdbmgroupfile">AuthDBMGroupFile</a></code>,
400 <code class="directive"><a href="../mod/mod_authn_dbm.html#authdbmuserfile">AuthDBMUserFile</a></code>,
401 <code class="directive"><a href="../mod/mod_authz_groupfile.html#authgroupfile">AuthGroupFile</a></code>,
402 <code class="directive"><a href="#authname">AuthName</a></code>,
403 <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>
408 Erlaubt die Verwendung von Direktiven zur Steuerung der
409 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>,
410 <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
411 <code class="module"><a href="../mod/mod_mime.html">mod_mime</a></code>-Direktiven Add* und Remove*
417 Erlaubt die Verwendung von Direktiven zur Steuerung von
418 Verzeichnisindizes (<code class="directive"><a href="../mod/mod_autoindex.html#adddescription">AddDescription</a></code>,
419 <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>,
420 <code class="directive"><a href="../mod/mod_autoindex.html#addiconbytype">AddIconByType</a></code>,
421 <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>
427 Erlaubt die Verwendung von Direktiven zur Steuerung des
428 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>
430 <dt>Options[=<var>Option</var>,...]</dt>
433 Erlaubt die Verwendung von Direktiven zur Steuerung spezieller
434 Verzeichniseigenschaften (<code class="directive"><a href="#options">Options</a></code>
435 und <code class="directive"><a href="../mod/mod_include.html#xbithack">XBitHack</a></code>). Sie
436 können mit einem Gleichheitszeichen gefolgt von einer
437 kommaseparierten Liste (ohne Leerzeichen) angeben, welche Optionen mit
438 der <code class="directive"><a href="#options">Options</a></code>-Direktive gesetzt
444 <div class="example"><p><code>
445 AllowOverride AuthConfig Indexes
448 <p>Im obigen Beispiel erzeugen alle Direktiven einen internal server
449 error <span class="transnote">(<em>Anm.d.Ü.:</em> Server-interner Fehler)</span>, die weder der
450 Gruppe <code>AuthConfig</code> noch der Gruppe <code>Indexes</code>
455 <li><code class="directive"><a href="#accessfilename">AccessFileName</a></code></li>
456 <li><a href="../configuring.html">Konfigurationsdateien</a></li>
457 <li><a href="../howto/htaccess.html">.htaccess-Dateien</a></li>
460 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
461 <div class="directive-section"><h2><a name="AuthName" id="AuthName">AuthName</a>-<a name="authname" id="authname">Direktive</a></h2>
462 <table class="directive">
463 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Autorisierungsbereich zur Verwendung in der
464 HTTP-Authentisierung</td></tr>
465 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>AuthName <var>auth-Bereich</var></code></td></tr>
466 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Verzeichnis, .htaccess</td></tr>
467 <tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>AuthConfig</td></tr>
468 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
469 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
471 <p>Die Direktive legt den Namen des Autorisierungsbereiches
472 <span class="transnote">(<em>Anm.d.Ü.:</em> Der Autorisierungsbereich wird auch Realm genannt.)</span>
473 für ein Verzeichnis fest. Dieser Realm wird dem Client mitgeteilt,
474 damit der Anwender weiß, welchen Benutzernamen und welches Passwort
475 er zu übermitteln hat. <code class="directive">AuthName</code> akzeptiert ein
476 Argument. Falls der Name des Realm Leerzeichen enthält, muss er in
477 Anführungszeichen eingeschlossen werden. Um zu funktionieren, muss
478 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
479 Direktiven wie <code class="directive"><a href="../mod/mod_authn_file.html#authuserfile">AuthUserFile</a></code>
480 und <code class="directive"><a href="../mod/mod_authz_groupfile.html#authgroupfile">AuthGroupFile</a></code>
481 begleitet werden.</p>
485 <div class="example"><p><code>
486 AuthName "Top Secret"
489 <p>Die <code>AuthName</code> übergebene Zeichenkette ist das,
490 was in dem von den meisten Browsern angebotenen Passwort-Dialog
495 <li><a href="../howto/auth.html">Authentisierung, Autorisierung und
496 Zugriffskontrolle</a></li>
499 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
500 <div class="directive-section"><h2><a name="AuthType" id="AuthType">AuthType</a>-<a name="authtype" id="authtype">Direktive</a></h2>
501 <table class="directive">
502 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Art der Authentisierung</td></tr>
503 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>AuthType Basic|Digest</code></td></tr>
504 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Verzeichnis, .htaccess</td></tr>
505 <tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>AuthConfig</td></tr>
506 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
507 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
509 <p>Die Direktive wählt die Art der Benutzer-Authentisierung
510 für ein Verzeichnis aus. Derzeit sind lediglich <code>Basic</code>
511 und <code>Digest</code> implementiert.
512 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
513 Direktiven wie <code class="directive"><a href="../mod/mod_authn_file.html#authuserfile">AuthUserFile</a></code>
514 und <code class="directive"><a href="../mod/mod_authz_groupfile.html#authgroupfile">AuthGroupFile</a></code>
515 begleitet werden.</p>
519 <li><a href="../howto/auth.html">Authentisierung, Autorisierung und
520 Zugriffskontrolle</a></li>
523 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
524 <div class="directive-section"><h2><a name="CGIMapExtension" id="CGIMapExtension">CGIMapExtension</a>-<a name="cgimapextension" id="cgimapextension">Direktive</a></h2>
525 <table class="directive">
526 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Technik zur Bestimmung des Interpreters für
527 CGI-Skripte</td></tr>
528 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>CGIMapExtension <var>CGI-Pfad</var> <var>.Endung</var></code></td></tr>
529 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Verzeichnis, .htaccess</td></tr>
530 <tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>FileInfo</td></tr>
531 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
532 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
533 <tr><th><a href="directive-dict.html#Compatibility">Kompatibilität:</a></th><td>ausschließlich NetWare</td></tr>
535 <p>Die Direktive wird zur Steuerung verwendet, wie Apache
536 den Interpreter ermittelt, der zur Ausführung von
537 CGI-Skripten verwendet wird. Beispielsweise bestimmt die Angabe
538 von <code>CGIMapExtension sys:\foo.nlm .foo</code>, dass
539 alle CGI-Scripte mit der Endung <code>.foo</code> an den
540 FOO-Interpreter übergeben werden.</p>
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="ContentDigest" id="ContentDigest">ContentDigest</a>-<a name="contentdigest" id="contentdigest">Direktive</a></h2>
545 <table class="directive">
546 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Aktiviert die Generierung von Content-MD5
547 HTTP-Response-Headern</td></tr>
548 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>ContentDigest On|Off</code></td></tr>
549 <tr><th><a href="directive-dict.html#Default">Voreinstellung:</a></th><td><code>ContentDigest Off</code></td></tr>
550 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Serverkonfiguration, Virtual Host, Verzeichnis, .htaccess</td></tr>
551 <tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>Options</td></tr>
552 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
553 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
555 <p>Die Direktive aktiviert die Generierung von
556 <code>Content-MD5</code>-Headern, wie sie in RFC1864 bzw. RFC2068
559 <p>MD5 ist ein Algorithmus zur Berechnung eines "Datenextrakts"
560 (zuweilen "Fingerabdruck" genannt) <span class="transnote">(<em>Anm.d.Ü.:</em> Der "Datenextrakt" wird im
561 Englischen als "message digest" oder "fingerprint" bezeichnet.)</span>
562 aus beliebig langen Daten. Es gilt als zuverlässig, dass
563 Veränderungen an den Daten sich in Veränderungen des
564 Extrakts wiederspiegeln.</p>
566 <p>Der <code>Content-MD5</code>-Header bietet eine
567 End-to-End-Integritätsprüfung (MIC) <span class="transnote">(<em>Anm.d.Ü.:</em> MIC steht für
568 "message integrity check".)</span> des Daten-Inhalts. Ein Proxy oder
569 Client kann diesen Header prüfen, um zufällige Veränderungen
570 des Entity-Inhalts bei der Übertragung festzustellen.
573 <div class="example"><p><code>
574 Content-MD5: AuLb7Dp1rqtRtxz2m9kRpA==
577 <p>Beachten Sie bitte, dass dies Performanceprobleme auf Ihrem
578 System verursachen kann, da der Extrakt bei jeder Anfrage
579 berechnet wird (der Wert wird nicht zwischengespeichert).</p>
581 <p><code>Content-MD5</code> wird nur für Dokumente gesendet,
582 die von <code class="module"><a href="../mod/core.html">core</a></code> bedient werden, nicht jedoch bei
583 Modulen. SSI-Dokumente, CGI-Skript-Ausgaben und Byte-Range-Antworten
584 besitzen diesen Header beispielsweise nicht.</p>
587 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
588 <div class="directive-section"><h2><a name="DefaultType" id="DefaultType">DefaultType</a>-<a name="defaulttype" id="defaulttype">Direktive</a></h2>
589 <table class="directive">
590 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>MIME-Content-Type, der gesendet wird, wenn der Server den Typ
591 nicht auf andere Weise ermitteln kann.</td></tr>
592 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>DefaultType <var>MIME-Type</var></code></td></tr>
593 <tr><th><a href="directive-dict.html#Default">Voreinstellung:</a></th><td><code>DefaultType text/plain</code></td></tr>
594 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Serverkonfiguration, Virtual Host, Verzeichnis, .htaccess</td></tr>
595 <tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>FileInfo</td></tr>
596 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
597 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
599 <p>Es kann vorkommen, dass der Server ein Dokument ausliefern muss,
600 dessen Typ er nicht mit Hilfe seiner MIME-Type-Zuordnungen bestimmen
603 <p>Der Server muss den Client über den Content-Type des
604 Dokumentes informieren. Daher verwendet er im Falle eines
605 unbekannten Typs die <code>DefaultType</code>-Einstellung.
608 <div class="example"><p><code>
609 DefaultType image/gif
612 <p>wäre angemessen für ein Verzeichnis, das viele GIF-Bilder
613 enthält, deren Dateinamen nicht Endung <code>.gif</code>
616 <p>Beachten Sie bitte, dass die Direktive anders als <code class="directive"><a href="#forcetype">ForceType</a></code> lediglich den Standard-MIME-Type
617 bestimmt. Alle anderen MIME-Type-Definitionen, einschließlich
618 Dateierweiterungen, die den Medien-Typ anzeigen können,
619 überschreiben diese Voreinstellung.</p>
622 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
623 <div class="directive-section"><h2><a name="Directory" id="Directory"><Directory></a>-<a name="directory" id="directory">Direktive</a></h2>
624 <table class="directive">
625 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Umschließt eine Gruppe von Direktiven, die nur auf
626 das genannte Verzeichnis des Dateisystems und Unterverzeichnisse angewendet
628 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code><Directory <var>Verzeichnispfad</var>>
629 ... </Directory></code></td></tr>
630 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Serverkonfiguration, Virtual Host</td></tr>
631 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
632 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
634 <p><code class="directive"><Directory></code> und
635 <code></Directory></code> werden dazu verwendet, eine Gruppe
636 von Direktiven zusammenzufassen, die nur für das genannte
637 Verzeichnis und dessen Unterverzeichnisse gelten. Jede Direktive,
638 die im Verzeichnis-Kontext erlaubt ist, kann verwendet werden.
639 <var>Verzeichnispfad</var> ist entweder der vollständige Pfad zu
640 einem Verzeichnis oder eine Zeichenkette mit Platzhaltern wie sie von der
641 Unix-Shell zum Abgleich verwendet werden. In einer Zeichenkette
642 mit Platzhaltern <span class="transnote">(<em>Anm.d.Ü.:</em> sogenannte wild-cards)</span> entspricht
643 <code>?</code> einem einzelnen Zeichen und <code>*</code> einer
644 Zeichenkette beliebiger Länge. Sie können auch auch
645 <code>[]</code>-Zeichenbereiche verwenden. Keiner der Platzhalter
646 entspricht dem Zeichen "/". Daher passt <code><Directory
647 /*/public_html></code> nicht auf <code>/home/user/public_html</code>,
648 <code><Directory /home/*/public_html></code> jedoch tut es.
651 <div class="example"><p><code>
652 <Directory /usr/local/httpd/htdocs><br />
653 <span class="indent">
654 Options Indexes FollowSymLinks<br />
660 <p>Seien Sie vorsichtig mit den <var>Verzeichnispfad</var>-Argumenten.
661 Sie müssen buchstäblich mit dem Dateisystempfad
662 übereinstimmen, den der Apache für den Zugriff auf die
663 Dateien verwendet. Direktiven, die für ein bestimmtes
664 Verzeichnis gelten, gelten nicht für Dateien in dem Verzeichnis,
665 auf die über einen anderen Pfad zugegriffen wird, wie z.B.
666 über verschiedene symbolische Links.</p>
669 <p>Erweiterte reguläre Ausdrücke können ebenfalls
670 verwendet werden, indem das Zeichen <code>~</code> hinzugefügt
671 wird. Beispielsweise würde</p>
673 <div class="example"><p><code>
674 <Directory ~ "^/www/.*/[0-9]{3}">
677 <p>auf Verzeichnisse in <code>/www/</code> passen, die aus drei
680 <p>Wenn mehrere <code class="directive"><Directory></code>-Abschnitte
681 (ohne reguläre Ausdrücke) auf ein Verzeichnis (oder
682 ein ihm übergeordnetes Verzeichnis) passen, welches ein Dokument
683 enthält, dann werden die Direktiven der Reihe nach, angefangen
684 beim kürzesten passenden Muster, vermischt mit den Direktiven
685 aus den <a href="#accessfilename">.htaccess</a>-Dateien, angewendet.
688 <div class="example"><p><code>
689 <Directory /><br />
690 <span class="indent">
691 AllowOverride None<br />
693 </Directory><br />
695 <Directory /home/><br />
696 <span class="indent">
697 AllowOverride FileInfo<br />
702 <p>Beim Zugriff auf das Dokument <code>/home/web/dir/doc.html</code>
703 sind die einzelnen Schritte:</p>
706 <li>Wende die Direktive <code>AllowOverride None</code> an
707 (deaktiviere <code>.htaccess</code>-Dateien).</li>
709 <li>Wende die Direktive <code>AllowOverride FileInfo</code>
710 (auf das Verzeichnis <code>/home</code>) an.</li>
712 <li>Wende jede <code>FileInfo</code>-Direktive aus
713 <code>/home/.htaccess</code>, <code>/home/web/.htaccess</code> und
714 <code>/home/web/dir/.htaccess</code> der Reihe nach an.</li>
717 <p>Reguläre Ausdrücke werden solange nicht berücksichtigt,
718 bis alle normalen Abschnitte angewendet wurden. Anschließend
719 werden alle regulären Ausdrücke in der Reihenfolge
720 geprüft, in der sie in der Konfigurationsdatei auftauchen.
721 Beispielsweise wird bei</p>
723 <div class="example"><p><code>
724 <Directory ~ abc$><br />
725 <span class="indent">
726 # ... hier die Direktiven ...<br />
731 <p>der Abschnitt mit dem regulären Ausdruck nicht
732 berücksichtigt, bis alle normalen
733 <code class="directive"><Directory></code>-Abschnitte und
734 <code>.htaccess</code>-Dateien angewendet wurden. Dann erst wird
735 der reguläre Ausdruck mit <code>/home/abc/public_html/abc</code>
736 abgeglichen und der entsprechende <code class="directive"><Directory></code>-Abschnitt angewendet.</p>
738 <p><strong>Beachten Sie bitte, dass der vom Apache voreingestellte
739 Zugriff für <code><Directory /></code>
740 <code>Allow from All</code> ist. Das bedeutet, dass der Apache
741 jede Datei ausliefert, die durch eine URL abgebildet wird. Es wird
742 empfohlen, dass Sie dies durch einen Block wie</strong></p>
744 <div class="example"><p><code>
745 <Directory /><br />
746 <span class="indent">
747 Order Deny,Allow<br />
753 <p><strong>ändern und anschließend für
754 Verzeichnisse überschreiben, die Sie verfügbar machen
755 <em>wollen</em>. Für weitere Einzelheiten lesen Sie bitte
756 die Seite zu den <a href="../misc/security_tips.html">Sicherheitshinweisen</a>.</strong></p>
758 <p>Die Verzeichnisabschnitte erscheinen in der Datei
759 <code>httpd.conf</code>. <code class="directive"><Directory></code>-Direktiven dürfen nicht
760 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>
764 <li><a href="../sections.html">Wie die Abschnitte <Directory>,
765 <Location> und <Files> arbeiten</a> für eine
766 Erläuterung, wie diese verschiedenen Abschnitte miteinander
767 kombiniert werden, wenn eine Anfrage empfangen wird</li>
770 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
771 <div class="directive-section"><h2><a name="DirectoryMatch" id="DirectoryMatch"><DirectoryMatch></a>-<a name="directorymatch" id="directorymatch">Direktive</a></h2>
772 <table class="directive">
773 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Umschließt eine Gruppe von Direktiven, die auf
774 Verzeichnisse des Dateisystems und ihre Unterverzeichnisse abgebildet
775 werden, welche auf einen regulären Ausdruck passen</td></tr>
776 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code><DirectoryMatch <var>regex</var>>
777 ... </DirectoryMatch></code></td></tr>
778 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Serverkonfiguration, Virtual Host</td></tr>
779 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
780 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
782 <p><code class="directive"><DirectoryMatch></code> und
783 <code></DirectoryMatch></code> werden dazu verwendet, eine
784 Gruppe von Direktiven zusammenzufassen, die nur für das
785 genannte Verzeichnis und dessen Unterverzeichnisse gelten, genauso
786 wie bei <code class="directive"><a href="#directory"><Directory></a></code>.
787 Als Argument dient jedoch ein regulärer Ausdruck.
788 Beispielsweise würde</p>
790 <div class="example"><p><code>
791 <DirectoryMatch "^/www/.*/[0-9]{3}">
794 <p>auf Verzeichnisse in <code>/www/</code> passen, die aus drei
795 Zeichen bestehen.</p>
799 <li><code class="directive"><a href="#directory"><Directory></a></code>
800 für eine Beschreibung, wie reguläre Ausdrücke mit
801 normalen <code class="directive"><Directory></code>-Anweisungen
802 vermischt werden.</li>
803 <li><a href="../sections.html">Wie die Abschnitte <Directory>,
804 <Location> und <Files> arbeiten</a> für eine
805 Erläuterung, wie diese verschiedenen Abschnitte miteinander
806 kombiniert werden, wenn eine Anfrage empfangen wird</li>
809 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
810 <div class="directive-section"><h2><a name="DocumentRoot" id="DocumentRoot">DocumentRoot</a>-<a name="documentroot" id="documentroot">Direktive</a></h2>
811 <table class="directive">
812 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Verzeichnis, welches den Haupt-Dokumentenbaum bildet, der im
813 Web sichtbar ist.</td></tr>
814 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>DocumentRoot <var>Verzeichnis</var></code></td></tr>
815 <tr><th><a href="directive-dict.html#Default">Voreinstellung:</a></th><td><code>DocumentRoot /usr/local/apache/htdocs</code></td></tr>
816 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Serverkonfiguration, Virtual Host</td></tr>
817 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
818 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
820 <p>Die Direktive setzt das Verzeichnis, von dem aus
821 <code class="program"><a href="../programs/httpd.html">httpd</a></code> Dateien ausliefert. Sofern nicht eine Direktive
822 wie <code class="directive"><a href="../mod/mod_alias.html#alias">Alias</a></code> greift, hängt
823 der Server Pfade aus der angeforderten URL an das Wurzelverzeichnis
824 an, um den Pfad zum Dokument zu bilden. Beispiel:</p>
826 <div class="example"><p><code>
827 DocumentRoot /usr/web
830 <p>Damit bezieht sich ein Zugriff auf
831 <code>http://www.my.host.com/index.html</code> auf
832 <code>/usr/web/index.html</code>. Wenn das <var>Verzeichnis</var> nicht
833 absolut angegeben ist, wird es relativ zu <code class="directive"><a href="#serverroot">ServerRoot</a></code> betrachtet.</p>
835 <p><code class="directive">DocumentRoot</code> sollte ohne einen
836 Schrägstrich am Ende angegeben werden.</p>
840 <li><a href="../urlmapping.html">URLs auf das Dateisystem
844 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
845 <div class="directive-section"><h2><a name="EnableMMAP" id="EnableMMAP">EnableMMAP</a>-<a name="enablemmap" id="enablemmap">Direktive</a></h2>
846 <table class="directive">
847 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Verwende Memory-Mapping, um Dateien während der
848 Auslieferung zu lesen</td></tr>
849 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>EnableMMAP On|Off</code></td></tr>
850 <tr><th><a href="directive-dict.html#Default">Voreinstellung:</a></th><td><code>EnableMMAP On</code></td></tr>
851 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Serverkonfiguration, Virtual Host, Verzeichnis, .htaccess</td></tr>
852 <tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>FileInfo</td></tr>
853 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
854 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
856 <p>Die Direktive steuert, ob <code class="program"><a href="../programs/httpd.html">httpd</a></code> Memory-Mapping
857 verwenden darf, wenn er während der Auslieferung den Inhalt einer
858 Datei lesen muss. Wenn die Bearbeitung einer Anfrage es erfordert,
859 auf die Daten in einer Datei zuzugreifen -- zum Beispiel bei der
860 Auslieferung einer mittels <code class="module"><a href="../mod/mod_include.html">mod_include</a></code> serverseitig
861 analysierten Datei --, dann verwendet der Apache standardmäßig
862 Memory-Mapping für diese Datei, sofern das Betriebssystem es
865 <p>Memory-Mapping bedeutet zuweilen eine Performanceverbesserung.
866 In einigen Umgebungen ist es jedoch besser, Memory-Mapping zu
867 deaktivieren, um Problemen während des Betriebs vorzubeugen:</p>
870 <li>Bei einigen Multiprozessorsystemen kann Memory-Mapping die
871 Performance von <code class="program"><a href="../programs/httpd.html">httpd</a></code> reduzieren.</li>
872 <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
873 einem Speicherzugriffsfehler <span class="transnote">(<em>Anm.d.Ü.:</em> ein so genannter "segmentation
874 fault")</span> abstürzen, wenn eine Datei gelöscht oder
875 gekürzt wird, während <code class="program"><a href="../programs/httpd.html">httpd</a></code> sie im Speicher
879 <p>Bei Serverkonfigurationen, die für dieses Problem
880 anfällig sind, sollten Sie das Memory-Mapping für
881 auszuliefernde Dateien deaktivieren, indem Sie schreiben:</p>
883 <div class="example"><p><code>
887 <p>Bei per NFS eingebundenen Dateien kann diese Funktion
888 explizit für die störenden Dateien deaktiviert werden,
889 indem Sie angeben:</p>
891 <div class="example"><p><code>
892 <Directory "/pfad-zu-den-nfs-dateien">
893 <span class="indent">
900 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
901 <div class="directive-section"><h2><a name="EnableSendfile" id="EnableSendfile">EnableSendfile</a>-<a name="enablesendfile" id="enablesendfile">Direktive</a></h2>
902 <table class="directive">
903 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Verwende die sendfile-Unterstützung des Kernels, um
904 Dateien an den Client auszuliefern</td></tr>
905 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>EnableSendfile On|Off</code></td></tr>
906 <tr><th><a href="directive-dict.html#Default">Voreinstellung:</a></th><td><code>EnableSendfile On</code></td></tr>
907 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Serverkonfiguration, Virtual Host, Verzeichnis, .htaccess</td></tr>
908 <tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>FileInfo</td></tr>
909 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
910 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
911 <tr><th><a href="directive-dict.html#Compatibility">Kompatibilität:</a></th><td>Verfügbar ab Apache Version 2.0.44</td></tr>
913 <p>Die Direktive steuert, ob <code class="program"><a href="../programs/httpd.html">httpd</a></code> die
914 sendfile-Unterstützung des Kernels verwenden kann, um
915 Dateiinhalte an den Client zu übermitteln. Wenn die Bearbeitung
916 einer Anfrage keinen Zugriff auf die Daten in der Datei erfordert --
917 zum Beispiel bei der Auslieferung einer statischen Datei -- und das
918 Betriebssystem es unterstützt, verwendet der Apache
919 standardmäßig sendfile, um den Dateiinhalt zu
920 übertragen, ohne die Datei jemals zu lesen.</p>
922 <p>Der sendfile-Mechanismus vermeidet getrennte Lese- und
923 Sendeoperationen sowie Puffer-Zuweisungen. Bei einigen Plattformen bzw.
924 Dateisystemen deaktivieren Sie diese Funktion jedoch besser, um Probleme
925 während des Betriebs zu vermeiden:</p>
928 <li>Einige Plattformen besitzen u.U. eine fehlerhafte
929 sendfile-Unterstützung, die das Erstellungssystem nicht erkennt,
930 insbesondere wenn die Binärdateien auf einem anderen Rechner erstellt
931 und auf eine solche Maschine mit fehlerhafter sendfile-Unterstützung
932 übertragen wurden.</li>
933 <li>Bei einem über das Netzwerk eingebundenen <code class="directive"><a href="#documentroot">DocumentRoot</a></code> (z.B. NFS oder SMB) ist der
934 Kernel möglicherweise nicht in der Lage, die Netzwerkdatei
935 über seinen eigenen Cache zu bedienen.</li>
936 <li>Unter Linux löst die Verwendung von <code>sendfile</code>
937 in Verbindung mit bestimmten Netzwerkkarten und IPv6
938 TCP-Checksummenfehler aus.</li>
941 <p>Bei Serverkonfigurationen, die für dieses Problam
942 anfällig sind, sollten die diese Funktion deaktivieren, indem
945 <div class="example"><p><code>
949 <p>Bei per NFS oder SMB eingebundenen Dateien kann diese Funktion
950 explizit für die störenden Dateien deaktiviert werden, indem
953 <div class="example"><p><code>
954 <Directory "/pfad-zu-den-nfs-dateien">
955 <span class="indent">
962 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
963 <div class="directive-section"><h2><a name="ErrorDocument" id="ErrorDocument">ErrorDocument</a>-<a name="errordocument" id="errordocument">Direktive</a></h2>
964 <table class="directive">
965 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Das, was der Server im Fehlerfall an den Client
967 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>ErrorDocument <var>Fehlercode</var> <var>Dokument</var></code></td></tr>
968 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Serverkonfiguration, Virtual Host, Verzeichnis, .htaccess</td></tr>
969 <tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>FileInfo</td></tr>
970 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
971 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
972 <tr><th><a href="directive-dict.html#Compatibility">Kompatibilität:</a></th><td>Die Syntax der Anführungszeichen bei Textnachrichten hat
973 sich im Apache 2.0 geändert</td></tr>
975 <p>Im Falle eines Problems oder Fehlers kann der Apache
976 konfiguriert werden, eine der vier Aktionen auszuführen:</p>
979 <li>Ausgabe einer einfachen, hartkodierten Fehlermeldung</li>
981 <li>Ausgabe einer angepassten Meldung</li>
983 <li>Umleitung zu einem lokalen <var>URL-Pfad</var> der das
984 Problem bzw. den Fehler behandelt</li>
986 <li>Umleitung zu einer externen <var>URL</var>, die das Problem
987 bzw. den Fehler behandelt</li>
990 <p>Die erste Option ist Voreinstellung, während die Optionen
991 2 bis 4 über die Direktive <code class="directive">ErrorDocument</code>
992 eingestellt werden, welcher der HTTP-Statuscode und eine
993 URL oder Nachricht folgen. Abhängig vom Problem bzw. Fehler bietet
994 der Apache manchmal zusätzliche Informationen an.</p>
996 <p>URLs können bei lokalen Adressen mit einem Schrägstrich
997 (/) beginnen oder eine komplette URL bilden, die der Client
998 auflösen kann. Alternativ kann eine Nachricht für die
999 Anzeige im Browser angeboten werden. Beispiel:</p>
1001 <div class="example"><p><code>
1002 ErrorDocument 500 http://foo.example.com/cgi-bin/tester<br />
1003 ErrorDocument 404 /cgi-bin/falsche_urls.pl<br />
1004 ErrorDocument 401 /info_zur_anmeldung.html<br />
1005 ErrorDocument 403 "Der Zugriff ist nicht erlaubt."
1008 <p>Außerdem kann der spezielle Wert <code>default</code> angegeben
1009 werden, um die schlichte, hartkodierte Nachricht des Apache zu verwenden.
1010 Es wird normalerweise nicht benötigt, doch <code>default</code>
1011 stellt die einfach, im Apache hartkodierte Meldung in Konfigurationen
1012 wieder her, die ansonsten von einem existierenden <span class="transnote">(<em>Anm.d.Ü.:</em> zuvor
1013 konfigurierten)</span> <code class="directive">ErrorDocument</code> erben
1016 <div class="example"><p><code>
1017 ErrorDocument 404 /cgi-bin/bad_urls.pl<br /><br />
1018 <Directory /web/docs><br />
1019 <span class="indent">
1020 ErrorDocument 404 default<br />
1025 <p>Wenn Sie eine <code class="directive">ErrorDocument</code>-Anweisung
1026 angeben, die auf eine entfernte URL weist (d.h. irgendetwas mit der
1027 Methode <code>http</code> davor), beachten Sie bitte, dass der Apache
1028 eine Umleitung zum Client sendet, um diesem mitzuteilen, wo das
1029 Dokument zu finden ist, auch wenn das Dokument letztlich wieder zum
1030 gleichen Server führt. Das hat mehrere Auswirkungen. Die
1031 wichtigste ist, dass der Client nicht den Original-Statuscode
1032 erhält sondern statt dessen einen Umleitungs-Statuscode. Dies
1033 wiederum kann Web-Robots und andere Clients verwirren, die den
1034 Statuscode dazu verwenden, herauszufinden ob eine URL gültig ist.
1035 Wenn Sie eine entfernte URL in einer Anweisung
1036 <code>ErrorDocument 401</code> verwenden, wird der Client
1037 darüber hinaus nicht wissen, dass er den Benutzer zur Eingabe
1038 eines Passwortes auffordern muss, da er den Statuscode 401 nicht
1039 erhält. <strong>Deshalb müssen Sie sich auf ein lokales
1040 Dokument beziehen, wenn Sie eine Anweisung <code>ErrorDocument
1041 401</code> verwenden.</strong></p>
1043 <p>Der Microsoft Internet Explorer (MSIE) ignoriert
1044 standardmäßig serverseitig generierte Fehlermeldungen, wenn
1045 sie "zu kurz" sind und ersetzt sie durch eigene "freundliche"
1046 Fehlermeldungen. Die Größe variiert abhängig von der
1047 Art des Fehlers, im Allgemeinen zeigt der MSIE jedoch den
1048 serverseitig generierten Fehler, anstatt ihn zu verstecken, wenn Ihr
1049 Fehlerdokument größer als 512 Bytes ist. Weitere Informationen
1050 sind im Artikel <a href="http://support.microsoft.com/default.aspx?scid=kb;en-us;Q294807">Q294807</a> in der Microsoft Knowledgebase article verfügbar.</p>
1052 <p>In Versionen vor 2.0 wurden Meldungen durch ein einzelnes
1053 vorangestelltes Anführungszeichen (") erkannt.</p>
1057 <li><a href="../custom-error.html">Dokumentation zu individuellen
1058 Fehlermeldungen</a></li>
1061 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
1062 <div class="directive-section"><h2><a name="ErrorLog" id="ErrorLog">ErrorLog</a>-<a name="errorlog" id="errorlog">Direktive</a></h2>
1063 <table class="directive">
1064 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Ablageort, an dem der Server Fehler protokolliert</td></tr>
1065 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code> ErrorLog <var>Dateiname</var>|syslog[:<var>facility</var>]</code></td></tr>
1066 <tr><th><a href="directive-dict.html#Default">Voreinstellung:</a></th><td><code>ErrorLog logs/error_log (Unix) ErrorLog logs/error.log (Windows and
1067 OS/2)</code></td></tr>
1068 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Serverkonfiguration, Virtual Host</td></tr>
1069 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
1070 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
1072 <p>Die Direktive <code class="directive">ErrorLog</code> bestimmt den Namen
1073 der Datei, in welcher der Server alle auftretenden Fehler protokolliert.
1074 Wenn <var>Dateiname</var> nicht absolut ist, wird er relativ zu <code class="directive"><a href="#serverroot">ServerRoot</a></code> betrachtet.</p>
1076 <div class="example"><h3>Beispiel</h3><p><code>
1077 ErrorLog /var/log/httpd/error_log
1080 <p>Wenn der <var>Dateiname</var> mit einem senkrechten Strich (|,
1081 engl.: Pipe) beginnt, wird angenommen, dass es sich um einen Befehl
1082 handelt, der ausgeführt wird, um das Fehlerprotokolls zu
1085 <div class="example"><h3>Beispiel</h3><p><code>
1086 ErrorLog "|/usr/local/bin/httpd_errors"
1089 <p>Die Verwendung von <code>syslog</code> anstelle eines Dateinamens
1090 aktiviert die Protokollierung mittels syslogd(8), sofern das System
1091 es unterstützt. Als Voreinstellung wird der syslog-Typ (syslog
1092 facility) <code>local7</code> verwendet, Sie können dies jedoch
1093 auch überschreiben, indem Sie die Syntax
1094 <code>syslog:<var>facility</var></code> verwenden, wobei
1095 <var>facility</var> einer der Namen sein kann, die üblicherweise
1096 in syslog(1) dokumentiert sind.</p>
1098 <div class="example"><h3>Beispiel</h3><p><code>
1099 ErrorLog syslog:user
1102 <p>SICHERHEITSHINWEIS: Lesen Sie das Dokument <a href="../misc/security_tips.html#serverroot">Sicherheitshinweise</a>
1103 zu Einzelheiten darüber, warum Ihre Sicherheit gefährdet
1104 sein kann, wenn das Verzeichnis, in dem die Log-Dateien gespeichert
1105 werden, für jemand anderen, als den Benutzer, der den Server
1106 gestartet hat, beschreibbar ist.</p>
1108 <div class="warning"><h3>Anmerkung</h3>
1109 <p>Bei der Eingabe eines Dateipfads auf nicht-Unix-Plattformen sollte
1110 darauf geachtet werden, nur (Vorwärts-)Schrägstriche zu
1111 verwenden, auch wenn die Plattform rückwärts gerichtete
1112 Schrägstriche (Backslashes) erlaubt. Im Allgemeinen ist es eine gute
1113 Idee, innerhalb der Konfigurationsdateien immer
1114 Vorwärts-Schrägstriche zu verwenden.</p>
1119 <li><code class="directive"><a href="#loglevel">LogLevel</a></code></li>
1120 <li><a href="../logs.html">Apache-Log-Dateien</a></li>
1123 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
1124 <div class="directive-section"><h2><a name="FileETag" id="FileETag">FileETag</a>-<a name="fileetag" id="fileetag">Direktive</a></h2>
1125 <table class="directive">
1126 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Dateiattribute, die zur Erstellung des HTTP-Response-Headers
1127 ETag verwendet werden</td></tr>
1128 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>FileETag <var>Komponente</var> ...</code></td></tr>
1129 <tr><th><a href="directive-dict.html#Default">Voreinstellung:</a></th><td><code>FileETag INode MTime Size</code></td></tr>
1130 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Serverkonfiguration, Virtual Host, Verzeichnis, .htaccess</td></tr>
1131 <tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>FileInfo</td></tr>
1132 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
1133 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
1135 <p>Wenn dem Dokument eine Datei zugrundeliegt, bestimmt die Direktive
1136 <code class="directive">FileETag</code> die Dateiattribute, die zur Erstellung
1137 des HTTP-Response-Headers <code>ETag</code> (Entity-Tag) verwendet
1138 werden. (Der Wert von <code>ETag</code> wird bei der Cache-Verwaltung
1139 zur Einsparung von Netzwerk-Bandbreite benutzt.) Im Apache 1.3.22 und
1140 früher wurde der <code>ETag</code>-Wert <em>stets</em> aus
1141 der I-Node, der Größe und dem Datum der letzten
1142 Änderung (mtime) der Datei gebildet. Die Direktive
1143 <code class="directive">FileETag</code> erlaubt es Ihnen, zu bestimmen,
1144 welche dieser Eigenschaften -- falls überhaupt -- verwendet
1145 werden sollen. Die gültigen Schlüsselworte lauten:</p>
1148 <dt><strong>INode</strong></dt>
1149 <dd>Die I-Node-Nummer wird in die Berechnung mit einbezogen</dd>
1150 <dt><strong>MTime</strong></dt>
1151 <dd>Datum und Uhrzeit der letzten Änderung werden mit einbezogen</dd>
1152 <dt><strong>Size</strong></dt>
1153 <dd>Die Anzahl der Bytes in der Datei wird mit einbezogen</dd>
1154 <dt><strong>All</strong></dt>
1155 <dd>Alle verfügbaren Angaben werden verwendet. Die ist
1156 gleichbedeutend mit:
1157 <div class="example"><p><code>FileETag INode MTime Size</code></p></div></dd>
1158 <dt><strong>None</strong></dt>
1159 <dd>Es wird keine <code>ETag</code>-Angabe in die Antwort eingefügt,
1160 wenn dem Dokument eine Datei zugrundeliegt.</dd>
1163 <p>Den Schlüsselwörtern <code>INode</code>, <code>MTime</code>
1164 und <code>Size</code> kann entweder ein <code>+</code> oder ein
1165 <code>-</code> vorangestellt werden, was die Änderung einer
1166 Vorgabe erlaubt, die von einem größeren Umfeld
1167 geerbt wurde. Jedes Schlüselwort ohne ein solches Prefix
1168 hebt die ererbte Einstellung sofort und vollständig auf.</p>
1170 <p>Wenn die Konfiguration für ein Verzeichnis
1171 <code>FileETag INode MTime Size</code> enthält
1172 und die eines Unterverzeichnisses <code>FileETag -INode</code>,
1173 dann ist die Einstellung für das Unterverzeichnis (die an
1174 jedes Unter-Unterverzeichnis weitervererbt wird, welches dies nicht
1175 überschreibt) äquivalent mit
1176 <code>FileETag MTime Size</code>.</p>
1179 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
1180 <div class="directive-section"><h2><a name="Files" id="Files"><Files></a>-<a name="files" id="files">Direktive</a></h2>
1181 <table class="directive">
1182 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Enthält Direktiven, die sich nur auf passende Dateinamen
1184 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code><Files <var>Dateiname</var>> ... </Files></code></td></tr>
1185 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Serverkonfiguration, Virtual Host, Verzeichnis, .htaccess</td></tr>
1186 <tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>All</td></tr>
1187 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
1188 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
1190 <p>Die Direktive <code class="directive"><Files></code>
1191 begrenzt die Reichweite der enthaltenen Anweisungen auf Dateinamen.
1192 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
1193 passende <code></Files></code>-Anweisung besitzen.
1194 Die innerhalb dieses Abschnittes angegebenen Direktiven werden auf
1195 jedes Objekt mit einem Basisnamen (letzte Komponente des Dateinamens)
1196 angewendet, der auf die angegebenen Dateinamen passt. <code class="directive"><Files></code>-Container werden, nachdem die
1197 <code class="directive"><a href="#directory"><Directory></a></code>-Container
1198 und <code>.htaccess</code>-Dateien gelesen sind, jedoch vor den
1199 <code class="directive"><a href="#location"><Location></a></code>-Containern,
1200 in der Reihenfolge ihres Auftretens ausgeführt. Beachten Sie, dass
1201 <code class="directive"><Files></code>-Anweisungen innerhalb von
1202 <code class="directive"><a href="#directory"><Directory></a></code>-Containern
1203 auftreten können, um den Teil des Dateisystems einzuschränken,
1204 den sie betreffen.</p>
1206 <p>Das Argument <var>Dateiname</var> kann einen Dateinamen oder eine
1207 Zeichenkette mit Platzhaltern enthalten, wobei <code>?</code> auf ein
1208 einzelnes Zeichen passt und <code>*</code> auf eine beliebige Folge von
1209 Zeichen. Erweiterte reguläre Ausdrücke können ebenfalls
1210 verwendet werden, indem das Zeichen <code>~</code> hinzugefügt wird.
1211 Beispielsweise würde</p>
1213 <div class="example"><p><code>
1214 <Files ~ "\.(gif|jpe?g|png)$">
1217 <p>auf die gebräuchlichsten Grafikformate im Internet passen.
1218 <code class="directive"><a href="#filesmatch"><FilesMatch></a></code> wird
1219 jedoch bevorzugt.</p>
1221 <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
1222 von <code>.htaccess</code>-Dateien verwendet werden können.
1223 Dies erlaubt den Anwendern auf Dateiebene die Kontrolle über ihre
1224 eigenen Dateien.</p>
1228 <li><a href="../sections.html">Wie die Abschnitte <Directory>,
1229 <Location> und <Files> arbeiten</a> für eine
1230 Erläuterung, wie diese verschiedenen Abschnitte miteinander
1231 kombiniert werden, wenn eine Anfrage empfangen wird</li>
1234 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
1235 <div class="directive-section"><h2><a name="FilesMatch" id="FilesMatch"><FilesMatch></a>-<a name="filesmatch" id="filesmatch">Direktive</a></h2>
1236 <table class="directive">
1237 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Enthält Direktiven, die für Dateinamen gelten, die
1238 auf einen regulären Ausdruck passen</td></tr>
1239 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code><FilesMatch <var>regex</var>> ... </FilesMatch></code></td></tr>
1240 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Serverkonfiguration, Virtual Host, Verzeichnis, .htaccess</td></tr>
1241 <tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>All</td></tr>
1242 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
1243 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
1245 <p>Die Direktive <code class="directive"><FilesMatch></code>
1246 begrenzt wie die Direktive <code class="directive"><a href="#files"><Files></a></code> die enthaltenen Anweisungen auf
1247 Dateinamen. Sie akzeptiert jedoch reguläre Ausdrücke.
1248 Beispielsweise würde</p>
1250 <div class="example"><p><code>
1251 <FilesMatch "\.(gif|jpe?g|png)$">
1254 <p>auf die gebräuchlichsten Grafikformate im Internet passen.</p>
1258 <li><a href="../sections.html">Wie die Abschnitte <Directory>,
1259 <Location> und <Files> arbeiten</a> für eine
1260 Erläuterung, wie diese verschiedenen Abschnitte miteinander
1261 kombiniert werden, wenn eine Anfrage empfangen wird</li>
1264 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
1265 <div class="directive-section"><h2><a name="ForceType" id="ForceType">ForceType</a>-<a name="forcetype" id="forcetype">Direktive</a></h2>
1266 <table class="directive">
1267 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Erzwingt die Auslieferung aller passendenden Dateien mit dem
1268 angegebenen MIME-Content-Type</td></tr>
1269 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>ForceType <var>MIME-Type</var>|None</code></td></tr>
1270 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Verzeichnis, .htaccess</td></tr>
1271 <tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>FileInfo</td></tr>
1272 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
1273 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
1274 <tr><th><a href="directive-dict.html#Compatibility">Kompatibilität:</a></th><td>Wurde im Apache 2.0 in den Core verschoben</td></tr>
1276 <p>Wenn sie innerhalb einer <code>.htaccess</code>-Datei, eines
1277 <code class="directive"><a href="#directory"><Directory></a></code>-,
1278 <code class="directive"><a href="#location"><Location></a></code>-
1279 <code class="directive"><a href="#files"><Files></a></code>-Containers
1280 angegeben wird, erzwingt die Direktive die Auslieferung aller
1281 entsprechenden Dateien mit dem Content-Type, der durch
1282 <var>MIME-Type</var> definiert wurde. Wenn Sie zum Beispiel ein
1283 Verzeichnis voller GIF-Dateien haben, die Sie nicht alle durch
1284 <code>.gif</code> kennzeichnen wollen, können Sie angeben:</p>
1286 <div class="example"><p><code>
1290 <p>Beachten Sie bitte, dass die Direktive anders als <code class="directive"><a href="#defaulttype">DefaultType</a></code> alle MIME-Type-Zuordnungen
1291 überschreibt, einschließlich Dateiendungen, die einen
1292 Medientyp bezeichnen könnten.</p>
1294 <p>Sie können jede <code class="directive">ForceType</code>-Angabe
1295 durch die Verwendung des Wertes <code>None</code> überschreiben:</p>
1297 <div class="example"><p><code>
1298 # erzwinge image/gif für alle Dateien:<br />
1299 <Location /images><br />
1300 <span class="indent">
1301 ForceType image/gif<br />
1303 </Location><br />
1305 # hier jedoch normale MIME-Type-Zuordnungen:<br />
1306 <Location /images/mixed><br />
1307 <span class="indent">
1308 ForceType None<br />
1314 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
1315 <div class="directive-section"><h2><a name="HostnameLookups" id="HostnameLookups">HostnameLookups</a>-<a name="hostnamelookups" id="hostnamelookups">Direktive</a></h2>
1316 <table class="directive">
1317 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Aktiviert DNS-Lookups auf Client-IP-Adressen</td></tr>
1318 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>HostnameLookups On|Off|Double</code></td></tr>
1319 <tr><th><a href="directive-dict.html#Default">Voreinstellung:</a></th><td><code>HostnameLookups Off</code></td></tr>
1320 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Serverkonfiguration, Virtual Host, Verzeichnis</td></tr>
1321 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
1322 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
1324 <p>Diese Direktive aktiviert die DNS-Abfrage <span class="transnote">(<em>Anm.d.Ü.:</em> ein sogenannter
1325 DNS-Lookup)</span>, so dass Hostnamen protokolliert (und in
1326 <code>REMOTE_HOST</code> an CGIs/SSIs übergeben) werden könnnen.
1327 Der Wert <code>Double</code> bezieht sich auf ein
1328 Double-Reverse-DNS-Lookup. D.h. nachdem ein Reverse-Lookup
1329 durchgeführt wurde, wird dann auf dem Ergebnis ein
1330 Forward-Lookup ausgeführt. Wenigstens eine der IP-Adressen
1331 aus dem Forward-Lookup muss der Originaladresse entsprechen.
1332 (In der "tcpwrappers"-Terminologie wird dies <code>PARANOID</code>
1335 <p>Unabhängig von der Einstellung wird ein Double-Reverse-Lookup
1336 durchgeführt, wenn <code class="module"><a href="../mod/mod_authz_host.html">mod_authz_host</a></code> zur
1337 Zugriffskontrolle per Hostnamen eingesetzt wird. Dies ist aus
1338 Sicherheitsgründen notwendig. Beachten Sie, dass das Ergebnis dieses
1339 Double-Reverse-Lookups nicht generell verfügbar ist, solange Sie
1340 nicht <code>HostnameLookups Double</code> setzen. Wenn beispielsweise
1341 nur <code>HostnameLookups On</code> angegeben ist und eine Anfrage
1342 für ein Objekt erfolgt, welches durch Hostnamen-Beschränkungen
1343 geschützt ist, dann wird CGIs nur das Ergebnis des
1344 Singel-Reverse-Lookups in <code>REMOTE_HOST</code> übergeben,
1345 egal ob das Doble-Reverse-Lookup fehlschlug oder nicht.</p>
1347 <p>Die Voreinstellung ist <code>Off</code>, um Netzwerktraffic bei den
1348 Angeboten einzusparen, die nicht tatsächlich Reverse-Lookups
1349 benötigen. Es ist auch für die Endanwender besser, da sie nicht
1350 die zusätzliche Wartezeit ertragen müssen, die ein Lookup mit
1351 sich bringt. Hoch frequentierte Angebote sollten diese Direktive auf
1352 <code>Off</code>lassen. Das Hilfsprogramm <code class="program"><a href="../programs/logresolve.html">logresolve</a></code>, das standardmäßig in das
1353 Unterverzeichnis <code>bin</code> Ihres Installationsverzeichnisses
1354 kompiliert wird, kann dazu verwendet werden, um offline Hostnamen von
1355 protokollierten IP-Adressen nachzuschlagen.</p>
1358 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
1359 <div class="directive-section"><h2><a name="IfDefine" id="IfDefine"><IfDefine></a>-<a name="ifdefine" id="ifdefine">Direktive</a></h2>
1360 <table class="directive">
1361 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Schließt Direktiven ein, die nur ausgeführt werden,
1362 wenn eine Testbedingung beim Start wahr ist</td></tr>
1363 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code><IfDefine [!]<var>Parametername</var>> ...
1364 </IfDefine></code></td></tr>
1365 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Serverkonfiguration, Virtual Host, Verzeichnis, .htaccess</td></tr>
1366 <tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>All</td></tr>
1367 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
1368 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
1370 <p>Der Container <code><IfDefine <var>Test</var>>...</IfDefine>
1371 </code> wird dazu verwendet, Direktiven als bedingt zu kennzeichnen.
1372 Die Direktiven innerhalb eines <code class="directive"><IfDefine></code>-Abschnittes werden nur ausgeführt,
1373 wenn <var>Test</var> wahr ist. Ist <var>Test</var> falsch, wird alles
1374 zwischen der Start- und Endemarkierung ignoriert.</p>
1376 <p>In der <code class="directive"><IfDefine></code>-Anweisung kann
1377 <var>Test</var> eine von zwei Formen annehmen:</p>
1380 <li><var>Parametername</var></li>
1382 <li><code>!</code><var>Parametername</var></li>
1385 <p>Im ersten Fall werden die Direktiven zwischen der Start- und
1386 Endemarkierung nur ausgeführt, wenn der Parameter namens
1387 <var>Parametername</var> definiert ist. Die zweite Form kehrt den
1388 Test um und führt die Direktiven nur dann aus, wenn
1389 <var>Parametername</var> <strong>nicht</strong> definiert ist.</p>
1391 <p>Das Argument <var>Parametername</var> ist ein sogenanntes
1392 "Define", das beim beim Start des Servers in der
1393 <code class="program"><a href="../programs/httpd.html">httpd</a></code>-Befehlszeile durch
1394 <code>-D<var>Parameter</var></code> angegeben wird.</p>
1396 <p><code class="directive"><IfDefine></code>-Container können
1397 ineinander verschachtelt werden, um einfache Multi-Parameter-Tests
1398 zu implementieren. Beispiel:</p>
1400 <div class="example"><p><code>
1401 httpd -DReverseProxy ...<br />
1404 <IfDefine ReverseProxy><br />
1405 <span class="indent">
1406 LoadModule rewrite_module modules/mod_rewrite.so<br />
1407 LoadModule proxy_module modules/libproxy.so<br />
1413 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
1414 <div class="directive-section"><h2><a name="IfModule" id="IfModule"><IfModule></a>-<a name="ifmodule" id="ifmodule">Direktive</a></h2>
1415 <table class="directive">
1416 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Schließt Direktiven ein, die abhängig vom
1417 Vorhandensein oder Fehlen eines speziellen Moduls ausgeführt
1419 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code><IfModule [!]<var>Modulname</var>|<var>Modulbezeichner</var>>
1420 ... </IfModule></code></td></tr>
1421 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Serverkonfiguration, Virtual Host, Verzeichnis, .htaccess</td></tr>
1422 <tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>All</td></tr>
1423 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
1424 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
1425 <tr><th><a href="directive-dict.html#Compatibility">Kompatibilität:</a></th><td>Modulbezeichner sind ab Version 2.1
1426 verfügbar.</td></tr>
1428 <p>Der Container <code><IfModule
1429 <var>Test</var>>...</IfModule></code> wird dazu verwendet,
1430 Direktiven als abhängig von dem Vorhandensein eines speziellen
1431 Moduls zu kennzeichnen. Die Direktiven innerhalb eines <code class="directive"><IfModule></code>-Abschnitts werden nur
1432 ausgeführt, wenn <var>Test</var> wahr ist. Ist <var>Test</var>
1433 falsch, wird alles zwischen der Start- und Endemarkierung ignoriert.</p>
1435 <p>In der <code class="directive"><IfModule></code>-Anweisung
1436 kann <var>Test</var> eine von zwei Formen annehmen:</p>
1439 <li><var>Modul</var></li>
1441 <li><code>!</code><var>Modul</var></li>
1444 <p>Im ersten Fall werden die Direktiven zwischen der Start- und
1445 Endemarkierung nur ausgeführt, das Modul namens
1446 <var>Modul</var> im Apache enthalten ist -- entweder einkompiliert
1447 oder mittels <code class="directive"><a href="../mod/mod_so.html#loadmodule">LoadModule</a></code>
1448 dynamisch geladen. Die zweite Form dreht den Test um und führt die
1449 Direktiven nur aus, wenn <var>Modul</var> <strong>nicht</strong>
1452 <p>Das Argument <var>Modul</var> kann entweder der Modulbezeichner oder
1453 der Dateiname des Moduls zum Zeitpunkt seiner Kompilierung sein.
1454 <code>rewrite_module</code> beispielsweise ist der Bezeichner und
1455 <code>mod_rewrite.c</code> ist der Dateiname. Wenn ein Modul aus mehreren
1456 Quelltext-Dateien besteht, verwenden Sie den Namen der Datei, welche die
1457 Zeichenfolge <code>STANDARD20_MODULE_STUFF</code> enthält.</p>
1459 <p><code class="directive"><IfModule></code>-Container können
1460 inneinander verschachtelt werden, um einfache Multi-Modul-Tests
1463 <p>Dieser Container sollte verwendet werden, wenn Sie eine
1464 Konfigurationsdatei benötigen, die unabhängig davon funktioniert,
1465 ob ein bestimmtes Modul verfügbar ist oder nicht. Normalerweise
1466 ist es nicht notwendig, Direktiven in <code class="directive"><IfModule></code>-Containern unterzubringen.</p>
1469 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
1470 <div class="directive-section"><h2><a name="Include" id="Include">Include</a>-<a name="include" id="include">Direktive</a></h2>
1471 <table class="directive">
1472 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Fügt andere Konfigurationsdateien innerhalb der
1473 Server-Konfigurationsdatei ein</td></tr>
1474 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>Include <var>Dateiname</var>|<var>Verzeichnis</var></code></td></tr>
1475 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Serverkonfiguration, Virtual Host, Verzeichnis</td></tr>
1476 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
1477 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
1478 <tr><th><a href="directive-dict.html#Compatibility">Kompatibilität:</a></th><td>Die Platzhalter-Suche ist verfügbar seit
1481 <p>Die Direktive erlaubt das Einfügen anderer Konfigurationsdateien
1482 in die Konfigurationsdatei des Servers.</p>
1484 <p>Shell-typische (<code>fnmatch()</code>) Platzhlaterzeichen können
1485 dazu verwendet werden, mehrere Dateien auf einmal in alphabetischer
1486 Reihenfolge einzufügen. Wenn <code class="directive">Include</code>
1487 darüber hinaus auf ein Verzeichnis anstatt auf eine Datei zeigt,
1488 liest der Apache alle Dateien in diesem Verzeichnis und allen
1489 Unterverzeichnissen ein. Das Einfügen ganzer Verzeichnisse ist
1490 jedoch nicht empfehlenswert, da temporäre Dateien sehr leicht
1491 versehentlich in einem Verzeichnis zurückgelassen werden, was
1492 <code class="program"><a href="../programs/httpd.html">httpd</a></code> scheitern lassen kann.</p>
1494 <p>Der angegebene Dateiname kann ein absoluter Pfad sein oder relativ zum
1495 <code class="directive"><a href="#serverroot">ServerRoot</a></code>-Verzeichnis angegeben
1500 <div class="example"><p><code>
1501 Include /usr/local/apache2/conf/ssl.conf<br />
1502 Include /usr/local/apache2/conf/vhosts/*.conf
1505 <p>Oder Sie geben Pfade relativ zu Ihrem <code class="directive"><a href="#serverroot">ServerRoot</a></code>-Verzeichnis an:</p>
1507 <div class="example"><p><code>
1508 Include conf/ssl.conf<br />
1509 Include conf/vhosts/*.conf
1512 <p>Der Aufruf von <code>apachectl configtest</code> liefert eine Liste
1513 der Dateien, die während des Konfigurations-Tests verarbeitet
1516 <div class="example"><p><code>
1517 root@host# apachectl configtest<br />
1518 Processing config file: /usr/local/apache2/conf/ssl.conf<br />
1519 Processing config file: /usr/local/apache2/conf/vhosts/vhost1.conf<br />
1520 Processing config file: /usr/local/apache2/conf/vhosts/vhost2.conf<br />
1526 <li><code class="program"><a href="../programs/apachectl.html">apachectl</a></code></li>
1529 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
1530 <div class="directive-section"><h2><a name="KeepAlive" id="KeepAlive">KeepAlive</a>-<a name="keepalive" id="keepalive">Direktive</a></h2>
1531 <table class="directive">
1532 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Aktiviert persistente HTTP-Verbindungen</td></tr>
1533 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>KeepAlive On|Off</code></td></tr>
1534 <tr><th><a href="directive-dict.html#Default">Voreinstellung:</a></th><td><code>KeepAlive On</code></td></tr>
1535 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Serverkonfiguration, Virtual Host</td></tr>
1536 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
1537 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
1539 <p>Die Keep-Alive-Erweiterung von HTTP/1.0 und die
1540 HTTP/1.1-Funktionalität persistenter Verbindungen unterstützt
1541 langlebige HTTP-Sitzungen, die es erlauben, mehrere Anfragen über
1542 die gleich TCP-Verbindung zu senden. In einigen Fällen wurde eine
1543 Beschleunigung der Wartezeiten von beinahe 50% für HTML-Dokumente
1544 mit vielen Bildern festgestellt. Um Keep-Alive-Verbindungen zu aktivieren,
1545 setzen Sie <code>KeepAlive On</code>.</p>
1547 <p>Bei HTTP/1.0-Clients werden Keep-Alive-Verbindungen nur dann verwendet,
1548 wenn sie vom Client eigens angefordert werden. Desweiteren können
1549 Keep-Alive-Verbindungen bei einem HTTP/1.0-Client nur dann verwendet
1550 werden, wenn die Länge des Inhalts im Voraus bekannt ist. Dies
1551 impliziert, dass dynamische Inhalte wie CGI-Ausgaben, SSI-Seiten und
1552 servergenerierte Verzeichnisauflistungen im Allgemeinen keine
1553 Keep-Alive-Verbindungen mit HTTP/1.0-Clients verwenden. Bei
1554 HTTP/1.1-Clients sind Keep-Alive-Verbindungen Voreinstellung, solange
1555 nichts anderes angegeben ist. Wenn der Client es anfordert, wird
1556 Chunked-Encoding verwendet, um Inhalte mit unbekannter Länge
1557 über persistente Verbindungen zu senden.</p>
1561 <li><code class="directive"><a href="#maxkeepaliverequests">MaxKeepAliveRequests</a></code></li>
1564 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
1565 <div class="directive-section"><h2><a name="KeepAliveTimeout" id="KeepAliveTimeout">KeepAliveTimeout</a>-<a name="keepalivetimeout" id="keepalivetimeout">Direktive</a></h2>
1566 <table class="directive">
1567 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Zeitspanne, die der Server während persistenter Verbindungen
1568 auf nachfolgende Anfragen wartet</td></tr>
1569 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>KeepAliveTimeout <var>Sekunden</var></code></td></tr>
1570 <tr><th><a href="directive-dict.html#Default">Voreinstellung:</a></th><td><code>KeepAliveTimeout 15</code></td></tr>
1571 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Serverkonfiguration, Virtual Host</td></tr>
1572 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
1573 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
1575 <p>Dies legt die Anzahl der Sekunden fest, die der Apache auf weitere
1576 Anfragen wartet, bevor er die Verbindung schließt. Nachdem einmal
1577 eine Anfrage entgegen genommen wurde, wird die durch die Direktive
1578 <code class="directive"><a href="#timeout">Timeout</a></code> festgelegte Auszeit
1581 <p>Auf stark belasteten Servern kann ein hoher
1582 <code class="directive">KeepAliveTimeout</code>-Wert zu Durchsatzminderungen
1583 führen. Je höher die Auszeit angegeben ist, desto länger
1584 ist der Apache damit beschäftigt, auf untätige Clients zu
1588 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
1589 <div class="directive-section"><h2><a name="Limit" id="Limit"><Limit></a>-<a name="limit" id="limit">Direktive</a></h2>
1590 <table class="directive">
1591 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Beschränkt die eingeschlossenen Zugriffskontrollen auf
1592 bestimmte HTTP-Methoden</td></tr>
1593 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code><Limit <var>Methode</var> [<var>Methode</var>] ... > ...
1594 </Limit></code></td></tr>
1595 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Serverkonfiguration, Virtual Host, Verzeichnis, .htaccess</td></tr>
1596 <tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>All</td></tr>
1597 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
1598 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
1600 <p>Zugriffskontrollen gelten normalerweise für <strong>alle</strong>
1601 Zugriffsmethoden, was normalerweise auch das gewünschte Verhalten ist.
1602 <strong>Im Allgemeinen sollten Zugriffskontrollen nicht in einen
1603 <code class="directive"><Limit></code>-Container gepackt
1604 werden.</strong></p>
1606 <p>Der Sinn der Direktive <code class="directive"><Limit></code>
1607 ist es, den Effekt der Zugriffskontrollen auf die angegebenen
1608 HTTP-Methoden zu beschränken. Bei allen anderen Methoden haben
1609 die in der <code class="directive"><Limit></code>-Gruppe
1610 enthaltenen Zugriffsbeschränkungen <strong>keine Wirkung</strong>.
1611 Im folgenden Beispiel gilt die Zugriffskontrolle nur für die
1612 Methoden <code>POST</code>, <code>PUT</code> und <code>DELETE</code>.
1613 Alle anderen Methoden bleiben ungeschützt:</p>
1615 <div class="example"><p><code>
1616 <Limit POST PUT DELETE><br />
1617 <span class="indent">
1618 Require valid-user<br />
1623 <p>Sie können eine oder mehrere der folgenden Methoden angeben:
1624 <code>GET</code>, <code>POST</code>, <code>PUT</code>, <code>DELETE</code>,
1625 <code>CONNECT</code>, <code>OPTIONS</code>,
1626 <code>PATCH</code>, <code>PROPFIND</code>, <code>PROPPATCH</code>,
1627 <code>MKCOL</code>, <code>COPY</code>, <code>MOVE</code>,
1628 <code>LOCK</code> und <code>UNLOCK</code>. <strong>Die Methodennamen
1629 unterscheiden zwischen Groß- und Kleinschreibung.</strong> Wenn
1630 <code>GET</code> verwendet wird, sind <code>HEAD</code>-Anfragen
1631 ebenfalls eingeschränkt. Die <code>TRACE</code>-Methode kann nicht
1632 limitiert werden.</p>
1634 <div class="warning">
1635 Wenn es um Zugriffsbeschränkungen geht, sollte
1636 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
1637 werden, da <code class="directive"><a href="#limitexcept"><LimitExcept></a></code>
1638 einen Schutz gegen beliebige Methoden bietet.
1642 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
1643 <div class="directive-section"><h2><a name="LimitExcept" id="LimitExcept"><LimitExcept></a>-<a name="limitexcept" id="limitexcept">Direktive</a></h2>
1644 <table class="directive">
1645 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Beschränkt Zugriffskontrollen auf alle HTTP-Methoden
1646 außer den genannten</td></tr>
1647 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code><LimitExcept <var>Methode</var> [<var>Methode</var>] ... > ...
1648 </LimitExcept></code></td></tr>
1649 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Serverkonfiguration, Virtual Host, Verzeichnis, .htaccess</td></tr>
1650 <tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>All</td></tr>
1651 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
1652 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
1654 <p><code class="directive"><LimitExcept></code> und
1655 <code></LimitExcept></code> werden dazu verwendet, eine Gruppe
1656 von Anweisungen zur Zugriffskontrolle zusammenzufassen, die dann auf
1657 jede HTTP-Methode angewendet werden, die <strong>nicht</strong>
1658 als Argument angegeben ist. D.h. dies ist das Gegenteil des
1659 <code class="directive"><a href="#limit"><Limit></a></code>-Containers
1660 und kann zur Steuerung von Standard- und nicht-Standard-/unbekannten
1661 Methoden verwendet werden. Für weitere Einzelheiten lesen Sie bitte
1662 die Beschreibung zu <code class="directive"><a href="#limit"><Limit></a></code>.</p>
1666 <div class="example"><p><code>
1667 <LimitExcept POST GET><br />
1668 <span class="indent">
1669 Require valid-user<br />
1671 </LimitExcept>
1676 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
1677 <div class="directive-section"><h2><a name="LimitInternalRecursion" id="LimitInternalRecursion">LimitInternalRecursion</a>-<a name="limitinternalrecursion" id="limitinternalrecursion">Direktive</a></h2>
1678 <table class="directive">
1679 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Bestimmt die maximale Anzahl interner Umleitungen und
1680 verschachtelter Unteranfragen</td></tr>
1681 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>LimitInternalRecursion <var>Zahl</var> [<var>Zahl</var>]</code></td></tr>
1682 <tr><th><a href="directive-dict.html#Default">Voreinstellung:</a></th><td><code>LimitInternalRecursion 10</code></td></tr>
1683 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Serverkonfiguration, Virtual Host</td></tr>
1684 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
1685 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
1686 <tr><th><a href="directive-dict.html#Compatibility">Kompatibilität:</a></th><td>Verfügbar ab Apache 2.0.47</td></tr>
1688 <p>Eine interne Umleitung erfolgt beispielsweise, wenn die Direktive
1689 <code class="directive"><a href="../mod/mod_actions.html#action">Action</a></code> verwendet wird, welche
1690 die Originalanfrage intern zu einem CGI-Skript weiterleitet. Eine
1691 Unteranfrage <span class="transnote">(<em>Anm.d.Ü.:</em> engl. Subrequest)</span> ist ein Mechanismus des
1692 Apache, um herauszufinden, was bei einer URI geschehen würde, wäre
1693 sie angefordert worden. <code class="module"><a href="../mod/mod_dir.html">mod_dir</a></code> z.B. verwendet
1694 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
1697 <p><code class="directive">LimitInternalRecursion</code> bewahrt den Server vor
1698 einem Absturz, wenn er in eine Endlosschleife aus internen Umleitungen
1699 oder Unteranfragen hineinläuft. Derartige Schleifen werden
1700 gewöhnlich durch Fehlkonfiguration verursacht.</p>
1702 <p>Die Direktive setzt zwei verschiedene Begrenzungen, welche je Anfrage
1703 ausgewertet werden. Die erste <var>Zahl</var> bestimmt die maximale
1704 Anzahl der Umleitungen, die aufeinander folgen dürfen. Die zweite
1705 <var>Zahl</var> legt fest, wie tief Unteranfragen ineinander
1706 verschachtelt werden dürfen. Wenn Sie lediglich eine <var>Zahl</var>
1707 angeben, wird sie beiden Begrenzungen zugewiesen.</p>
1709 <div class="example"><h3>Beispiel</h3><p><code>
1710 LimitInternalRecursion 5
1714 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
1715 <div class="directive-section"><h2><a name="LimitRequestBody" id="LimitRequestBody">LimitRequestBody</a>-<a name="limitrequestbody" id="limitrequestbody">Direktive</a></h2>
1716 <table class="directive">
1717 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Begrenzt die Gesamtgröße des vom Client gesendeten
1718 HTTP-Request-Body</td></tr>
1719 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>LimitRequestBody <var>Bytes</var></code></td></tr>
1720 <tr><th><a href="directive-dict.html#Default">Voreinstellung:</a></th><td><code>LimitRequestBody 0</code></td></tr>
1721 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Serverkonfiguration, Virtual Host, Verzeichnis, .htaccess</td></tr>
1722 <tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>All</td></tr>
1723 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
1724 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
1726 <p>Die Direktive gibt die Anzahl der <var>Bytes</var> zwischen 0
1727 (unbegrenzt) und 2147483647 (2GB) an, die im Request-Body (Datenteil der
1728 Anfrage) erlaubt sind.</p>
1730 <p>Die Direktive <code class="directive">LimitRequestBody</code> erlaubt es dem
1731 Benutzer, die Größe des HTTP-Request-Bodys in dem Kontext zu
1732 begrenzen, in dem die Anweisung angegeben ist (Server, pro Verzeichnis,
1733 pro Datei oder pro Adresse). Wenn die Anfrage des Clients dieses Limit
1734 überschreitet, gibt der Server einen Fehler zurück anstatt die
1735 Anfrage zu bearbeiten. Die Größe des Datenteils einer Anfrage
1736 kann sehr stark variieren, abhängig von der Art der Ressource und
1737 den für diese Ressource erlaubten Methoden. CGI-Skripte verwenden
1738 den Datenteil üblicherweise zum Empfang von Formulardaten. Wird
1739 die <code>PUT</code>-Methode angewendet, dann muss der Wert mindestens
1740 so groß sein wie irgendeine Darstellungsform, die der Server
1741 für diese Ressource akzeptieren soll.</p>
1743 <p>Die Direktive gibt dem Serveradministrator eine größere
1744 Kontrolle gegenüber abnormalem Verhalten von Clients, was bei der
1745 Vermeidung einiger Formen von Denial-of-Service-Attacken hilfreich
1748 <p>Wenn Sie beispielsweise das Hochladen von Dateien zu einer bestimmten
1749 Adresse erlauben, aber die Größe der hochgeladenen Dateien
1750 auf 100K beschränken wollen, können Sie die folgende Anweisung
1753 <div class="example"><p><code>
1754 LimitRequestBody 102400
1759 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
1760 <div class="directive-section"><h2><a name="LimitRequestFields" id="LimitRequestFields">LimitRequestFields</a>-<a name="limitrequestfields" id="limitrequestfields">Direktive</a></h2>
1761 <table class="directive">
1762 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Begrenzt die Anzahl der HTTP-Request-Header, die vom Client
1763 entgegengenommen werden</td></tr>
1764 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>LimitRequestFields <var>Anzahl</var></code></td></tr>
1765 <tr><th><a href="directive-dict.html#Default">Voreinstellung:</a></th><td><code>LimitRequestFields 100</code></td></tr>
1766 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Serverkonfiguration</td></tr>
1767 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
1768 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
1770 <p><var>Anzahl</var> ist ein Integer-Wert (eine positive Ganzzahl)
1771 zwischen 0 (unbegrenzt) und 32767. Die Voreinstellung wird durch die
1772 Konstante <code>DEFAULT_LIMIT_REQUEST_FIELDS</code> (<code>100</code>
1773 bei der Auslieferung) zur Kompilierungszeit gesetzt.</p>
1775 <p>Die Direktive <code class="directive">LimitRequestFields</code> erlaubt es
1776 dem Serveradministrator, die maximale Anzahl der in einem HTTP-Request
1777 erlaubten HTTP-Request-Header zu verändern. Für den Server
1778 muss dieser Wert größer sein als die Anzahl der Headerzeilen,
1779 die ein normaler Client senden könnte. Die Anzahl der Request-Header,
1780 die ein gewöhnlicher Client verwendet, überschreitet selten 20
1781 Zeilen. Allerdings kann dies zwischen den verschiedenen
1782 Client-Ausführungen variieren, oft abhängig vom Ausmaß,
1783 mit dem der Anwender die genaue Content-Negotiation-Unterstützung
1784 seines Browsers konfiguriert hat. Optionale HTTP-Erweiterungen
1785 äußern sich oft in Form von HTTP-Headern.</p>
1787 <p>Die Direktive gibt dem Serveradministrator eine größere
1788 Kontrolle gegenüber abnormalem Verhalten von Clients, was bei der
1789 Vermeidung einiger Formen von Denial-of-Service-Attacken hilfreich
1790 sein kann. Der Wert sollte erhöht werden, wenn normale Clients
1791 eine Fehlermeldung vom Server erhalten, die besagt, dass mit der Anfrage
1792 zu viele Headerzeilen gesendet wurden.</p>
1796 <div class="example"><p><code>
1797 LimitRequestFields 50
1802 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
1803 <div class="directive-section"><h2><a name="LimitRequestFieldSize" id="LimitRequestFieldSize">LimitRequestFieldSize</a>-<a name="limitrequestfieldsize" id="limitrequestfieldsize">Direktive</a></h2>
1804 <table class="directive">
1805 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Begrenzt die Länge des vom Client gesendeten
1806 HTTP-Request-Headers</td></tr>
1807 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>LimitRequestFieldsize <var>Bytes</var></code></td></tr>
1808 <tr><th><a href="directive-dict.html#Default">Voreinstellung:</a></th><td><code>LimitRequestFieldsize 8190</code></td></tr>
1809 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Serverkonfiguration</td></tr>
1810 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
1811 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
1813 <p>Die Direktive gibt die Anzahl der <var>Bytes</var> zwischen 0
1814 und dem Wert der zur Kompilierungszeit definierten Konstante
1815 <code>DEFAULT_LIMIT_REQUEST_FIELDSIZE</code> (<code>8190</code> bei
1816 der Auslieferung) an, die in einem HTTP-Header erlaubt sind.</p>
1818 <p>Die Direktive <code class="directive">LimitRequestFieldsize</code> erlaubt es
1819 dem Serveradministrator, die maximale Größe eines
1820 HTTP-Request-Headers auf einen Wert unterhalb der normalen, im Server
1821 einkompilierten Größe des Eingabepuffers zu verringern.
1822 Für den Server muss der Wert groß genug sein, um eine beliebige
1823 Headerzeile einer normalen Client-Anfrage vorzuhalten. Die
1824 Größe variiert stark zwischen den verschiedenen
1825 Client-Ausführungen, oft abhängig vom Ausmaß, mit dem
1826 der Anwender die genaue Content-Negotiation-Unterstützung seines
1827 Browsers konfiguriert hat.</p>
1829 <p>Die Direktive gibt dem Serveradministrator eine größere
1830 Kontrolle gegenüber abnormalem Verhalten von Clients, was bei der
1831 Vermeidung einiger Formen von Denial-of-Service-Attacken hilfreich
1836 <div class="example"><p><code>
1837 LimitRequestFieldSize 4094
1840 <div class="note">Unter normalen Umständen sollte die Voreinstellung nicht
1841 verändert werden.</div>
1844 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
1845 <div class="directive-section"><h2><a name="LimitRequestLine" id="LimitRequestLine">LimitRequestLine</a>-<a name="limitrequestline" id="limitrequestline">Direktive</a></h2>
1846 <table class="directive">
1847 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Begrenzt die Länge der vom Client entgegengenommenen
1848 HTTP-Anfragezeile</td></tr>
1849 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>LimitRequestLine <var>Bytes</var></code></td></tr>
1850 <tr><th><a href="directive-dict.html#Default">Voreinstellung:</a></th><td><code>LimitRequestLine 8190</code></td></tr>
1851 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Serverkonfiguration</td></tr>
1852 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
1853 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
1855 <p>Die Direktive legt die Anzahl der <var>Bytes</var> zwischen 0 und
1856 dem Wert der zur Kompilierungszeit definierten Konstante
1857 <code>DEFAULT_LIMIT_REQUEST_LINE</code> (<code>8190</code> bei der
1858 Auslieferung) fest, die in der HTTP-Anfragezeile erlaubt sind.</p>
1860 <p>Die Direktive <code class="directive">LimitRequestLine</code> erlaubt es dem
1861 Serveradministrator, die maximale Größe der
1862 HTTP-Anfragezeile auf einen Wert unterhalb der normalen, im Server
1863 einkompilierten Größe des Eingabepuffers zu verringern. Da
1864 die Anfragezeile aus der HTTP-Methode, der URI und der Protokollversion
1865 besteht, bedeutet die <code class="directive">LimitRequestLine</code>-Direktive
1866 eine Beschränkung der Länge der für eine Anfrage an den
1867 Server erlaubten Anfrage-URI. Für den Server muss der Wert groß
1868 genug sein, um jeden seiner Ressourcennamen vorzuhalten,
1869 einschließlich aller Informationen, die im Query-String einer
1870 <code>GET</code>-Anfrage übergeben werden können.</p>
1872 <p>Die Direktive gibt dem Serveradministrator eine größere
1873 Kontrolle gegenüber abnormalem Verhalten von Clients, was bei der
1874 Vermeidung einiger Formen von Denial-of-Service-Attacken hilfreich
1879 <div class="example"><p><code>
1880 LimitRequestLine 4094
1883 <div class="note">Unter normalen Umständen sollte die Voreinstellung nicht
1884 verändert werden.</div>
1887 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
1888 <div class="directive-section"><h2><a name="LimitXMLRequestBody" id="LimitXMLRequestBody">LimitXMLRequestBody</a>-<a name="limitxmlrequestbody" id="limitxmlrequestbody">Direktive</a></h2>
1889 <table class="directive">
1890 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Begrenzt die Größe eines XML-basierten
1891 Request-Bodys</td></tr>
1892 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>LimitXMLRequestBody <var>Bytes</var></code></td></tr>
1893 <tr><th><a href="directive-dict.html#Default">Voreinstellung:</a></th><td><code>LimitXMLRequestBody 1000000</code></td></tr>
1894 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Serverkonfiguration, Virtual Host, Verzeichnis, .htaccess</td></tr>
1895 <tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>All</td></tr>
1896 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
1897 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
1899 <p>Dies gibt die Grenze für die maximale Größe (in Bytes)
1900 des XML-basierten Request-Bodys an. Der Wert <code>0</code> deaktiviert
1905 <div class="example"><p><code>
1906 LimitXMLRequestBody 0
1911 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
1912 <div class="directive-section"><h2><a name="Location" id="Location"><Location></a>-<a name="location" id="location">Direktive</a></h2>
1913 <table class="directive">
1914 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Wendet die enthaltenen Direktiven nur auf die entsprechenden
1916 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code><Location
1917 <var>URL-Pfad</var>|<var>URL</var>> ... </Location></code></td></tr>
1918 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Serverkonfiguration, Virtual Host</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>Die Direktive <code class="directive"><Location></code>
1923 begrenzt die Reichweite der enthaltenen Anweisungen auf URLs.
1924 Sie ist der Direktive <code class="directive"><a href="#directory"><Directory></a></code> ähnlich und startet einen
1925 Abschnitt, der mit der Anweisung <code></Location></code>
1926 abgeschlossen wird. <code class="directive"><Location></code>-Container werden, nachdem die
1927 <code class="directive"><a href="#directory"><Directory></a></code>-Container
1928 und <code>.htaccess</code>-Dateien gelesen wurden, und nach den
1929 <code class="directive"><a href="#files"><Files></a></code>-Containern, in
1930 der Reihenfolge ausgeführt, in der sie in der Konfigurationsdatei
1933 <p><code class="directive"><Location></code>-Abschnitte operieren
1934 vollständig außerhalb des Dateisystems. Dies hat mehrere
1935 Konsequenzen. An Wichtigsten, <code class="directive"><Location></code>-Anweisungen sollten nicht dafür
1936 verwendet werden, den Zugriff zu Teilen des Dateisystems zu steuern. Da
1937 mehrere unterschiedliche URLs auf die gleiche Stelle des Dateisystems
1938 zeigen können, könnte eine solche Zugriffskontrolle u.U.
1939 umgangen werden.</p>
1941 <div class="note"><h3>Wann sollte<code class="directive"><Location></code> verwendet werden</h3>
1943 <p>Verwenden Sie <code class="directive"><Location></code>, um
1944 Anweisungen auf Inhalte anzuwenden, die außerhalb des Dateisystems
1945 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
1946 innerhalb des Dateisystems abgelegt sind. Eine Ausnahme bildet
1947 <code><Location /></code>, welches ein einfacher Weg ist, um eine
1948 Konfiguration auf den gesamten Server anzuwenden.</p>
1951 <p>Für alle nicht-Proxy-Anfragen ist die entsprechende URL
1952 ein URL-Pfad in der Form <code>/path/</code>. Es dürfen weder ein
1953 Schema, noch ein Hostname, noch ein Port, noch ein Query-String einbezogen
1954 werden. Für Proxy-Anfragen hat die Vergleichs-URL die Form
1955 <code>schema://servername/path</code>. Das Präfix muss angegeben
1958 <p>Die URL kann Platzhalter verwenden. In einer Zeichenfolge mit
1959 Platzhaltern entspricht <code>?</code> einem einzelnen Zeichen und
1960 <code>*</code>einer beliebigen Zeichenfolge.</p>
1962 <p>Erweiterte reguläre Ausdrücke können ebenfalls
1963 verwendet werden, indem das Zeichen <code>~</code> hinzugefügt
1964 wird. Beispielsweise würde</p>
1966 <div class="example"><p><code>
1967 <Location ~ "/(extra|special)/data">
1970 <p>auf URLs passen, welche die Zeichenfolge <code>/extra/data</code>
1971 oder <code>/special/data</code> enthalten. Die Direktive <code class="directive"><a href="#locationmatch"><LocationMatch></a></code> verhält sich
1972 genauso wie <code class="directive"><Location></code> mit
1973 regulären Ausdrücken.</p>
1975 <p>Die Funktionalität von <code class="directive"><Location></code> ist insbesondere dann nützlich,
1976 wenn sie mit der <code class="directive"><a href="#sethandler">SetHandler</a></code>-Direktive
1977 kombiniert wird. Um zum Beispiel Statusabfragen zu aktivieren, sie aber
1978 nur von Browsern aus <code>foo.com</code> zuzulassen, könnten Sie
1981 <div class="example"><p><code>
1982 <Location /status><br />
1983 <span class="indent">
1984 SetHandler server-status<br />
1985 Order Deny,Allow<br />
1987 Allow from .foo.com<br />
1992 <div class="note"><h3>Anmerkung zu / (Schrägstrich, Slash)</h3>
1993 <p>Das Slash-Zeichen hat eine besondere Bedeutung, je nachdem, wo es
1994 in der URL erscheint. Manche werden sein Verhalten vom Dateisystem
1995 gewohnt sein, wo mehrere aufeinanderfolgende Schrägstriche
1996 häufig zu einem Schrägstrich zusammengefaßt werden
1997 (<em>d.h.</em> <code>/home///foo</code> ist das gleiche wie
1998 <code>/home/foo</code>). Im URL-Raum ist dies nicht notwendigerweise
1999 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
2000 müssen Sie explizit mehrere Schrägstriche angeben, wenn Sie
2001 genau dies beabsichtigen.</p>
2003 <p>Beispielsweise würde <code><LocationMatch ^/abc></code>
2004 auf die angeforderte URL <code>/abc</code> passen, nicht aber auf
2005 <code>//abc</code>. Die Direktive <code class="directive"><Location></code> (ohne reguläre Ausdrücke) verhält
2006 sich ähnlich, wenn sie für Proxy-Anfragen verwendet wird.
2007 Wenn <code class="directive"><Location></code> (ohne
2008 reguläre Ausdrücke) jedoch für nicht-Proxy-Anfragen
2009 verwendet wird, werden stillscheigend mehrere Schrächstriche mit
2010 mit einem einzigen Schrägstrich gleichgesetzt. Geben Sie
2011 beispielsweise <code><Location /abc/def></code> an und die
2012 Anfrage lautet auf <code>/abc//def</code>, dann greift die Anweisung.</p>
2017 <li><a href="../sections.html">Wie die Abschnitte <Directory>,
2018 <Location> und <Files> arbeiten</a> für eine
2019 Erläuterung, wie diese verschiedenen Abschnitte miteinander
2020 kombiniert werden, wenn eine Anfrage empfangen wird</li>
2023 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
2024 <div class="directive-section"><h2><a name="LocationMatch" id="LocationMatch"><LocationMatch></a>-<a name="locationmatch" id="locationmatch">Direktive</a></h2>
2025 <table class="directive">
2026 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Wendet die enthaltenen Direktiven nur auf URLs an, die auf
2027 reguläre Ausdrücke passen</td></tr>
2028 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code><LocationMatch
2029 <var>regex</var>> ... </LocationMatch></code></td></tr>
2030 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Serverkonfiguration, Virtual Host</td></tr>
2031 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
2032 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
2034 <p>Die Direktive <code class="directive"><LocationMatch></code>
2035 begrenzt die Reichweite der enthaltenen Anweisungen in der gleichen Weise
2036 wie <code class="directive"><a href="#location"><Location></a></code> auf URLs.
2037 Sie verwendet jedoch reguläre Ausdrücke als Argument anstelle
2038 einer einfachen Zeichenkette. Beispielsweise würde</p>
2040 <div class="example"><p><code>
2041 <LocationMatch "/(extra|special)/data">
2044 <p>auf URLs passen, welche die Zeichenfolge <code>/extra/data</code>
2045 oder <code>/special/data</code> enthalten.</p>
2049 <li><a href="../sections.html">Wie die Abschnitte <Directory>,
2050 <Location> und <Files> arbeiten</a> für eine
2051 Erläuterung, wie diese verschiedenen Abschnitte miteinander
2052 kombiniert werden, wenn eine Anfrage empfangen wird</li>
2055 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
2056 <div class="directive-section"><h2><a name="LogLevel" id="LogLevel">LogLevel</a>-<a name="loglevel" id="loglevel">Direktive</a></h2>
2057 <table class="directive">
2058 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Steuert die Ausführlichkeit des Fehlerprotokolls</td></tr>
2059 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>LogLevel <var>Level</var></code></td></tr>
2060 <tr><th><a href="directive-dict.html#Default">Voreinstellung:</a></th><td><code>LogLevel warn</code></td></tr>
2061 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Serverkonfiguration, Virtual Host</td></tr>
2062 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
2063 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
2065 <p><code class="directive">LogLevel</code> stellt die Ausführlichkeit
2066 der Nachrichten ein, die im Fehlerprotokoll aufgezeichnet werden (siehe
2067 Direktive <code class="directive"><a href="#errorlog">ErrorLog</a></code>). Die folgenden,
2068 nach absteigender Aussagekraft sortierten <var>Level</var> sind
2071 <table class="bordered">
2074 <th><strong>Level</strong> </th>
2076 <th><strong>Beschreibung</strong> </th>
2078 <th><strong>Beispiel</strong> </th>
2082 <td><code>emerg</code> </td>
2084 <td>Notfall - das System ist unbenutzbar.</td>
2086 <td>"Child cannot open lock file. Exiting"
2087 <span class="transnote">(<em>Anm.d.Ü.:</em> "Kindprozess kann die Lock-Datei nicht öffnen.
2088 Beende Programm")</span></td>
2092 <td><code>alert</code> </td>
2094 <td>Maßnahmen müssen unverzüglich ergriffen
2097 <td>"getpwuid: couldn't determine user name from uid"
2098 <span class="transnote">(<em>Anm.d.Ü.:</em> "getpwuid: kann keinen Benutzernamen aus der UID
2099 ermitteln")</span></td>
2103 <td><code>crit</code> </td>
2105 <td>Kritischer Zustand.</td>
2107 <td>"socket: Failed to get a socket, exiting child"
2108 <span class="transnote">(<em>Anm.d.Ü.:</em> "socket: Socket-Zuweisung fehlgeschlagen, beende
2109 Kindprozess")</span></td>
2113 <td><code>error</code> </td>
2115 <td>Fehlerbedingung.</td>
2117 <td>"Premature end of script headers"
2118 <span class="transnote">(<em>Anm.d.Ü.:</em> "Vorzeitiges Ende der Skript-Header")</span></td>
2122 <td><code>warn</code> </td>
2126 <td>"child process 1234 did not exit, sending another SIGHUP"
2127 <span class="transnote">(<em>Anm.d.Ü.:</em> "Kindprozess 1234 nicht beendet, sende ein weiteres
2128 SIGHUP")</span></td>
2132 <td><code>notice</code> </td>
2134 <td>Normaler, aber signifikanter Zustand.</td>
2136 <td>"httpd: caught SIGBUS, attempting to dump core in ..."
2137 <span class="transnote">(<em>Anm.d.Ü.:</em> "httpd: SIGBUS empfangen, versuche Speicherabbild nach ...
2138 zu schreiben")</span></td>
2142 <td><code>info</code> </td>
2144 <td>Information.</td>
2146 <td>"Server seems busy, (you may need to increase
2147 StartServers, or Min/MaxSpareServers)..."
2148 <span class="transnote">(<em>Anm.d.Ü.:</em> "Server scheint beschäftigt zu sein,
2149 (möglicherweise müssen Sie StartServers oder
2150 Min/MaxSpareServers erhöhen)")</span></td>
2154 <td><code>debug</code> </td>
2156 <td>Debug-Level-Nachrichten</td>
2158 <td>"Opening config file ..."
2159 <span class="transnote">(<em>Anm.d.Ü.:</em> "Öffne Konfigurationsdatei ...")</span></td>
2163 <p>Geben Sie einen bestimmten Level an, denn werden Nachrichten von
2164 allen höheren Leveln ebenso angezeigt. <em>Z.B.:</em> Wenn
2165 <code>LogLevel info</code> eingestellt ist, dann werden Nachrichten der
2166 Log-Level <code>notice</code> und <code>warn</code> ebenso eingetragen.</p>
2168 <p>Es wird empfohlen, mindestens den Level <code>crit</code> zu
2173 <div class="example"><p><code>
2177 <div class="note"><h3>Hinweis</h3>
2178 <p>Beim Protokollieren in eine reguläre Datei können
2179 Nachrichten des Levels <code>notice</code> nicht unterdrückt
2180 werden und werden daher immer protokolliert. Dies trifft allerdings
2181 nicht zu, wenn mittels <code>syslog</code> protokolliert wird.</p>
2185 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
2186 <div class="directive-section"><h2><a name="MaxKeepAliveRequests" id="MaxKeepAliveRequests">MaxKeepAliveRequests</a>-<a name="maxkeepaliverequests" id="maxkeepaliverequests">Direktive</a></h2>
2187 <table class="directive">
2188 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Anzahl der Anfragen, die bei einer persistenten Verbindung
2189 zulässig sind</td></tr>
2190 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>MaxKeepAliveRequests <var>Anzahl</var></code></td></tr>
2191 <tr><th><a href="directive-dict.html#Default">Voreinstellung:</a></th><td><code>MaxKeepAliveRequests 100</code></td></tr>
2192 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Serverkonfiguration, Virtual Host</td></tr>
2193 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
2194 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
2196 <p>Die Direktive <code class="directive">MaxKeepAliveRequests</code>
2197 begrenzt die Anzahl der Anfragen, die pro Verbindung zulässig sind,
2198 wenn <code class="directive"><a href="#keepalive">KeepAlive</a></code> eingeschaltet ist.
2199 Bei der Einstellung <code>0</code> sind unbegrenzt viele Anfragen
2200 erlaubt. Wir empfehlen für diese Einstellung einen hohen Wert
2201 für eine maximale Serverleistung.</p>
2205 <div class="example"><p><code>
2206 MaxKeepAliveRequests 500
2210 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
2211 <div class="directive-section"><h2><a name="NameVirtualHost" id="NameVirtualHost">NameVirtualHost</a>-<a name="namevirtualhost" id="namevirtualhost">Direktive</a></h2>
2212 <table class="directive">
2213 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Bestimmt eine IP-Adresse für den Betrieb namensbasierter
2214 virtueller Hosts</td></tr>
2215 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>NameVirtualHost <var>Adresse</var>[:<var>Port</var>]</code></td></tr>
2216 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Serverkonfiguration</td></tr>
2217 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
2218 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
2220 <p>Die Direktive <code class="directive">NameVirtualHost</code> ist erforderlich,
2221 wenn Sie <a href="../vhosts/">namensbasierte virtuelle Hosts</a>
2222 konfigurieren möchten.</p>
2224 <p>Obwohl <var>Adresse</var> eine Hostname sein kann, wird empfohlen,
2225 dass Sie stets eine IP-Adresse verwenden, z.B.:</p>
2227 <div class="example"><p><code>
2228 NameVirtualHost 111.22.33.44
2231 <p>Mit der <code class="directive">NameVirtualHost</code>-Anweisung geben Sie
2232 die IP-Adresse an, unter der der Server Anfragen für
2233 namensbasierte virtuelle Hosts entgegennimmt. Das ist üblicherweise
2234 die Adresse, zu der die Namen Ihrer namensbasierten virtuellen Hosts
2235 aufgelöst werden. Falls eine Firewall oder ein anderer Proxy die
2236 Anfrage in Empfang nimmt und Sie zu einer weiteren IP-Adresse des Servers
2237 weiterleitet, müssen Sie die IP-Adresse der physikalischen
2238 Schnittstelle der Maschine angeben, welche die Anfragen bedient.
2239 Wenn Sie mehrere namensbasierte Hosts an verschiedenen Adressen
2240 betreiben, wiederholen Sie einfach die Anweisung für jede
2243 <div class="note"><h3>Anmerkung</h3>
2244 <p>Beachten Sie, dass der "Hauptserver" und jeder
2245 <code>_default_</code>-Server <strong>niemals</strong> bei einer
2246 Anfrage an einer <code class="directive">NameVirtualHost</code>-IP-Adresse
2247 bedient wird (es sei denn, Sie geben aus irgendwelchen Gründen
2248 <code class="directive">NameVirtualHost</code> an, definieren dann aber keine
2249 <code class="directive">VirtualHost</code>s für diese Adresse).</p>
2252 <p>Optional können Sie die Nummer eines Ports angeben, an dem
2253 namensbasierte virtuelle Hosts verwendet werden sollen. Beispiel:</p>
2255 <div class="example"><p><code>
2256 NameVirtualHost 111.22.33.44:8080
2259 <p>IPv6-Adressen müssen, wie im folgenden Beispiel angegeben, in
2260 eckige Klammern eingeschlossen werden:</p>
2262 <div class="example"><p><code>
2263 NameVirtualHost [fe80::a00:20ff:fea7:ccea]:8080
2266 <p>Um an allen Schnittstellen Anfragen zu empfangen, können Sie
2267 <code>*</code> als Argument verwenden.</p>
2269 <div class="example"><p><code>
2273 <div class="note"><h3>Argument der Direktive <code class="directive"><VirtualHost></code></h3>
2274 <p>Beachten Sie, dass das Argument der <code class="directive"><VirtualHost></code>-Anweisung exakt auf das Argument
2275 der <code class="directive">NameVirtualHost</code>-Anweisung passen muss.</p>
2277 <div class="example"><p><code>
2278 NameVirtualHost 1.2.3.4<br />
2279 <VirtualHost 1.2.3.4><br />
2281 </VirtualHost><br />
2287 <li><a href="../vhosts/">Dokumentation zu virtuellen Hosts</a></li>
2290 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
2291 <div class="directive-section"><h2><a name="Options" id="Options">Options</a>-<a name="options" id="options">Direktive</a></h2>
2292 <table class="directive">
2293 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Definiert, welche Eigenschaften oder Funktionen in einem
2294 bestimmten Verzeichnis verfügbar sind</td></tr>
2295 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>Options
2296 [+|-]<var>Option</var> [[+|-]<var>Option</var>] ...</code></td></tr>
2297 <tr><th><a href="directive-dict.html#Default">Voreinstellung:</a></th><td><code>Options All</code></td></tr>
2298 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Serverkonfiguration, Virtual Host, Verzeichnis, .htaccess</td></tr>
2299 <tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>Options</td></tr>
2300 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
2301 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
2303 <p>Die Direktive <code class="directive">Options</code> steuert, welche
2304 Eigenschaften bzw. Funktionen in einem bestimmten Verzeichnis
2307 <p><var>Option</var> kann auf <code>None</code> gesetzt werden, wobei
2308 keine der besonderen Eigenschaften verfügbar sind, oder auf eines
2309 oder mehrere der folgenden:</p>
2312 <dt><code>All</code></dt>
2314 <dd>Alle Optionen außer <code>MultiViews</code>. Dies ist
2315 die Voreinstellung.</dd>
2317 <dt><code>ExecCGI</code></dt>
2319 <dd>Die Ausführung von CGI-Skripten, welche <code class="module"><a href="../mod/mod_cgi.html">mod_cgi</a></code>
2320 verwenden, ist erlaubt.</dd>
2322 <dt><code>FollowSymLinks</code></dt>
2324 <dd>Der Server folgt symbolischen Links in diesem Verzeichnis.
2326 <p>Auch wenn der Server symbolischen Links folgt, bedeutet dies
2327 <em>nicht</em>, dass der zum Abgleich gegen <code class="directive"><a href="#directory"><Directory></a></code>-Abschnitte verwendete Pfadname
2329 <p>Beachten Sie auch, dass diese Option innerhalb eines
2330 <code class="directive"><a href="#location"><Location></a></code>-Abschnitts
2331 <strong>ignoriert wird</strong>.</p>
2334 <dt><code>Includes</code></dt>
2337 Server Side Includes, die von <code class="module"><a href="../mod/mod_include.html">mod_include</a></code> bereitgestellt
2338 werden, sind erlaubt.</dd>
2340 <dt><code>IncludesNOEXEC</code></dt>
2342 <dd>Server Side Includes sind erlaubt, <code>#exec cmd</code>
2343 und <code>#exec cgi</code> sind jedoch deaktiviert. Es ist aber noch
2344 möglich, CGI-Skripte aus
2345 <code class="directive"><a href="../mod/mod_alias.html#scriptalias">ScriptAlias</a></code>-Verzeichnissen mittels
2346 <code>#include virtual</code> einzubinden.</dd>
2348 <dt><code>Indexes</code></dt>
2350 <dd>Wenn eine URL, die auf ein Verzeichnis zeigt, in dem sich keine durch
2351 <code class="directive"><a href="../mod/mod_dir.html#directoryindex">DirectoryIndex</a></code> definierte
2352 Indexdatei (<em>z.B.</em> <code>index.html</code>) befindet, dann liefert
2353 <code class="module"><a href="../mod/mod_autoindex.html">mod_autoindex</a></code> eine formatierte Auflistung des
2354 Verzeichnisses zurück.</dd>
2356 <dt><code>MultiViews</code></dt>
2358 <dd>"MultiViews" sind bei der Verwendung von
2359 <code class="module"><a href="../mod/mod_negotiation.html">mod_negotiation</a></code> erlaubt (siehe <a href="../content-negotiation.html">Content-Negotiation</a>).</dd>
2361 <dt><code>SymLinksIfOwnerMatch</code></dt>
2363 <dd>Der Server folgt nur symbolischen Links, bei denen die Zieldatei
2364 bzw. das Zielverzeichnis der gleichen Benutzerkennung gehört, wie
2366 <div class="note"><h3>Anmerkung</h3> Diese Option wird innerhalb eines
2367 <code class="directive"><a href="#location"><Location></a></code>-Abschnitts
2368 ignoriert.</div></dd>
2371 <p>Wenn mehrere <code class="directive">Options</code> auf ein Verzeichnis
2372 angewandt werden können, dann wird normalerweise die
2373 spezifischste <span class="transnote">(<em>Anm.d.Ü.:</em> Gemeint ist die zuletzt
2374 ausgeführte Option.)</span> verwendet und alle anderen werden
2375 ignoriert; die Optionen werden nicht vermischt. (Siehe auch <a href="../sections.html#mergin">Wie Abschnitte zusammengeführt
2376 werden.</a>.) Wenn jedoch <em>allen</em> Optionen der
2377 <code class="directive">Options</code>-Anweisung eines der Zeichen
2378 <code>+</code> oder <code>-</code> vorangestellt wird, werden die Optionen
2379 zusammengemischt. Jede Option mit vorangestelltem <code>+</code> wird
2380 zu den momentan gültigen Optionen hinzugefügt und jede Option
2381 mit vorangestelltem <code>-</code> wird aus den derzeit gültigen
2382 Optionen entfernt.</p>
2384 <p>So wird zum Beispiel ohne die Zeichen <code>+</code> und
2387 <div class="example"><p><code>
2388 <Directory /web/docs><br />
2389 <span class="indent">
2390 Options Indexes FollowSymLinks<br />
2392 </Directory><br />
2394 <Directory /web/docs/spec><br />
2395 <span class="indent">
2396 Options Includes<br />
2401 <p>für das Verzeichnis <code>/web/docs/spec</code> wird jetzt
2402 lediglich <code>Includes</code> gesetzt. Wenn die zweite
2403 <code class="directive">Options</code>-Anweisung jedoch <code>+</code>-
2404 und <code>-</code>-Zeichen verwenden würde,</p>
2406 <div class="example"><p><code>
2407 <Directory /web/docs><br />
2408 <span class="indent">
2409 Options Indexes FollowSymLinks<br />
2411 </Directory><br />
2413 <Directory /web/docs/spec><br />
2414 <span class="indent">
2415 Options +Includes -Indexes<br />
2420 <p>dann würden die Optionen <code>FollowSymLinks</code> und
2421 <code>Includes</code> für das Verzeichnis <code>/web/docs/spec</code>
2424 <div class="note"><h3>Anmerkung</h3>
2425 <p>Die Verwendung von <code>-IncludesNOEXEC</code> oder
2426 <code>-Includes</code> deaktiviert Server Side Includes unabhängig
2427 von der vorigen Einstellung vollständig.</p>
2430 <p>Die Voreinstellung ist <code>All</code>, sofern keine anderen Angaben
2434 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
2435 <div class="directive-section"><h2><a name="Require" id="Require">Require</a>-<a name="require" id="require">Direktive</a></h2>
2436 <table class="directive">
2437 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Wählt die authentisierten Benutzer aus, die auf eine
2438 Ressource zugreifen können</td></tr>
2439 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>Require <var>Name</var> [<var>Name</var>] ...</code></td></tr>
2440 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Verzeichnis, .htaccess</td></tr>
2441 <tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>AuthConfig</td></tr>
2442 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
2443 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
2445 <p>Die Direktive wählt aus, welche authentisierten Benutzer auf ein
2446 Verzeichnis zugreifen dürfen. Folgende Syntax ist erlaubt:</p>
2449 <dt><code>Require user <var>User-ID</var> [<var>User-ID</var>]
2451 <dd>Nur die genannten Benutzer dürfen auf die Ressource
2454 <dt><code>Require group <var>Gruppenname</var> [<var>Gruppenname</var>]
2456 <dd>Nur Benutzer der genannten Gruppen dürfen auf die
2457 Ressource zugreifen.</dd>
2459 <dt><code>Require valid-user</code></dt>
2460 <dd>Alle gültigen Benutzer dürfen auf die Ressource
2464 <p><code class="directive">Require</code> muss von den Direktiven
2465 <code class="directive"><a href="#authname">AuthName</a></code> und <code class="directive"><a href="#authtype">AuthType</a></code> sowie Direktiven wie
2466 <code class="directive"><a href="../mod/mod_authn_file.html#authuserfile">AuthUserFile</a></code>
2467 und <code class="directive"><a href="../mod/mod_authz_groupfile.html#authgroupfile">AuthGroupFile</a></code>
2468 (zur Definition von Benutzern und Gruppen) begleitet werden, um
2469 korrekt zu funktionieren. Beispiel:</p>
2471 <div class="example"><p><code>
2472 AuthType Basic<br />
2473 AuthName "geschütztes Verzeichnis"<br />
2474 AuthUserFile /web/users<br />
2475 AuthGroupFile /web/groups<br />
2479 <p>Zugriffskontrollen, die in dieser Form angewandt werden, gelten
2480 für <strong>alle</strong> Methoden. <strong>Dies ist normalerweise
2481 gewünscht.</strong> Wenn Sie Zugriffskontrollen nur auf bestimmte
2482 Methoden anwenden möchten, während andere Methoden
2483 ungeschützt bleiben, dann müssen Sie die
2484 <code class="directive">Require</code>-Anweisung innerhalb eines
2485 <code class="directive"><a href="#limit"><Limit></a></code>-Abschnitts
2490 <li><code class="directive"><a href="#satisfy">Satisfy</a></code></li>
2491 <li><code class="module"><a href="../mod/mod_authz_host.html">mod_authz_host</a></code></li>
2494 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
2495 <div class="directive-section"><h2><a name="RLimitCPU" id="RLimitCPU">RLimitCPU</a>-<a name="rlimitcpu" id="rlimitcpu">Direktive</a></h2>
2496 <table class="directive">
2497 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Begrenzt den CPU-Verbrauch von Prozessen, die von
2498 Apache-Kindprozessen gestartet wurden</td></tr>
2499 <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>
2500 <tr><th><a href="directive-dict.html#Default">Voreinstellung:</a></th><td><code>unbestimmt; verwendet die Voreinstellung des Systems</code></td></tr>
2501 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Serverkonfiguration, Virtual Host, Verzeichnis, .htaccess</td></tr>
2502 <tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>All</td></tr>
2503 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
2504 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
2506 <p>Akzeptiert einen oder zwei Parameter. Der erste Paramater setzt eine
2507 weiche Ressourcenbegrenzung für alle Prozesse, der zweite Parameter
2508 setzt die Maximalgrenze für die Ressourcennutzung. Jeder der
2509 Parameter kann eine Zahl oder <code>max</code> sein. <code>max</code>
2510 zeigt dem Server an, dass das vom Betriebssystem erlaubte Maximum
2511 verwendet werden soll. Das Anheben der maximal erlaubten Ressourcennutzung
2512 erfordert, dass der Server als <code>root</code> läuft, zumindest in
2513 der anfänglichen Startphase.</p>
2515 <p>Dies wird auf Prozesse angewendet, die von Anfragen bearbeitenden
2516 Apache-Kindprozessen abgespalten werden, nicht auf die
2517 Apache-Kindprozesse selbst. Das beinhaltet CGI-Skripte und
2518 SSI-exec-Befehle, nicht jedoch Prozesse, die vom Apache-Elternprozess
2519 abgespalten werden, wie z.B. Protokollierung.</p>
2521 <p>CPU-Ressourcenbegrenzung wird in Sekunden pro Prozess
2526 <li><code class="directive"><a href="#rlimitmem">RLimitMEM</a></code></li>
2527 <li><code class="directive"><a href="#rlimitnproc">RLimitNPROC</a></code></li>
2530 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
2531 <div class="directive-section"><h2><a name="RLimitMEM" id="RLimitMEM">RLimitMEM</a>-<a name="rlimitmem" id="rlimitmem">Direktive</a></h2>
2532 <table class="directive">
2533 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Begrenzt den Speicherverbrauch von Prozessen, die von
2534 Apache-Kindprozessen gestartet wurden</td></tr>
2535 <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>
2536 <tr><th><a href="directive-dict.html#Default">Voreinstellung:</a></th><td><code>unbestimmt; verwendet die Voreinstellung des Systems</code></td></tr>
2537 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Serverkonfiguration, Virtual Host, Verzeichnis, .htaccess</td></tr>
2538 <tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>All</td></tr>
2539 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
2540 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
2542 <p>Akzeptiert einen oder zwei Parameter. Der erste Paramater setzt eine
2543 weiche Ressourcenbegrenzung für alle Prozesse, der zweite Parameter
2544 setzt die Maximalgrenze für die Ressourcennutzung. Jeder der
2545 Parameter kann eine Zahl oder <code>max</code> sein. <code>max</code>
2546 zeigt dem Server an, dass das vom Betriebssystem erlaubte Maximum
2547 verwendet werden soll. Das Anheben der maximal erlaubten Ressourcennutzung
2548 erfordert, dass der Server als <code>root</code> läuft, zumindest in
2549 der anfänglichen Startphase.</p>
2551 <p>Dies wird auf Prozesse angewendet, die von Anfragen bearbeitenden
2552 Apache-Kindprozessen abgespalten werden, nicht auf die
2553 Apache-Kindprozesse selbst. Das beinhaltet CGI-Skripte und
2554 SSI-exec-Befehle, nicht jedoch Prozesse, die vom Apache-Elternprozess
2555 abgespalten werden, wie z.B. Protokollierung.</p>
2557 <p>Die Begrenzung des Speicherverbrauchs wird in Bytes pro Prozess
2562 <li><code class="directive"><a href="#rlimitcpu">RLimitCPU</a></code></li>
2563 <li><code class="directive"><a href="#rlimitnproc">RLimitNPROC</a></code></li>
2566 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
2567 <div class="directive-section"><h2><a name="RLimitNPROC" id="RLimitNPROC">RLimitNPROC</a>-<a name="rlimitnproc" id="rlimitnproc">Direktive</a></h2>
2568 <table class="directive">
2569 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Begrenzt die Anzahl der Prozesse, die von Prozessen gestartet
2570 werden können, der ihrerseits von Apache-Kinprozessen gestartet
2572 <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>
2573 <tr><th><a href="directive-dict.html#Default">Voreinstellung:</a></th><td><code>unbestimmt; verwendet die Voreinstellung des Systems</code></td></tr>
2574 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Serverkonfiguration, Virtual Host, Verzeichnis, .htaccess</td></tr>
2575 <tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>All</td></tr>
2576 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
2577 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
2579 <p>Akzeptiert einen oder zwei Parameter. Der erste Paramater setzt eine
2580 weiche Ressourcenbegrenzung für alle Prozesse, der zweite Parameter
2581 setzt die Maximalgrenze für die Ressourcennutzung. Jeder der
2582 Parameter kann eine Zahl oder <code>max</code> sein. <code>max</code>
2583 zeigt dem Server an, dass das vom Betriebssystem erlaubte Maximum
2584 verwendet werden soll. Das Anheben der maximal erlaubten Ressourcennutzung
2585 erfordert, dass der Server als <code>root</code> läuft, zumindest in
2586 der anfänglichen Startphase.</p>
2588 <p>Dies wird auf Prozesse angewendet, die von Anfragen bearbeitenden
2589 Apache-Kindprozessen abgespalten werden, nicht auf die
2590 Apache-Kindprozesse selbst. Dies beinhaltet CGI-Skripte und
2591 SSI-exec-Befehle, nicht jedoch Prozesse, die vom Apache-Elternprozess
2592 abgespalten werden, wie z.B. Protokollierung.</p>
2594 <p>Prozessbegrenzungen steuern die Anzahl der Prozesse pro Benutzer.</p>
2596 <div class="note"><h3>Anmerkung</h3>
2597 <p>Wenn CGI-Prozesse nicht unter anderen Benutzerkennungen als der
2598 User-ID des Webservers laufen, dann beschränkt diese Direktive
2599 die Anzahl der Prozesse, die der Server selbst erstellen kann.
2600 Kennzeichen einer solchen Situation sind
2601 <strong><code>cannot fork</code></strong>-Meldungen
2602 <span class="transnote">(<em>Anm.d.Ü.:</em> <code>kann nicht abspalten</code>)</span> in der
2603 Datei <code>error_log</code>.</p>
2608 <li><code class="directive"><a href="#rlimitmem">RLimitMEM</a></code></li>
2609 <li><code class="directive"><a href="#rlimitcpu">RLimitCPU</a></code></li>
2612 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
2613 <div class="directive-section"><h2><a name="Satisfy" id="Satisfy">Satisfy</a>-<a name="satisfy" id="satisfy">Direktive</a></h2>
2614 <table class="directive">
2615 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Zusammenspiel von rechnerbasierter Zugriffskontrolle und
2616 Benutzerauthentisierung</td></tr>
2617 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>Satisfy Any|All</code></td></tr>
2618 <tr><th><a href="directive-dict.html#Default">Voreinstellung:</a></th><td><code>Satisfy All</code></td></tr>
2619 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Verzeichnis, .htaccess</td></tr>
2620 <tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>AuthConfig</td></tr>
2621 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
2622 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
2623 <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>
2625 <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
2626 entweder <code>All</code> oder <code>Any</code> sein. Die Direktive ist
2627 nur dann nützlich, wenn der Zugriff zu einem bestimmten Bereich
2628 durch Benutzername/Passwort <em>und</em> Clientrechner-Adressen
2629 eingeschränkt ist. In diesem Fall verlangt die Voreinstellung
2630 (<code>All</code>), dass der Client die Adressbeschränkung passiert
2631 <em>und</em> eine gültige Benutzerkennung und ein gültiges
2632 Passwort übermittelt. Mit der Auswahl <code>Any</code> wird dem
2633 Client der Zugriff erlaubt, wenn er entweder die Rechner-Beschänkung
2634 passiert oder einen gültigen Benutzernamen und ein gültiges
2635 Passwort übermittelt. Dies kann verwendet werden, um einen Bereich
2636 mit einem Passwort zu schützen, jedoch Clients von bestimmten
2637 Adressen ohne Abfrage des Passwortes zuzulassen.</p>
2639 <p>Wenn Sie beispielsweise möchten, dass Personen aus Ihrem
2640 privaten Netzwerk unbechänkten Zugriff zu Teilen Ihres
2641 Webangebots haben, jedoch verlangen, dass Personen außerhalb
2642 Ihres privaten Netzwerks ein Passwort übergeben müssen,
2643 können Sie eine Konfiguration ähnlich der folgenden
2646 <div class="example"><p><code>
2647 Require valid-user<br />
2648 Allow from 192.168.1<br />
2652 <p>Seit Version 2.0.51 können
2653 <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
2654 beschränkt werden.</p>
2658 <li><code class="directive"><a href="../mod/mod_authz_host.html#allow">Allow</a></code></li>
2659 <li><code class="directive"><a href="#require">Require</a></code></li>
2662 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
2663 <div class="directive-section"><h2><a name="ScriptInterpreterSource" id="ScriptInterpreterSource">ScriptInterpreterSource</a>-<a name="scriptinterpretersource" id="scriptinterpretersource">Direktive</a></h2>
2664 <table class="directive">
2665 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Methode zur Ermittlung des Interpreters von
2666 CGI-Skripten</td></tr>
2667 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>ScriptInterpreterSource Registry|Registry-Strict|Script</code></td></tr>
2668 <tr><th><a href="directive-dict.html#Default">Voreinstellung:</a></th><td><code>ScriptInterpreterSource Script</code></td></tr>
2669 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Serverkonfiguration, Virtual Host, Verzeichnis, .htaccess</td></tr>
2670 <tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>FileInfo</td></tr>
2671 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
2672 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
2673 <tr><th><a href="directive-dict.html#Compatibility">Kompatibilität:</a></th><td>ausschließlich Win32;
2674 Die Option <code>Registry-Strict</code> ist verfügbar seit Apache
2677 <p>Die Direktive steuert, wie der Apache den Interpreter zur Ausführung
2678 von CGI-Skripten bestimmt. Die Voreinstellung ist <code>Script</code>. Dies
2679 veranlaßt den Apache, den Interpreter zu verwenden, auf den die
2680 Shebang-Zeile (erste Zeile, beginnt mit <code>#!</code>) im Skript zeigt.
2681 Auf Win32-Systemen sieht diese Zeile üblicherweise so aus:</p>
2683 <div class="example"><p><code>
2684 #!C:/Perl/bin/perl.exe
2687 <p>oder, wenn <code>perl</code> im Pfad (Umgebungsvariable <code>PATH</code>) liegt,
2690 <div class="example"><p><code>
2694 <p>Die Einstellung <code>ScriptInterpreterSource Registry</code>
2695 veranlaßt eine Suche in <code>HKEY_CLASSES_ROOT</code> der
2696 Windows-Registrierungsdatenbank und verwendet die Endung der Skript-Datei
2697 (z.B. <code>.pl</code>) als Suchargument. Der durch den Unterschlüssel
2698 <code>Shell\ExecCGI\Command</code> oder, falls dieser nicht existiert,
2699 <code>Shell\Open\Command</code> definierte Befehl wird zum Öffnen der
2700 Skript-Datei verwendet. Wenn der Schlüssel zur Dateiendung oder
2701 beide Unterschlüssel fehlen, dann verwendet der Apache die Option
2702 <code>Script</code>.</p>
2704 <div class="warning"><h3>Sicherheit</h3>
2705 <p>Seien Sie vorsichtig, <code>ScriptInterpreterSource Registry</code> bei
2706 Verzeichnissen zu verwenden, auf die eine <code class="directive"><a href="../mod/mod_alias.html#scriptalias">ScriptAlias</a></code>-Anweisung zeigt, denn der
2707 Apache versucht <strong>jede</strong> Datei innerhalb des Verzeichnisses
2708 auszuführen. Die Einstellung <code>Registry</code> kann
2709 unerwünschte Programmaufrufe bei Dateien verursachen, die
2710 üblicherweise nicht ausgeführt werden. Auf den meisten
2711 Windows-Systemen beispielsweise startet der voreingestellte
2712 Öffnen-Befehl für <code>.htm</code>-Dateien den Microsoft
2713 Internet Explorer, so dass jede HTTP-Anfrage nach einer existierenden
2714 <code>.htm</code>-Datei im Skript-Verzeichnis den Browser im Hintergrund
2715 starten würde. Dies ist eine wirksame Methode, Ihr System binnen
2716 etwa einer Minute zum Absturz zu bringen.</p>
2719 <p>Die seit Apache 2.0 neue Option <code>Registry-Strict</code>
2720 macht das gleiche wie <code>Registry</code>, verwendet jedoch nur den
2721 Unterschlüssel <code>Shell\ExecCGI\Command</code>. Der Schlüssel
2722 <code>ExecCGI</code> ist gewöhnlich nicht voreingestellt. Er muss
2723 manuell eingerichtet werden und schützt Ihr System so for
2724 versehentlichen Programmaufrufen.</p>
2727 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
2728 <div class="directive-section"><h2><a name="ServerAdmin" id="ServerAdmin">ServerAdmin</a>-<a name="serveradmin" id="serveradmin">Direktive</a></h2>
2729 <table class="directive">
2730 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>E-Mail-Adresse, die der Server in Fehlermeldungen einfügt,
2731 welche an den Client gesendet werden</td></tr>
2732 <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>
2733 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Serverkonfiguration, Virtual Host</td></tr>
2734 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
2735 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
2737 <p><code class="directive">ServerAdmin</code> legt die Kontaktadresse fest,
2738 die der Server in jede Fehlermeldung einfügt, die er an den
2739 Client zurückschickt. Wenn <code>httpd</code> das übergebene
2740 Argument nicht als URL erkennt, nimmt er an, dess es sich um eine
2741 <var>E-Mail-Adresse</var> handelt und stellt in Hyperlinks
2742 <code>mailto:</code> voran. Es ist jedoch sogar sinnvoll, eine
2743 E-Mail-Adresse zu verwenden, da viele CGI-Skripte davon ausgehen. Wenn Sie
2744 eine URL verwenden möchten, sollten Sie auf einem anderen unter Ihrer
2745 Kontrolle stehenden Server verweisen. Andernfalls können Besucher Sie
2746 im Fehlerfall möglicherweise nicht kontaktieren.</p>
2748 <p>Es kann sich lohnen, hierfür eine reservierte Adresse
2751 <div class="example"><p><code>
2752 ServerAdmin www-admin@foo.example.com
2755 <p>da Anwender nicht unbedingt erwähnen, dass sie vom Server
2759 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
2760 <div class="directive-section"><h2><a name="ServerAlias" id="ServerAlias">ServerAlias</a>-<a name="serveralias" id="serveralias">Direktive</a></h2>
2761 <table class="directive">
2762 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Alternativer Name für einen Host, der verwendet wird, wenn
2763 Anfragen einem namensbasierten virtuellen Host zugeordnet werden</td></tr>
2764 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>ServerAlias <var>Hostname</var> [<var>Hostname</var>] ...</code></td></tr>
2765 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Virtual Host</td></tr>
2766 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
2767 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
2769 <p>Die Direktive <code class="directive">ServerAlias</code> bestimmt die
2770 alternativen Namen eines Hosts zur Verwendung mit <a href="../vhosts/name-based.html">namensbasierten virtuellen Hosts</a>.</p>
2772 <div class="example"><p><code>
2773 <VirtualHost *><br />
2774 ServerName server.domain.com<br />
2775 ServerAlias server server2.domain.com server2<br />
2777 </VirtualHost>
2782 <li><a href="../vhosts/">Apache-Dokumentation zu virtuellen
2786 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
2787 <div class="directive-section"><h2><a name="ServerName" id="ServerName">ServerName</a>-<a name="servername" id="servername">Direktive</a></h2>
2788 <table class="directive">
2789 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Rechnername und Port, die der Server dazu verwendet, sich
2790 selbst zu identifizieren</td></tr>
2791 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>ServerName
2792 <var>voll-qualifizierter-Domainname</var>[:<var>port</var>]</code></td></tr>
2793 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Serverkonfiguration, Virtual Host</td></tr>
2794 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
2795 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
2796 <tr><th><a href="directive-dict.html#Compatibility">Kompatibilität:</a></th><td>Diese Direktive löst in Version 2.0 die
2797 Funktionalität der Direktive <code class="directive">Port</code> aus
2798 Version 1.3 ab.</td></tr>
2800 <p>Die Direktive <code class="directive">ServerName</code> bestimmt den
2801 Rechnernamen und Port, den der Server dazu verwendet, sich selbst
2802 zu identifizieren. Diese werden bei der Erstellung von Umleitungs-URLs
2803 benötigt. Wenn beispielsweise der Name der Maschine, die den Webserver
2804 beherbergt, <code>simple.example.com</code> lautet, die Maschine jedoch
2805 auch einen DNS-Alias <code>www.example.com</code> besitzt und Sie den
2806 Webserver so identifizieren möchten, sollten Sie die folgende
2807 Anweisung verwenden:</p>
2809 <div class="example"><p><code>
2810 ServerName www.example.com:80
2813 <p>Wenn kein <code class="directive">ServerName</code> angegeben wurde,
2814 dann versucht der Server den Rechnernamen mittels eines Reverse-Lookup
2815 herzuleiten. Wenn kein Port in der
2816 <code class="directive">ServerName</code>-Anweisung angegeben wurde, dann
2817 verwendet der Server den Port der eingegangenen Anfrage. Für eine
2818 optimale Zuverlässigkeit und Berechenbarkeit sollten Sie einen
2819 eindeutigen Rechnernamen und Port angeben, in dem Sie die Direktive
2820 <code class="directive">ServerName</code> verwenden.</p>
2822 <p>Wenn Sie <a href="../vhosts/name-based.html">namensbasierte
2823 virtuelle Hosts</a> verwenden, gibt <code class="directive">ServerName</code>
2824 innerhalb eines <code class="directive"><a href="#virtualhost"><VirtualHost></a></code>-Abschnitts an, welcher
2825 Hostname im <code>Host:</code>-Header der Anfrage auftauchen muss,
2826 damit sie diesem virtuellen Host zugeordnet wird.</p>
2828 <p>Lesen Sie bitte die Beschreibung der Direktive <code class="directive"><a href="#usecanonicalname">UseCanonicalName</a></code> für Einstellungen, die
2829 bestimmen, ob selbstreferenzierende URLs (z.B. vom Modul
2830 <code class="module"><a href="../mod/mod_dir.html">mod_dir</a></code>) auf den angegebenen Port zeigen oder auf die
2831 Portnummern die in der Anfrage des Clients angegeben ist.</p>
2835 <li><a href="../dns-caveats.html">Probleme bezüglich DNS und
2837 <li><a href="../vhosts/">Apache-Dokumentation zu virtuellen
2839 <li><code class="directive"><a href="#usecanonicalname">UseCanonicalName</a></code></li>
2840 <li><code class="directive"><a href="#namevirtualhost">NameVirtualHost</a></code></li>
2841 <li><code class="directive"><a href="#serveralias">ServerAlias</a></code></li>
2844 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
2845 <div class="directive-section"><h2><a name="ServerPath" id="ServerPath">ServerPath</a>-<a name="serverpath" id="serverpath">Direktive</a></h2>
2846 <table class="directive">
2847 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Veralteter URL-Pfad für einen namensbasierten
2848 virtuellen Host, auf den von einem inkompatiblen Browser zugegriffen
2850 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>ServerPath <var>URL-Pfad</var></code></td></tr>
2851 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Virtual Host</td></tr>
2852 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
2853 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
2855 <p>Die Direktive <code class="directive">ServerPath</code> legt den
2856 veralteten <span class="transnote">(<em>Anm.d.Ü.:</em> Gemeint ist eigentlich "Altlast" aufgrund
2857 antiquierter Clients.)</span> URL-Pfad eines Hosts zur Verwendung mit
2858 <a href="../vhosts/">namensbasierten virtuellen Hosts</a> fest.</p>
2862 <li><a href="../vhosts/">Apache-Dokumentation zu virtuellen
2866 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
2867 <div class="directive-section"><h2><a name="ServerRoot" id="ServerRoot">ServerRoot</a>-<a name="serverroot" id="serverroot">Direktive</a></h2>
2868 <table class="directive">
2869 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Basisverzeichnis der Serverinstallation</td></tr>
2870 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>ServerRoot <var>Verzeichnis</var></code></td></tr>
2871 <tr><th><a href="directive-dict.html#Default">Voreinstellung:</a></th><td><code>ServerRoot /usr/local/apache</code></td></tr>
2872 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Serverkonfiguration</td></tr>
2873 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
2874 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
2876 <p>Die Direktive <code class="directive">ServerRoot</code> bestimmt das
2877 Verzeichnis, in dem der Server installiert ist. Üblicherweise
2878 enthält es die Unterverzeichnisse <code>conf/</code> und
2879 <code>logs/</code>. Relative Pfadangaben anderer Direktiven (wie z.B.
2880 <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
2881 Verzeichnis betrachtet.</p>
2883 <div class="example"><h3>Beispiel</h3><p><code>
2884 ServerRoot /home/httpd
2889 <li><a href="../invoking.html">Die <code>httpd</code>-Option
2890 <code>-d</code></a></li>
2891 <li><a href="../misc/security_tips.html#serverroot">Sicherheitshinweise</a>
2892 für Informationen, wie die Rechte auf das <code class="directive">ServerRoot</code>-Verzeichnis richtig gesetzt werden</li>
2895 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
2896 <div class="directive-section"><h2><a name="ServerSignature" id="ServerSignature">ServerSignature</a>-<a name="serversignature" id="serversignature">Direktive</a></h2>
2897 <table class="directive">
2898 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Konfiguriert die Fußzeile von servergenerierten
2899 Dokumenten</td></tr>
2900 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>ServerSignature On|Off|EMail</code></td></tr>
2901 <tr><th><a href="directive-dict.html#Default">Voreinstellung:</a></th><td><code>ServerSignature Off</code></td></tr>
2902 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Serverkonfiguration, Virtual Host, Verzeichnis, .htaccess</td></tr>
2903 <tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>All</td></tr>
2904 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
2905 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
2907 <p>Die Direktive <code class="directive">ServerSignature</code> ermöglicht
2908 die Gestaltung einer unter servergenerierten Dokumenten (z.B.
2909 Fehlerdokumente, FTP-Verzeichnislisten von <code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code>,
2910 <code class="module"><a href="../mod/mod_info.html">mod_info</a></code>-Ausgaben, ...) angefügten
2911 Fußzeile. Ein möglicher Grund für die Aktivierung einer
2912 solchen Fußzeile ist, dass der Anwender bei einer Kette von
2913 Proxy-Servern oft keine Möglichkeit hat, zu erkennen, welcher der
2914 verketteten Server gegenwärtig die zurückgegebene Fehlermeldung
2917 <p>Die (Vor-)Einstellung <code>Off</code> unterdrückt die
2918 Fußzeile (und ist damit kompatibel zum Verhalten des Apache 1.2 und
2919 früher). Die Einstellung <code>On</code> fügt schlicht eine
2920 Zeile mit der Versionsnummer des Servers und dem Servernamen (<code class="directive"><a href="#servername">ServerName</a></code>) des bedienenden virtuellen Hosts an.
2921 Die Einstellung <code>EMail</code> erstellt zusätzlich einen
2922 "mailto:"-Verweis zum Serveradministrator (<code class="directive"><a href="#serveradmin">ServerAdmin</a></code>) des referenzierten Dokuments.</p>
2924 <p>Ab Version 2.0.44 werden die Details der angegebenen Versionsnummer des
2925 Servers von der Direktive <code class="directive"><a href="#servertokens">ServerTokens</a></code> kontrolliert.</p>
2929 <li><code class="directive"><a href="#servertokens">ServerTokens</a></code></li>
2932 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
2933 <div class="directive-section"><h2><a name="ServerTokens" id="ServerTokens">ServerTokens</a>-<a name="servertokens" id="servertokens">Direktive</a></h2>
2934 <table class="directive">
2935 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Konfiguriert den HTTP-Response-Header
2937 <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>
2938 <tr><th><a href="directive-dict.html#Default">Voreinstellung:</a></th><td><code>ServerTokens Full</code></td></tr>
2939 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Serverkonfiguration</td></tr>
2940 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
2941 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
2943 <p>die Direktive steuert, ob der Response-Header <code>Server</code>,
2944 der an den Client zurückgesendet wird, eine Beschreibung des
2945 allgemeinen Betriesbsystemtyps des Servers wie auch Informationen
2946 über einkompilierte Module enthält.</p>
2949 <dt><code>ServerTokens Prod[uctOnly]</code></dt>
2951 <dd>Der Server sendet (<em>z.B.</em>): <code>Server:
2954 <dt><code>ServerTokens Major</code></dt>
2956 <dd>Der Server sendet (<em>z.B.</em>): <code>Server:
2957 Apache/2</code></dd>
2959 <dt><code>ServerTokens Minor</code></dt>
2961 <dd>Der Server sendet (<em>z.B.</em>): <code>Server:
2962 Apache/2.0</code></dd>
2964 <dt><code>ServerTokens Min[imal]</code></dt>
2966 <dd>Der Server sendet (<em>z.B.</em>): <code>Server:
2967 Apache/2.0.41</code></dd>
2969 <dt><code>ServerTokens OS</code></dt>
2971 <dd>Der Server sendet (<em>z.B.</em>): <code>Server: Apache/2.0.41
2974 <dt><code>ServerTokens Full</code> (oder nicht angegeben)</dt>
2976 <dd>Der Server sendet (<em>z.B.</em>): <code>Server: Apache/2.0.41
2977 (Unix) PHP/4.2.2 MyMod/1.2</code></dd>
2980 <p>Diese Einstellung gilt für den gesamten Server und kann nicht
2981 auf Virtual-Host-Basis aktiviert oder deaktiviert werden.</p>
2983 <p>Ab Version 2.0.44 steuert diese Direktive auch die Informationen, die
2984 durch die Direktive <code class="directive"><a href="#serversignature">ServerSignature</a></code>
2985 angeboten werden.</p>
2989 <li><code class="directive"><a href="#serversignature">ServerSignature</a></code></li>
2992 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
2993 <div class="directive-section"><h2><a name="SetHandler" id="SetHandler">SetHandler</a>-<a name="sethandler" id="sethandler">Direktive</a></h2>
2994 <table class="directive">
2995 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Erzwingt die Verarbeitung aller passenden Dateien durch
2996 einen Handler</td></tr>
2997 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>SetHandler <var>Handlername</var>|None</code></td></tr>
2998 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Serverkonfiguration, Virtual Host, Verzeichnis, .htaccess</td></tr>
2999 <tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>FileInfo</td></tr>
3000 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
3001 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
3002 <tr><th><a href="directive-dict.html#Compatibility">Kompatibilität:</a></th><td>Seit Apache 2.0 im Core</td></tr>
3004 <p>Wenn die Direktive innerhalb einer <code>.htaccess</code>-Datei
3005 oder in einem <code class="directive"><a href="#directory"><Directory></a></code>- oder
3006 <code class="directive"><a href="#location"><Location></a></code>-Abschnitt
3007 angegeben wird, erzwingt sie, dass alle entsprechenden Dateien von dem
3008 durch <var>Handlername</var> angegebenen <a href="../handler.html">Handler</a> analysiert werden. Wenn Sie
3009 beispielsweise ein Verzeichnis haben, dessen Dateien unabhängig von
3010 der Endung gänzlich als Image-Maps interpretiert werden sollen,
3011 können Sie folgendes in eine <code>.htaccess</code>-Datei in
3012 dem Verzeichnis schreiben:</p>
3014 <div class="example"><p><code>
3015 SetHandler imap-file
3018 <p>Noch ein Beispiel: wenn Sie den Server immer, wenn die URL
3019 <code>http://servername/status</code> aufgerufen wird, einen
3020 Statusbericht anzeigen lassen möchten, dann können
3021 Sie folgendes in die <code>httpd.conf</code> schreiben:</p>
3023 <div class="example"><p><code>
3024 <Location /status><br />
3025 <span class="indent">
3026 SetHandler server-status<br />
3030 <p>Sie können eine zuvor definierte
3031 <code class="directive">SetHandler</code>-Anweisung aufheben, indem Sie den Wert
3032 <code>None</code> verwenden.</p>
3036 <li><code class="directive"><a href="../mod/mod_mime.html#addhandler">AddHandler</a></code></li>
3039 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
3040 <div class="directive-section"><h2><a name="SetInputFilter" id="SetInputFilter">SetInputFilter</a>-<a name="setinputfilter" id="setinputfilter">Direktive</a></h2>
3041 <table class="directive">
3042 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Bestimmt die Filter, die Client-Anfragen und POST-Eingaben
3043 verarbeiten</td></tr>
3044 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>SetInputFilter <var>Filter</var>[;<var>Filter</var>...]</code></td></tr>
3045 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Serverkonfiguration, Virtual Host, Verzeichnis, .htaccess</td></tr>
3046 <tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>FileInfo</td></tr>
3047 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
3048 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
3050 <p>Die Direktive <code class="directive">SetInputFilter</code> bestimmt den oder
3051 die Filter, die Client-Anfragen und POST-Eingaben verarbeiten, wenn
3052 sie vom Server empfangen werden. Diese gelten zusätzlich zu
3053 anderweitig definierten Filtern, einschließlich denen der Direktive
3054 <code class="directive"><a href="../mod/mod_mime.html#addinputfilter">AddInputFilter</a></code>.</p>
3056 <p>Wenn mehr als ein Filter angegeben wird, dann müssen diese
3057 durch Semikolon voneinander getrennt in der Reihenfolge angegeben werden,
3058 in der sie die Daten verarbeiten sollen.</p>
3062 <li><a href="../filter.html">Filter</a>-Dokumentation</li>
3065 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
3066 <div class="directive-section"><h2><a name="SetOutputFilter" id="SetOutputFilter">SetOutputFilter</a>-<a name="setoutputfilter" id="setoutputfilter">Direktive</a></h2>
3067 <table class="directive">
3068 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Bestimmt die Filter, die Antworten des Servers verarbeiten</td></tr>
3069 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>SetOutputFilter <var>Filter</var>[;<var>Filter</var>...]</code></td></tr>
3070 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Serverkonfiguration, Virtual Host, Verzeichnis, .htaccess</td></tr>
3071 <tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>FileInfo</td></tr>
3072 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
3073 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
3075 <p>Die Direktive <code class="directive">SetOutputFilter</code> bestimmt
3076 die Filter, die Antworten des Servers verarbeiten, bevor sie an den
3077 Client gesendet werden. Diese gelten zusätzlich zu anderweitig
3078 definierten Filtern, einschließlich denen der Direktive
3079 <code class="directive"><a href="../mod/mod_mime.html#addoutputfilter">AddOutputFilter</a></code>.</p>
3081 <p>Die folgende Konfiguration verarbeitet zum Beispiel alle Dateien
3082 im Verzeichnis <code>/www/data</code> als Server Side Includes.</p>
3084 <div class="example"><p><code>
3085 <Directory /www/data/><br />
3086 <span class="indent">
3087 SetOutputFilter INCLUDES<br />
3092 <p>Wenn mehr als ein Filter angegeben wird, dann müssen diese
3093 durch Semikolon voneinander getrennt in der Reihenfolge angegeben werden,
3094 in der sie die Daten verarbeiten sollen.</p>
3098 <li><a href="../filter.html">Filter</a>-Dokumentation</li>
3101 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
3102 <div class="directive-section"><h2><a name="TimeOut" id="TimeOut">TimeOut</a>-<a name="timeout" id="timeout">Direktive</a></h2>
3103 <table class="directive">
3104 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Zeitspanne, die der Server auf verschiedene Ereignisse wartet,
3105 bevor er die Anfrage abbricht</td></tr>
3106 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>TimeOut <var>Sekunden</var></code></td></tr>
3107 <tr><th><a href="directive-dict.html#Default">Voreinstellung:</a></th><td><code>TimeOut 300</code></td></tr>
3108 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Serverkonfiguration</td></tr>
3109 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
3110 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
3112 <p>Die Direktive <code class="directive">TimeOut</code> definiert derzeit die
3113 Zeitspanne, die der Apache auf drei Dinge wartet:</p>
3116 <li>Die gesamte Zeispanne, die benötigt wird, um eine GET-Anfrage
3119 <li>Die Zeitspanne zwischen dem Empfang von TCP-Paketen einer
3120 POST- oder PUT-Anfrage.</li>
3122 <li>Die Zeitspanne zwischen ACKs bei der Übermittlung der
3123 TCP-Pakete der Antwort.</li>
3126 <p>Wir haben vor, diese Zeitspannen in Zukunft separat konfigurierbar zu
3127 machen. Vor Version 1.2 war der Zeitgeber auf 1200 voreingestellt, wurde
3128 dann aber auf 300 herabgesetzt, was immer noch weit mehr ist, als in den
3129 meisten Situationen benötigt wird. Die Voreinstellung wurde nicht
3130 weiter herabgesetzt, da gelegentlich noch Stellen im Code existieren
3131 können, wo der Zeitgeber nicht zurückgesetzt wird, wenn ein
3132 Paket verschickt wird.</p>
3135 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
3136 <div class="directive-section"><h2><a name="UseCanonicalName" id="UseCanonicalName">UseCanonicalName</a>-<a name="usecanonicalname" id="usecanonicalname">Direktive</a></h2>
3137 <table class="directive">
3138 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Bestimmt, wie der Server seinen eigenen Namen und Port
3140 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>UseCanonicalName On|Off|DNS</code></td></tr>
3141 <tr><th><a href="directive-dict.html#Default">Voreinstellung:</a></th><td><code>UseCanonicalName On</code></td></tr>
3142 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Serverkonfiguration, Virtual Host, Verzeichnis</td></tr>
3143 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
3144 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
3146 <p>In vielen Situationen muss der Apache eine
3147 <em>selbstreferenzierende</em> URL -- d.h. eine URL, die auf den selben
3148 Server zurück verweist -- zusammenbauen. Bei <code>UseCanonicalName
3149 On</code> verwendet der Apache den Hostnamen und Port, der in der
3150 <code class="directive"><a href="#servername">ServerName</a></code>-Anweisung angegeben ist,
3151 um den kanonischen Namen des Servers zu erstellen. Dieser Name wird in
3152 allen selbstreferenzierenden URLs sowie in CGI-Skripten für die
3153 Werte von <code>SERVER_NAME</code> und <code>SERVER_PORT</code>
3156 <p>Bei <code>UseCanonicalName Off</code> bildet der Apache
3157 selbstreferenzierende URLs, indem er den vom Client übermittelten
3158 Hostnamen und Port verwendet, sofern diese vorhanden sind (andernfalls
3159 wird der kanonische Name, wie oben beschrieben, benutzt). Die Werte
3160 sind die gleichen, die zur Anwendung von <a href="../vhosts/name-based.html">namensbasierten virtuellen Hosts</a>
3161 verwendet werden, und sie sind mit den gleichen Clients verfügbar
3162 <span class="transnote">(<em>Anm.d.Ü.:</em> , die auch in der Lage sind, auf namensbasierte virtuelle Hosts
3163 zuzugreifen, d.h. einen <code>Host</code>-Header mitschicken)</span>.
3164 Die CGI-Variablen <code>SERVER_NAME</code> und <code>SERVER_PORT</code>
3165 werden ebenfalls aus den vom Client angeboten Werten erstellt.</p>
3167 <p>Ein Intranet-Server, auf den Anwender mit kurzen Namen wie
3168 <code>www</code> zugreifen, ist ein Beispiel, wo dies sinnvoll sein kann.
3169 Sie werden bemerken, dass der Apache den Benutzer auf
3170 <code>http://www.domain.com/splat/</code> umleitet, wenn dieser einen
3171 Kurznamen und eine URL, die einem Verzeichnis entspricht, ohne
3172 abschließenden Schrägstrich eingibt, wie z.B.
3173 <code>http://www/splat</code>. Wenn Sie Authentisierung aktiviert haben,
3174 bewirkt dies, dass der Benutzer sich zweimal identifizieren muss
3175 (einmal für <code>www</code> und noch einmal für
3176 <code>www.domain.com</code> -- lesen Sie für weitere Informationen <a href="http://httpd.apache.org/docs/misc/FAQ.html#prompted-twice">die
3177 FAQ zu diesem Thema</a>). Wenn <code class="directive">UseCanonicalName</code>
3178 jedoch auf <code>Off</code> gesetzt ist, denn wird der Apache zu
3179 <code>http://www/splat/</code> umleiten.</p>
3181 <p>Es existiert noch eine dritte Option, <code>UseCanonicalName DNS</code>,
3182 die für den Betrieb von IP-basierten Massen-Virtual-Hosts gedacht ist,
3183 um antiquierte Clients zu unterstützen, die keinen
3184 <code>Host:</code>-Header bereit stellen. Um selbstreferenzierende
3185 URLs zu ermitteln, führt der Apache bei dieser Option ein
3186 Reverse-DNS-Lookup auf die IP-Adresse des Servers aus, zu der der Client
3187 Verbindung aufgenommen hat.</p>
3189 <div class="warning"><h3>Warnung</h3>
3190 <p>Wenn CGI-Skripte Vermutungen aufgrund des Wertes von
3191 <code>SERVER_NAME</code> anstellen, können sie durch diese
3192 Option fehlschlagen. Clients steht es im Wesentlichen frei, einen Wert
3193 für den Hostnamen anzugeben, wie er will. Wenn das
3194 CGI-Skript <code>SERVER_NAME</code> jedoch lediglich dazu verwendet,
3195 selbstreferenzierende URLs zu erstellen, sollte das gerade noch
3196 in Ordnung sein.</p>
3201 <li><code class="directive"><a href="#servername">ServerName</a></code></li>
3202 <li><code class="directive"><a href="../mod/mpm_common.html#listen">Listen</a></code></li>
3205 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
3206 <div class="directive-section"><h2><a name="VirtualHost" id="VirtualHost"><VirtualHost></a>-<a name="virtualhost" id="virtualhost">Direktive</a></h2>
3207 <table class="directive">
3208 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Enthält Direktiven, die nur auf bestimmte Hostnamen oder
3209 IP-Adressen angewendet werden</td></tr>
3210 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code><VirtualHost
3211 <var>Adresse</var>[:<var>Port</var>] [<var>Adresse</var>[:<var>Port</var>]]
3212 ...> ... </VirtualHost></code></td></tr>
3213 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Serverkonfiguration</td></tr>
3214 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
3215 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
3217 <p><code class="directive"><VirtualHost></code> und
3218 <code></VirtualHost></code> werden dazu verwendet, eine Gruppe
3219 von Direktiven zusammenzufassen, die nur auf einen bestimmten virtuellen
3220 Host angewendet werden. Jede Direktive, die im Virtual-Host-Kontext
3221 zulässig ist, kann verwendet werden. Wenn der Server eine Anfrage
3222 für ein bestimmtes Dokument eines bestimmten virtuellen Hosts
3223 empfängt, dann benutzt er die im
3224 <code class="directive"><VirtualHost></code>-Container enthaltenen
3225 Konfigurationsanweisungen. <var>Adresse</var> kann sein:</p>
3228 <li>Die IP-Adresse des virtuellen Hosts.</li>
3230 <li>Ein voll qualifizierter Domainname für die IP-Adresse des
3231 virtuellen Hosts.</li>
3233 <li>Das Zeichen <code>*</code>, welches nur in Kombination mit
3234 <code>NameVirtualHost *</code> verwendet wird, um allen IP-Adressen
3235 zu entsprechen.</li>
3237 <li>Die Zeichenkette <code>_default_</code>, die nur mit IP-basierten
3238 virtuellen Hosts verwendet wird, um nicht zugewiesene IP-Adressen
3242 <div class="example"><h3>Beispiel</h3><p><code>
3243 <VirtualHost 10.1.2.3><br />
3244 <span class="indent">
3245 ServerAdmin webmaster@host.foo.com<br />
3246 DocumentRoot /www/docs/host.foo.com<br />
3247 ServerName host.foo.com<br />
3248 ErrorLog logs/host.foo.com-error_log<br />
3249 TransferLog logs/host.foo.com-access_log<br />
3251 </VirtualHost>
3254 <p>IPv6-Adressen müssen in eckigen Klammern angegeben werden, da die
3255 optionale Portnummer sonst nicht erkannt werden kann. Hier ein
3258 <div class="example"><p><code>
3259 <VirtualHost [fe80::a00:20ff:fea7:ccea]><br />
3260 <span class="indent">
3261 ServerAdmin webmaster@host.example.com<br />
3262 DocumentRoot /www/docs/host.example.com<br />
3263 ServerName host.example.com<br />
3264 ErrorLog logs/host.example.com-error_log<br />
3265 TransferLog logs/host.example.com-access_log<br />
3267 </VirtualHost>
3270 <p>Jeder virtuelle Host muss einer anderen IP-Adresse, einem anderen Port
3271 oder einem anderen Hostnamen für den Server entsprechen. Im ersten
3272 Fall muss die Servermaschine so eingerichtet sein, dass sie IP-Pakete
3273 für mehrere Adressen akzeptiert. (Wenn der Rechner nicht mehrere
3274 Netzwerkkarten besitzt, kann dies mit dem Befehl <code>ifconfig
3275 alias</code> durchgeführt werden -- sofern Ihr Betriebssystem das
3278 <div class="note"><h3>Anmerkung</h3>
3279 <p>Die Verwendung von <code class="directive"><VirtualHost></code>
3280 beeinflusst <strong>nicht</strong>, an welchen Adressen der Apache
3281 lauscht. Sie müssen mit <code class="directive"><a href="../mod/mpm_common.html#listen">Listen</a></code> sicherstellen, dass der Apache
3282 an der richtigen Adresse lauscht.</p>
3285 <p>Bei der Verwendung IP-basierter virtuellen Hosts kann der spezielle
3286 Name <code>_default_</code> benutzt werden. In diesem Fall weist
3287 der Apache jede IP-Adresse diesem virtuellen Host zu, die nicht explizit in
3288 einem anderen virtuellen Host angegeben ist. Falls kein virtueller Host
3289 <code>_default_</code> angegeben ist, wird die "Hauptserver"-Konfiguration,
3290 die aus allen Definitionen außerhalb der Virtual-Host-Abschnitte
3291 besteht, für nicht passende IPs verwendet. (Beachten Sie jedoch,
3292 dass eine IP-Adressen die zu einer <code class="directive"><a href="#namevirtualhost">NameVirtualHost</a></code>-Anweisung passt, weder den
3293 "Hauptserver" noch den virtuellen Host <code>_default_</code> verwendet.
3294 Lesen Sie für weitere Details die Dokumentation zu <a href="../vhosts/name-based.html">namensbasierten virtuell Hosts</a>.)</p>
3296 <p>Sie können einen speziellen <code>:Port</code> angeben,
3297 um den entsprechenden Port zu wechseln. Falls nicht angegeben, wird
3298 er auf den gleichen Port voreingestellt, wie die letzte
3299 <code class="directive"><a href="../mod/mpm_common.html#listen">Listen</a></code>-Anweisung des
3300 Hauptservers. Sie können auch <code>:*</code> angeben, um alle
3301 Ports dieser Adresse zu akzeptieren. (Dies wird zusammen mit
3302 <code>_default_</code> empfohlen.)</p>
3304 <div class="warning"><h3>Sicherheit</h3>
3305 <p>Lesen Sie das Dokument <a href="../misc/security_tips.html">Sicherheitshinweise</a> für
3306 Details, warum Ihre Sicherheit gefährdet sein kann, wenn das
3307 Verzeichnis, in dem Protokolldateien gespeichert werden, für
3308 jemanden anderes als den Benutzer beschreibbar ist, der den Server
3314 <li><a href="../vhosts/">Apache-Dokumentation zu virtuellen
3316 <li><a href="../dns-caveats.html">Probleme bezüglich DNS und
3318 <li><a href="../bind.html">Bestimmen, welche Adressen und Ports
3319 der Apache verwendet</a></li>
3320 <li><a href="../sections.html">Wie die Abschnitte <Directory>,
3321 <Location> und <Files> arbeiten</a> für eine
3322 Erläuterung, wie diese verschiedenen Abschnitte miteinander
3323 kombiniert werden, wenn eine Anfrage empfangen wird</li>
3327 <div class="bottomlang">
3328 <p><span>Verfügbare Sprachen: </span><a href="../de/mod/core.html" title="Deutsch"> de </a> |
3329 <a href="../en/mod/core.html" hreflang="en" rel="alternate" title="English"> en </a> |
3330 <a href="../ja/mod/core.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a></p>
3331 </div><div id="footer">
3332 <p class="apache">Copyright 1999-2004 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>
3333 <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>