1 <?xml version="1.0" encoding="ISO-8859-1"?>
2 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
3 <html xmlns="http://www.w3.org/1999/xhtml" lang="de" xml:lang="de"><head><!--
4 XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
5 This file is generated from xml source: DO NOT EDIT
6 XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
8 <title>core - Apache HTTP Server</title>
9 <link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" />
10 <link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" />
11 <link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" />
12 <link href="../images/favicon.ico" rel="shortcut icon" /></head>
14 <div id="page-header">
15 <p class="menu"><a href="../mod/">Module</a> | <a href="../mod/directives.html">Direktiven</a> | <a href="../faq/">FAQ</a> | <a href="../glossary.html">Glossar</a> | <a href="../sitemap.html">Seitenindex</a></p>
16 <p class="apache">Apache HTTP Server Version 2.3</p>
17 <img alt="" src="../images/feather.gif" /></div>
18 <div class="up"><a href="./"><img title="<-" alt="<-" src="../images/left.gif" /></a></div>
20 <a href="http://www.apache.org/">Apache</a> > <a href="http://httpd.apache.org/">HTTP-Server</a> > <a href="http://httpd.apache.org/docs/">Dokumentation</a> > <a href="../">Version 2.3</a> > <a href="./">Module</a></div>
21 <div id="page-content">
22 <div id="preamble"><h1>Apache-Kernfunktionen</h1>
24 <p><span>Verfügbare Sprachen: </span><a href="../de/mod/core.html" title="Deutsch"> de </a> |
25 <a href="../en/mod/core.html" hreflang="en" rel="alternate" title="English"> en </a> |
26 <a href="../fr/mod/core.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
27 <a href="../ja/mod/core.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
28 <a href="../tr/mod/core.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
30 <table class="module"><tr><th><a href="module-dict.html#Description">Beschreibung:</a></th><td>Ständig verfügbare Kernfunktionen des Apache HTTP
32 <tr><th><a href="module-dict.html#Status">Status:</a></th><td>Core</td></tr></table>
34 <div id="quickview"><h3 class="directives">Direktiven</h3>
36 <li><img alt="" src="../images/down.gif" /> <a href="#acceptpathinfo">AcceptPathInfo</a></li>
37 <li><img alt="" src="../images/down.gif" /> <a href="#accessfilename">AccessFileName</a></li>
38 <li><img alt="" src="../images/down.gif" /> <a href="#adddefaultcharset">AddDefaultCharset</a></li>
39 <li><img alt="" src="../images/down.gif" /> <a href="#addoutputfilterbytype">AddOutputFilterByType</a></li>
40 <li><img alt="" src="../images/down.gif" /> <a href="#allowencodedslashes">AllowEncodedSlashes</a></li>
41 <li><img alt="" src="../images/down.gif" /> <a href="#allowoverride">AllowOverride</a></li>
42 <li><img alt="" src="../images/down.gif" /> <a href="#authname">AuthName</a></li>
43 <li><img alt="" src="../images/down.gif" /> <a href="#authtype">AuthType</a></li>
44 <li><img alt="" src="../images/down.gif" /> <a href="#cgimapextension">CGIMapExtension</a></li>
45 <li><img alt="" src="../images/down.gif" /> <a href="#contentdigest">ContentDigest</a></li>
46 <li><img alt="" src="../images/down.gif" /> <a href="#defaulttype">DefaultType</a></li>
47 <li><img alt="" src="../images/down.gif" /> <a href="#directory"><Directory></a></li>
48 <li><img alt="" src="../images/down.gif" /> <a href="#directorymatch"><DirectoryMatch></a></li>
49 <li><img alt="" src="../images/down.gif" /> <a href="#documentroot">DocumentRoot</a></li>
50 <li><img alt="" src="../images/down.gif" /> <a href="#enablemmap">EnableMMAP</a></li>
51 <li><img alt="" src="../images/down.gif" /> <a href="#enablesendfile">EnableSendfile</a></li>
52 <li><img alt="" src="../images/down.gif" /> <a href="#errordocument">ErrorDocument</a></li>
53 <li><img alt="" src="../images/down.gif" /> <a href="#errorlog">ErrorLog</a></li>
54 <li><img alt="" src="../images/down.gif" /> <a href="#fileetag">FileETag</a></li>
55 <li><img alt="" src="../images/down.gif" /> <a href="#files"><Files></a></li>
56 <li><img alt="" src="../images/down.gif" /> <a href="#filesmatch"><FilesMatch></a></li>
57 <li><img alt="" src="../images/down.gif" /> <a href="#forcetype">ForceType</a></li>
58 <li><img alt="" src="../images/down.gif" /> <a href="#hostnamelookups">HostnameLookups</a></li>
59 <li><img alt="" src="../images/down.gif" /> <a href="#ifdefine"><IfDefine></a></li>
60 <li><img alt="" src="../images/down.gif" /> <a href="#ifmodule"><IfModule></a></li>
61 <li><img alt="" src="../images/down.gif" /> <a href="#include">Include</a></li>
62 <li><img alt="" src="../images/down.gif" /> <a href="#keepalive">KeepAlive</a></li>
63 <li><img alt="" src="../images/down.gif" /> <a href="#keepalivetimeout">KeepAliveTimeout</a></li>
64 <li><img alt="" src="../images/down.gif" /> <a href="#limit"><Limit></a></li>
65 <li><img alt="" src="../images/down.gif" /> <a href="#limitexcept"><LimitExcept></a></li>
66 <li><img alt="" src="../images/down.gif" /> <a href="#limitinternalrecursion">LimitInternalRecursion</a></li>
67 <li><img alt="" src="../images/down.gif" /> <a href="#limitrequestbody">LimitRequestBody</a></li>
68 <li><img alt="" src="../images/down.gif" /> <a href="#limitrequestfields">LimitRequestFields</a></li>
69 <li><img alt="" src="../images/down.gif" /> <a href="#limitrequestfieldsize">LimitRequestFieldSize</a></li>
70 <li><img alt="" src="../images/down.gif" /> <a href="#limitrequestline">LimitRequestLine</a></li>
71 <li><img alt="" src="../images/down.gif" /> <a href="#limitxmlrequestbody">LimitXMLRequestBody</a></li>
72 <li><img alt="" src="../images/down.gif" /> <a href="#location"><Location></a></li>
73 <li><img alt="" src="../images/down.gif" /> <a href="#locationmatch"><LocationMatch></a></li>
74 <li><img alt="" src="../images/down.gif" /> <a href="#loglevel">LogLevel</a></li>
75 <li><img alt="" src="../images/down.gif" /> <a href="#maxkeepaliverequests">MaxKeepAliveRequests</a></li>
76 <li><img alt="" src="../images/down.gif" /> <a href="#namevirtualhost">NameVirtualHost</a></li>
77 <li><img alt="" src="../images/down.gif" /> <a href="#options">Options</a></li>
78 <li><img alt="" src="../images/down.gif" /> <a href="#require">Require</a></li>
79 <li><img alt="" src="../images/down.gif" /> <a href="#rlimitcpu">RLimitCPU</a></li>
80 <li><img alt="" src="../images/down.gif" /> <a href="#rlimitmem">RLimitMEM</a></li>
81 <li><img alt="" src="../images/down.gif" /> <a href="#rlimitnproc">RLimitNPROC</a></li>
82 <li><img alt="" src="../images/down.gif" /> <a href="#satisfy">Satisfy</a></li>
83 <li><img alt="" src="../images/down.gif" /> <a href="#scriptinterpretersource">ScriptInterpreterSource</a></li>
84 <li><img alt="" src="../images/down.gif" /> <a href="#serveradmin">ServerAdmin</a></li>
85 <li><img alt="" src="../images/down.gif" /> <a href="#serveralias">ServerAlias</a></li>
86 <li><img alt="" src="../images/down.gif" /> <a href="#servername">ServerName</a></li>
87 <li><img alt="" src="../images/down.gif" /> <a href="#serverpath">ServerPath</a></li>
88 <li><img alt="" src="../images/down.gif" /> <a href="#serverroot">ServerRoot</a></li>
89 <li><img alt="" src="../images/down.gif" /> <a href="#serversignature">ServerSignature</a></li>
90 <li><img alt="" src="../images/down.gif" /> <a href="#servertokens">ServerTokens</a></li>
91 <li><img alt="" src="../images/down.gif" /> <a href="#sethandler">SetHandler</a></li>
92 <li><img alt="" src="../images/down.gif" /> <a href="#setinputfilter">SetInputFilter</a></li>
93 <li><img alt="" src="../images/down.gif" /> <a href="#setoutputfilter">SetOutputFilter</a></li>
94 <li><img alt="" src="../images/down.gif" /> <a href="#timeout">TimeOut</a></li>
95 <li><img alt="" src="../images/down.gif" /> <a href="#usecanonicalname">UseCanonicalName</a></li>
96 <li><img alt="" src="../images/down.gif" /> <a href="#virtualhost"><VirtualHost></a></li>
100 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
101 <div class="directive-section"><h2><a name="AcceptPathInfo" id="AcceptPathInfo">AcceptPathInfo</a>-<a name="acceptpathinfo" id="acceptpathinfo">Direktive</a></h2>
102 <table class="directive">
103 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Ressourcen lassen angehängte Pfadangaben zu</td></tr>
104 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>AcceptPathInfo On|Off|Default</code></td></tr>
105 <tr><th><a href="directive-dict.html#Default">Voreinstellung:</a></th><td><code>AcceptPathInfo Default</code></td></tr>
106 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Serverkonfiguration, Virtual Host, Verzeichnis, .htaccess</td></tr>
107 <tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>FileInfo</td></tr>
108 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
109 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
110 <tr><th><a href="directive-dict.html#Compatibility">Kompatibilität:</a></th><td>Verfügbar ab Apache 2.0.30</td></tr>
112 <p>Die Direktive steuert, ob Anfragen akzeptiert oder
113 abgewiesen werden, bei denen nach der tatsächlichen
114 Datei (oder einer nicht existierenden Datei in einem existierenden
115 Verzeichnis) zusätzliche Pfadangaben folgen. Die angehängte
116 Pfadangabe kann Skripten in der Umgebungsvariable <code>PATH_INFO</code>
117 verfügbar gemacht werden.</p>
119 <p>Nehmen wir beispielsweise an, dass <code>/test/</code> auf ein
120 Verzeichnis zeigt, welches lediglich eine Datei <code>here.html</code>
121 enthält. Dann wird bei Anfragen nach
122 <code>/test/here.html/more</code> und
123 <code>/test/nothere.html/more</code> beides Mal <code>/more</code>
124 als <code>PATH_INFO</code> ermittelt.</p>
126 <p>Die drei möglichen Argumente für die Direktive
127 <code class="directive">AcceptPathInfo</code> sind:</p>
130 <dt><code>Off</code></dt><dd>Eine Anfrage wird nur dann akzeptiert,
131 wenn sie exakt auf ein existierendes Verzeichnis (oder eine Datei)
132 abgebildet werden kann. Daher würde eine Anfrage mit einer nach dem
133 tatsächlichen Dateinamen angehängten Pfadangabe, wie
134 <code>/test/here.html/more</code> im obigen Beispiel, den Fehler
135 404 NOT FOUND <span class="transnote">(<em>Anm.d.Ü.:</em> nicht gefunden)</span>
138 <dt><code>On</code></dt>
139 <dd>Eine Anfrage wird akzeptiert, wenn eine vorangestellte Pfadangabe
140 auf ein existierendes Verzeichnis abgebildet werden kann. Das
141 obige Beispiel <code>/test/here.html/more</code> wird akzeptiert,
142 wenn <code>/test/here.html</code> auf eine gültige Datei
145 <dt><code>Default</code></dt>
146 <dd>Die Behandlung von Anfragen mit angehängten Pfadangaben
147 wird von dem für die Anfrage verantwortlichen <a href="../handler.html">Handler</a> bestimmt. Der Core-Handler
148 für gewöhnliche Dateien weist <code>PATH_INFO</code>-Zugriffe
149 standardmäßig zurück. Handler, die Skripte bedienen,
150 wie z.B. <a href="mod_cgi.html">cgi-script</a> und
151 <a href="mod_isapi.html">isapi-handler</a>, sind im Allgemeinen darauf
152 voreingestellt, <code>PATH_INFO</code> zu akzeptieren.</dd>
155 <p>Das eigentliche Ziel von <code>AcceptPathInfo</code> ist es, Ihnen
156 das Überschreiben der Voreinstellung der Handler bezüglich
157 der Akzeptanz oder Ablehnung von <code>PATH_INFO</code> zu erlauben.
158 Eine solche Änderung ist zum Beispiel notwendig, wenn Sie einen
159 <a href="../filter.html">Filter</a> wie <a href="mod_include.html">INCLUDES</a> verwenden, um Inhalte
160 abhängig von <code>PATH_INFO</code> zu generieren. Der
161 Core-Handler würde die Anfrage normalerweise abweisen. Verwenden
162 Sie die folgende Konfiguration, um dennoch solch ein Skript zu
165 <div class="example"><p><code>
166 <Files "mypaths.shtml"><br />
167 <span class="indent">
168 Options +Includes<br />
169 SetOutputFilter INCLUDES<br />
170 AcceptPathInfo On<br />
177 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
178 <div class="directive-section"><h2><a name="AccessFileName" id="AccessFileName">AccessFileName</a>-<a name="accessfilename" id="accessfilename">Direktive</a></h2>
179 <table class="directive">
180 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Name der dezentralen Konfigurationsdateien</td></tr>
181 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>AccessFileName <var>Dateiname</var> [<var>Dateiname</var>] ...</code></td></tr>
182 <tr><th><a href="directive-dict.html#Default">Voreinstellung:</a></th><td><code>AccessFileName .htaccess</code></td></tr>
183 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Serverkonfiguration, Virtual Host</td></tr>
184 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
185 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
187 <p>Aus dieser Namensliste sucht der Server während der
188 Bearbeitung einer Anfrage in jedem Verzeichnis nach der ersten
189 existierenden Datei, sofern im betreffenden Verzeichnis dezentrale
190 Konfigurationsdateien <a href="#allowoverride">erlaubt sind</a>.
193 <div class="example"><p><code>
197 <p>Vor der Rücksendung des Dokuments
198 <code>/usr/local/web/index.html</code> wird der Server
199 <code>/.acl</code>, <code>/usr/.acl</code>,
200 <code>/usr/local/.acl</code> und <code>/usr/local/web/.acl</code>
201 einlesen, solange diese nicht mit</p>
203 <div class="example"><p><code>
204 <Directory /><br />
205 <span class="indent">
206 AllowOverride None<br />
211 <p>deaktiviert wurden.</p>
215 <li><code class="directive"><a href="#allowoverride">AllowOverride</a></code></li>
216 <li><a href="../configuring.html">Konfigurationsdateien</a></li>
217 <li><a href="../howto/htaccess.html">.htaccess-Dateien</a></li>
220 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
221 <div class="directive-section"><h2><a name="AddDefaultCharset" id="AddDefaultCharset">AddDefaultCharset</a>-<a name="adddefaultcharset" id="adddefaultcharset">Direktive</a></h2>
222 <table class="directive">
223 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Standard-Charset-Parameter, der bei Antworten vom Content-Type
224 <code>text/plain</code> oder <code>text/html</code> hinzugefügt wird
226 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>AddDefaultCharset On|Off|<var>Zeichenkodierung</var></code></td></tr>
227 <tr><th><a href="directive-dict.html#Default">Voreinstellung:</a></th><td><code>AddDefaultCharset Off</code></td></tr>
228 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Serverkonfiguration, Virtual Host, Verzeichnis, .htaccess</td></tr>
229 <tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>FileInfo</td></tr>
230 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
231 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
233 <p>Die Direktive gibt einen Standardwert für den Charset-Paramter des
234 Medientyps (den Namen einer Zeichencodierung) an, der einer Antwort
235 genau dann hinzugefügt wird, wenn der Content-Type der Antwort entweder
236 <code>text/plain</code> oder <code>text/html</code> ist. Dies sollte jedes
237 mittels <code>META</code>-Element im Datenteil der Antwort angegebene
238 Charset überschreiben. Das genaue Verhalten hängt jedoch oft von
239 der Client-Konfiguration des Benutzers ab. Die Einstellung
240 <code>AddDefaultCharset Off</code> deaktiviert diese Funktionalität.
241 <code>AddDefaultCharset On</code> aktiviert die Standard-Zeichenkodierung
242 <code>iso-8859-1</code>. Jeder andere Wert wird als die zu verwendende
243 <var>Zeichenkodierung</var> aufgefaßt, die eines der bei <a href="http://www.iana.org/assignments/character-sets">IANA registrierten
244 Charset-Werte</a> zur Verwendung in MIME-Medientypen sein sollte. Zum
247 <div class="example"><p><code>
248 AddDefaultCharset utf-8
251 <p><code class="directive">AddDefaultCharset</code> sollte nur verwendet werden,
252 wenn von allen Textressourcen, für die es gilt, bekannt ist, dass sie
253 in dieser Zeichkodierung vorliegen, oder wenn es zu unbequem ist, ihre
254 Zeichenkodierung indivuell zu benennen. Ein solches Beispiel ist das
255 Hinzufügen des Charset-Parameters zu Ressourcen, die generierte
256 Inhalte enthalten. Ein Beispiel sind CGI-Skript-Altlasten, die aufgrund von
257 in die Ausgabe integrierten Daten, die durch den Benutzer übermittelt
258 wurden, gegen Cross-Site-Scripting-Angriffe verwundbar sind. Eine bessere
259 Lösung wäre jedoch, diese Skripte zu korrigieren (oder zu
260 löschen), da die Angabe einer Standard-Zeichencodierung keine
261 Anwender schützt, die in ihrem Browser die Funktion zur
262 automatischen Erkennung der Zeichenkodierung aktiviert haben.</p>
266 <li><code class="directive"><a href="../mod/mod_mime.html#addcharset">AddCharset</a></code></li>
269 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
270 <div class="directive-section"><h2><a name="AddOutputFilterByType" id="AddOutputFilterByType">AddOutputFilterByType</a>-<a name="addoutputfilterbytype" id="addoutputfilterbytype">Direktive</a></h2>
271 <table class="directive">
272 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>einen Ausgabefilter einem bestimmten MIME-Type
274 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>AddOutputFilterByType <var>Filter</var>[;<var>Filter</var>...]
275 <var>MIME-Type</var> [<var>MIME-Type</var>] ...</code></td></tr>
276 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Serverkonfiguration, Virtual Host, Verzeichnis, .htaccess</td></tr>
277 <tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>FileInfo</td></tr>
278 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
279 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
280 <tr><th><a href="directive-dict.html#Compatibility">Kompatibilität:</a></th><td>Verfügbar ab Apache 2.0.33</td></tr>
282 <p>Die Direktive aktiviert für eine Anfrage abhängig vom
283 MIME-Type der Antwort einen bestimmten Ausgabe-<a href="../filter.html">Filter</a>.</p>
285 <p>Das folgende Beispiel verwendet den Filter <code>DEFLATE</code>,
286 der von <code class="module"><a href="../mod/mod_deflate.html">mod_deflate</a></code> angeboten wird. Er komprimiert
287 jede Ausgabe, die als <code>text/html</code> oder <code>text/plain</code>
288 gekennzeichnet ist, (gleichgültig, ob statisch oder dynamisch)
289 bevor sie an den Client gesendet wird.</p>
291 <div class="example"><p><code>
292 AddOutputFilterByType DEFLATE text/html text/plain
295 <p>Wenn Sie den Inhalt von mehr als einem Filter verarbeiten lassen
296 wollen, dann müssen deren Namen durch Semikolons voneinander
297 getrennt werden. Es ist ebenfalls möglich, eine
298 <code class="directive">AddOutputFilterByType</code>-Direktive für
299 jeden von diesen Filtern zu verwenden.</p>
301 <p>Die folgende Konfiguration sorgt dafür, dass alle
302 Skriptausgaben, die als <code>text/html</code> gekennzeichnet
303 sind, zuerst vom <code>INCLUDES</code>-Filter und dann vom
304 <code>DEFLATE</code>-Filter verarbeitet werden.</p>
306 <div class="example"><p><code>
307 <Location /cgi-bin/><br />
308 <span class="indent">
309 Options Includes<br />
310 AddOutputFilterByType INCLUDES;DEFLATE text/html<br />
315 <div class="warning"><h3>Hinweis:</h3>
316 <p>Die Aktivierung von Filtern mittels
317 <code class="directive">AddOutputFilterByType</code> kann in einigen
318 Fällen ganz oder teilweise fehlschlagen. Beispielsweise
319 werden keine Filter angewendet, wenn der MIME-Type nicht bestimmt
320 werden kann und auf die Einstellung der <code class="directive"><a href="#defaulttype">DefaultType</a></code>-Anweisung zurückfällt,
321 selbst wenn die <code class="directive"><a href="#defaulttype">DefaultType</a></code>-Einstellung die gleiche ist.</p>
323 <p>Wenn Sie jedoch sicherstellen wollen, dass der Filter
324 angewendet wird, sollten Sie den Content-Type z.B. mit
325 <code class="directive"><a href="../mod/mod_mime.html#addtype">AddType</a></code> oder
326 <code class="directive"><a href="#forcetype">ForceType</a></code> der Ressource
327 explizit zuordnen. Das Setzen des Content-Types innerhalb
328 eines (nicht-nph) CGI-Skriptes funktioniert ebenfalls
331 <p>Die Typ-gebundenen Ausgabefilter werden niemals auf
332 Proxy-Anfragen angewendet.</p>
337 <li><code class="directive"><a href="../mod/mod_mime.html#addoutputfilter">AddOutputFilter</a></code></li>
338 <li><code class="directive"><a href="#setoutputfilter">SetOutputFilter</a></code></li>
339 <li><a href="../filter.html">Filter</a></li>
342 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
343 <div class="directive-section"><h2><a name="AllowEncodedSlashes" id="AllowEncodedSlashes">AllowEncodedSlashes</a>-<a name="allowencodedslashes" id="allowencodedslashes">Direktive</a></h2>
344 <table class="directive">
345 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Legt fest, ob kodierte Pfadtrennzeichen in URLs durchgereicht
346 werden dürfen</td></tr>
347 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>AllowEncodedSlashes On|Off</code></td></tr>
348 <tr><th><a href="directive-dict.html#Default">Voreinstellung:</a></th><td><code>AllowEncodedSlashes Off</code></td></tr>
349 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Serverkonfiguration, Virtual Host</td></tr>
350 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
351 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
352 <tr><th><a href="directive-dict.html#Compatibility">Kompatibilität:</a></th><td>Verfügbar ab Apache 2.0.46</td></tr>
354 <p>Die <code class="directive">AllowEncodedSlashes</code>-Direktive erlaubt die
355 Verwendung von URLs, welche kodierte Pfadtrennzeichen (<code>%2F</code>
356 für <code>/</code> und auf entsprechenden Systemen zusätzlich
357 <code>%5C</code> für <code>\</code>) enthalten. Normalerweise werden
358 derartige URLs mit einem 404-Fehler (Nicht gefunden) abgewiesen.</p>
360 <p><code class="directive">AllowEncodedSlashes</code> <code>On</code> ist
361 vor allem in Verbindung mit <code>PATH_INFO</code> hilfreich.</p>
363 <div class="note"><h3>Anmerkung</h3>
364 <p>Das Erlauben von Schrägstrichen impliziert <em>nicht</em> deren
365 <em>Dekodierung</em>. Vorkommen von <code>%2F</code> oder <code>%5C</code>
366 (<em>nur</em> auf entsprechenden Systemen) werden unverändert in der
367 ansonsten dekodierten URL belassen.</p>
372 <li><code class="directive"><a href="#acceptpathinfo">AcceptPathInfo</a></code></li>
375 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
376 <div class="directive-section"><h2><a name="AllowOverride" id="AllowOverride">AllowOverride</a>-<a name="allowoverride" id="allowoverride">Direktive</a></h2>
377 <table class="directive">
378 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Direktiven-Typen, die in <code>.htaccess</code>-Dateien
379 erlaubt sind.</td></tr>
380 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>AllowOverride All|None|<var>Direktiven-Typ</var>
381 [<var>Direktiven-Typ</var>] ...</code></td></tr>
382 <tr><th><a href="directive-dict.html#Default">Voreinstellung:</a></th><td><code>AllowOverride All</code></td></tr>
383 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Verzeichnis</td></tr>
384 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
385 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
387 <p>Wenn der Server eine <code>.htaccess</code>-Datei (wie durch
388 <code class="directive"><a href="#accessfilename">AccessFileName</a></code> definiert)
389 findet, muss er wissen, welche in der Datei angegebenen Direktiven
390 frühere Konfigurationsanweisungen überschreiben
393 <div class="note"><h3>Nur in <Directory>-Abschnitten verfügbar</h3>
394 <code class="directive">AllowOverride</code> ist nur in <code class="directive"><a href="#directory"><Directory></a></code>-Abschnitten
395 gültig, die ohne reguläre Ausdrücke definiert wurden, nicht
396 in <code class="directive"><a href="#location"><Location></a></code>-,
397 <code class="directive"><a href="#directorymatch"><DirectoryMatch></a></code>- oder
398 <code class="directive"><a href="#files"><Files></a></code>-Abschnitten.
401 <p>Wenn diese Anweisung auf <code>None</code> gesetzt wird, dann
402 werden <a href="#accessfilename">.htaccess</a>-Dateien komplett
403 ignoriert. In diesem Fall wird der Server nicht einmal versuchen,
404 die <code>.htaccess</code>-Dateien im Dateisystem zu lesen.</p>
406 <p>Wenn diese Anweisung auf <code>All</code> gesetzt wird, dann
407 ist jede Direktive in den <code>.htaccess</code>-Dateien erlaubt,
408 die den <a href="directive-dict.html#Context">Kontext</a>
409 .htaccess besitzt.</p>
411 <p>Der <var>Direktiven-Typ</var> kann eine der folgenden
412 Anweisungsgruppen sein.</p>
418 Erlaubt die Verwendung von Autorisierungs-Anweisungen (<code class="directive"><a href="../mod/mod_authn_dbm.html#authdbmgroupfile">AuthDBMGroupFile</a></code>,
419 <code class="directive"><a href="../mod/mod_authn_dbm.html#authdbmuserfile">AuthDBMUserFile</a></code>,
420 <code class="directive"><a href="../mod/mod_authz_groupfile.html#authgroupfile">AuthGroupFile</a></code>,
421 <code class="directive"><a href="#authname">AuthName</a></code>,
422 <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>
427 Erlaubt die Verwendung von Direktiven zur Steuerung der
428 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>,
429 <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
430 <code class="module"><a href="../mod/mod_mime.html">mod_mime</a></code>-Direktiven Add* und Remove*
436 Erlaubt die Verwendung von Direktiven zur Steuerung von
437 Verzeichnisindizes (<code class="directive"><a href="../mod/mod_autoindex.html#adddescription">AddDescription</a></code>,
438 <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>,
439 <code class="directive"><a href="../mod/mod_autoindex.html#addiconbytype">AddIconByType</a></code>,
440 <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>
446 Erlaubt die Verwendung von Direktiven zur Steuerung des
447 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>
449 <dt>Options[=<var>Option</var>,...]</dt>
452 Erlaubt die Verwendung von Direktiven zur Steuerung spezieller
453 Verzeichniseigenschaften (<code class="directive"><a href="#options">Options</a></code>
454 und <code class="directive"><a href="../mod/mod_include.html#xbithack">XBitHack</a></code>). Sie
455 können mit einem Gleichheitszeichen gefolgt von einer
456 kommaseparierten Liste (ohne Leerzeichen) angeben, welche Optionen mit
457 der <code class="directive"><a href="#options">Options</a></code>-Direktive gesetzt
463 <div class="example"><p><code>
464 AllowOverride AuthConfig Indexes
467 <p>Im obigen Beispiel erzeugen alle Direktiven einen internal server
468 error <span class="transnote">(<em>Anm.d.Ü.:</em> Server-interner Fehler)</span>, die weder der
469 Gruppe <code>AuthConfig</code> noch der Gruppe <code>Indexes</code>
474 <li><code class="directive"><a href="#accessfilename">AccessFileName</a></code></li>
475 <li><a href="../configuring.html">Konfigurationsdateien</a></li>
476 <li><a href="../howto/htaccess.html">.htaccess-Dateien</a></li>
479 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
480 <div class="directive-section"><h2><a name="AuthName" id="AuthName">AuthName</a>-<a name="authname" id="authname">Direktive</a></h2>
481 <table class="directive">
482 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Autorisierungsbereich zur Verwendung in der
483 HTTP-Authentisierung</td></tr>
484 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>AuthName <var>auth-Bereich</var></code></td></tr>
485 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Verzeichnis, .htaccess</td></tr>
486 <tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>AuthConfig</td></tr>
487 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
488 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
490 <p>Die Direktive legt den Namen des Autorisierungsbereiches
491 <span class="transnote">(<em>Anm.d.Ü.:</em> Der Autorisierungsbereich wird auch Realm genannt.)</span>
492 für ein Verzeichnis fest. Dieser Realm wird dem Client mitgeteilt,
493 damit der Anwender weiß, welchen Benutzernamen und welches Passwort
494 er zu übermitteln hat. <code class="directive">AuthName</code> akzeptiert ein
495 Argument. Falls der Name des Realm Leerzeichen enthält, muss er in
496 Anführungszeichen eingeschlossen werden. Um zu funktionieren, muss
497 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
498 Direktiven wie <code class="directive"><a href="../mod/mod_authn_file.html#authuserfile">AuthUserFile</a></code>
499 und <code class="directive"><a href="../mod/mod_authz_groupfile.html#authgroupfile">AuthGroupFile</a></code>
500 begleitet werden.</p>
504 <div class="example"><p><code>
505 AuthName "Top Secret"
508 <p>Die <code>AuthName</code> übergebene Zeichenkette ist das,
509 was in dem von den meisten Browsern angebotenen Passwort-Dialog
514 <li><a href="../howto/auth.html">Authentisierung, Autorisierung und
515 Zugriffskontrolle</a></li>
518 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
519 <div class="directive-section"><h2><a name="AuthType" id="AuthType">AuthType</a>-<a name="authtype" id="authtype">Direktive</a></h2>
520 <table class="directive">
521 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Art der Authentisierung</td></tr>
522 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>AuthType Basic|Digest</code></td></tr>
523 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Verzeichnis, .htaccess</td></tr>
524 <tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>AuthConfig</td></tr>
525 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
526 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
528 <p>Die Direktive wählt die Art der Benutzer-Authentisierung
529 für ein Verzeichnis aus. Derzeit sind lediglich <code>Basic</code>
530 und <code>Digest</code> implementiert.
531 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
532 Direktiven wie <code class="directive"><a href="../mod/mod_authn_file.html#authuserfile">AuthUserFile</a></code>
533 und <code class="directive"><a href="../mod/mod_authz_groupfile.html#authgroupfile">AuthGroupFile</a></code>
534 begleitet werden.</p>
538 <li><a href="../howto/auth.html">Authentisierung, Autorisierung und
539 Zugriffskontrolle</a></li>
542 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
543 <div class="directive-section"><h2><a name="CGIMapExtension" id="CGIMapExtension">CGIMapExtension</a>-<a name="cgimapextension" id="cgimapextension">Direktive</a></h2>
544 <table class="directive">
545 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Technik zur Bestimmung des Interpreters für
546 CGI-Skripte</td></tr>
547 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>CGIMapExtension <var>CGI-Pfad</var> <var>.Endung</var></code></td></tr>
548 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Verzeichnis, .htaccess</td></tr>
549 <tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>FileInfo</td></tr>
550 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
551 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
552 <tr><th><a href="directive-dict.html#Compatibility">Kompatibilität:</a></th><td>ausschließlich NetWare</td></tr>
554 <p>Die Direktive wird zur Steuerung verwendet, wie Apache
555 den Interpreter ermittelt, der zur Ausführung von
556 CGI-Skripten verwendet wird. Beispielsweise bestimmt die Angabe
557 von <code>CGIMapExtension sys:\foo.nlm .foo</code>, dass
558 alle CGI-Scripte mit der Endung <code>.foo</code> an den
559 FOO-Interpreter übergeben werden.</p>
562 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
563 <div class="directive-section"><h2><a name="ContentDigest" id="ContentDigest">ContentDigest</a>-<a name="contentdigest" id="contentdigest">Direktive</a></h2>
564 <table class="directive">
565 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Aktiviert die Generierung von <code>Content-MD5</code>
566 HTTP-Response-Headern</td></tr>
567 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>ContentDigest On|Off</code></td></tr>
568 <tr><th><a href="directive-dict.html#Default">Voreinstellung:</a></th><td><code>ContentDigest Off</code></td></tr>
569 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Serverkonfiguration, Virtual Host, Verzeichnis, .htaccess</td></tr>
570 <tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>Options</td></tr>
571 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
572 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
574 <p>Die Direktive aktiviert die Generierung von
575 <code>Content-MD5</code>-Headern, wie sie in RFC1864 bzw. RFC2616
578 <p>MD5 ist ein Algorithmus zur Berechnung eines "Datenextrakts"
579 (zuweilen "Fingerabdruck" genannt) <span class="transnote">(<em>Anm.d.Ü.:</em> Der "Datenextrakt" wird im
580 Englischen als "message digest" oder "fingerprint" bezeichnet.)</span>
581 aus beliebig langen Daten. Es gilt als zuverlässig, dass
582 Veränderungen an den Daten sich in Veränderungen des
583 Extrakts wiederspiegeln.</p>
585 <p>Der <code>Content-MD5</code>-Header bietet eine
586 End-to-End-Integritätsprüfung (MIC) <span class="transnote">(<em>Anm.d.Ü.:</em> MIC steht für
587 "message integrity check".)</span> des Daten-Inhalts. Ein Proxy oder
588 Client kann diesen Header prüfen, um zufällige Veränderungen
589 des Entity-Inhalts bei der Übertragung festzustellen.
592 <div class="example"><p><code>
593 Content-MD5: AuLb7Dp1rqtRtxz2m9kRpA==
596 <p>Beachten Sie bitte, dass dies Performanceprobleme auf Ihrem
597 System verursachen kann, da der Extrakt bei jeder Anfrage
598 berechnet wird (der Wert wird nicht zwischengespeichert).</p>
600 <p><code>Content-MD5</code> wird nur für Dokumente gesendet,
601 die von <code class="module"><a href="../mod/core.html">core</a></code> bedient werden, nicht jedoch bei
602 Modulen. SSI-Dokumente, CGI-Skript-Ausgaben und Byte-Range-Antworten
603 besitzen diesen Header beispielsweise nicht.</p>
606 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
607 <div class="directive-section"><h2><a name="DefaultType" id="DefaultType">DefaultType</a>-<a name="defaulttype" id="defaulttype">Direktive</a></h2>
608 <table class="directive">
609 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>MIME-Content-Type, der gesendet wird, wenn der Server den Typ
610 nicht auf andere Weise ermitteln kann.</td></tr>
611 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>DefaultType <var>MIME-Type</var></code></td></tr>
612 <tr><th><a href="directive-dict.html#Default">Voreinstellung:</a></th><td><code>DefaultType text/plain</code></td></tr>
613 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Serverkonfiguration, Virtual Host, Verzeichnis, .htaccess</td></tr>
614 <tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>FileInfo</td></tr>
615 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
616 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
618 <p>Es kann vorkommen, dass der Server ein Dokument ausliefern muss,
619 dessen Typ er nicht mit Hilfe seiner MIME-Type-Zuordnungen bestimmen
622 <p>Der Server muss den Client über den Content-Type des
623 Dokumentes informieren. Daher verwendet er im Falle eines
624 unbekannten Typs die <code>DefaultType</code>-Einstellung.
627 <div class="example"><p><code>
628 DefaultType image/gif
631 <p>wäre angemessen für ein Verzeichnis, das viele GIF-Bilder
632 enthält, deren Dateinamen nicht Endung <code>.gif</code>
635 <p>Beachten Sie bitte, dass die Direktive anders als <code class="directive"><a href="#forcetype">ForceType</a></code> lediglich den Standard-MIME-Type
636 bestimmt. Alle anderen MIME-Type-Definitionen, einschließlich
637 Dateierweiterungen, die den Medien-Typ anzeigen können,
638 überschreiben diese Voreinstellung.</p>
641 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
642 <div class="directive-section"><h2><a name="Directory" id="Directory"><Directory></a>-<a name="directory" id="directory">Direktive</a></h2>
643 <table class="directive">
644 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Umschließt eine Gruppe von Direktiven, die nur auf
645 das genannte Verzeichnis des Dateisystems und Unterverzeichnisse angewendet
647 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code><Directory <var>Verzeichnispfad</var>>
648 ... </Directory></code></td></tr>
649 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Serverkonfiguration, Virtual Host</td></tr>
650 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
651 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
653 <p><code class="directive"><Directory></code> und
654 <code></Directory></code> werden dazu verwendet, eine Gruppe
655 von Direktiven zusammenzufassen, die nur für das genannte
656 Verzeichnis und dessen Unterverzeichnisse gelten. Jede Direktive,
657 die im Verzeichnis-Kontext erlaubt ist, kann verwendet werden.
658 <var>Verzeichnispfad</var> ist entweder der vollständige Pfad zu
659 einem Verzeichnis oder eine Zeichenkette mit Platzhaltern wie sie von der
660 Unix-Shell zum Abgleich verwendet werden. In einer Zeichenkette
661 mit Platzhaltern <span class="transnote">(<em>Anm.d.Ü.:</em> sogenannte wild-cards)</span> entspricht
662 <code>?</code> einem einzelnen Zeichen und <code>*</code> einer
663 Zeichenkette beliebiger Länge. Sie können auch auch
664 <code>[]</code>-Zeichenbereiche verwenden. Keiner der Platzhalter
665 entspricht dem Zeichen "/". Daher passt <code><Directory
666 /*/public_html></code> nicht auf <code>/home/user/public_html</code>,
667 <code><Directory /home/*/public_html></code> jedoch tut es.
670 <div class="example"><p><code>
671 <Directory /usr/local/httpd/htdocs><br />
672 <span class="indent">
673 Options Indexes FollowSymLinks<br />
679 <p>Seien Sie vorsichtig mit den <var>Verzeichnispfad</var>-Argumenten.
680 Sie müssen buchstäblich mit dem Dateisystempfad
681 übereinstimmen, den der Apache für den Zugriff auf die
682 Dateien verwendet. Direktiven, die für ein bestimmtes
683 Verzeichnis gelten, gelten nicht für Dateien in dem Verzeichnis,
684 auf die über einen anderen Pfad zugegriffen wird, wie z.B.
685 über verschiedene symbolische Links.</p>
688 <p>Erweiterte reguläre Ausdrücke können ebenfalls
689 verwendet werden, indem das Zeichen <code>~</code> hinzugefügt
690 wird. Beispielsweise würde</p>
692 <div class="example"><p><code>
693 <Directory ~ "^/www/.*/[0-9]{3}">
696 <p>auf Verzeichnisse in <code>/www/</code> passen, die aus drei
699 <p>Wenn mehrere <code class="directive"><Directory></code>-Abschnitte
700 (ohne reguläre Ausdrücke) auf ein Verzeichnis (oder
701 ein ihm übergeordnetes Verzeichnis) passen, welches ein Dokument
702 enthält, dann werden die Direktiven der Reihe nach, angefangen
703 beim kürzesten passenden Muster, vermischt mit den Direktiven
704 aus den <a href="#accessfilename">.htaccess</a>-Dateien, angewendet.
707 <div class="example"><p><code>
708 <Directory /><br />
709 <span class="indent">
710 AllowOverride None<br />
712 </Directory><br />
714 <Directory /home/><br />
715 <span class="indent">
716 AllowOverride FileInfo<br />
721 <p>Beim Zugriff auf das Dokument <code>/home/web/dir/doc.html</code>
722 sind die einzelnen Schritte:</p>
725 <li>Wende die Direktive <code>AllowOverride None</code> an
726 (deaktiviere <code>.htaccess</code>-Dateien).</li>
728 <li>Wende die Direktive <code>AllowOverride FileInfo</code>
729 (auf das Verzeichnis <code>/home</code>) an.</li>
731 <li>Wende jede <code>FileInfo</code>-Direktive aus
732 <code>/home/.htaccess</code>, <code>/home/web/.htaccess</code> und
733 <code>/home/web/dir/.htaccess</code> der Reihe nach an.</li>
736 <p>Reguläre Ausdrücke werden solange nicht berücksichtigt,
737 bis alle normalen Abschnitte angewendet wurden. Anschließend
738 werden alle regulären Ausdrücke in der Reihenfolge
739 geprüft, in der sie in der Konfigurationsdatei auftauchen.
740 Beispielsweise wird bei</p>
742 <div class="example"><p><code>
743 <Directory ~ abc$><br />
744 <span class="indent">
745 # ... hier die Direktiven ...<br />
750 <p>der Abschnitt mit dem regulären Ausdruck nicht
751 berücksichtigt, bis alle normalen
752 <code class="directive"><Directory></code>-Abschnitte und
753 <code>.htaccess</code>-Dateien angewendet wurden. Dann erst wird
754 der reguläre Ausdruck mit <code>/home/abc/public_html/abc</code>
755 abgeglichen und der entsprechende <code class="directive"><Directory></code>-Abschnitt angewendet.</p>
757 <p><strong>Beachten Sie bitte, dass der vom Apache voreingestellte
758 Zugriff für <code><Directory /></code>
759 <code>Allow from All</code> ist. Das bedeutet, dass der Apache
760 jede Datei ausliefert, die durch eine URL abgebildet wird. Es wird
761 empfohlen, dass Sie dies durch einen Block wie</strong></p>
763 <div class="example"><p><code>
764 <Directory /><br />
765 <span class="indent">
766 Order Deny,Allow<br />
772 <p><strong>ändern und anschließend für
773 Verzeichnisse überschreiben, die Sie verfügbar machen
774 <em>wollen</em>. Für weitere Einzelheiten lesen Sie bitte
775 die Seite zu den <a href="../misc/security_tips.html">Sicherheitshinweisen</a>.</strong></p>
777 <p>Die Verzeichnisabschnitte erscheinen in der Datei
778 <code>httpd.conf</code>. <code class="directive"><Directory></code>-Direktiven dürfen nicht
779 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>
783 <li><a href="../sections.html">Wie die Abschnitte <Directory>,
784 <Location> und <Files> arbeiten</a> für eine
785 Erläuterung, wie diese verschiedenen Abschnitte miteinander
786 kombiniert werden, wenn eine Anfrage empfangen wird</li>
789 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
790 <div class="directive-section"><h2><a name="DirectoryMatch" id="DirectoryMatch"><DirectoryMatch></a>-<a name="directorymatch" id="directorymatch">Direktive</a></h2>
791 <table class="directive">
792 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Umschließt eine Gruppe von Direktiven, die auf
793 Verzeichnisse des Dateisystems und ihre Unterverzeichnisse abgebildet
794 werden, welche auf einen regulären Ausdruck passen</td></tr>
795 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code><DirectoryMatch <var>regex</var>>
796 ... </DirectoryMatch></code></td></tr>
797 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Serverkonfiguration, Virtual Host</td></tr>
798 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
799 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
801 <p><code class="directive"><DirectoryMatch></code> und
802 <code></DirectoryMatch></code> werden dazu verwendet, eine
803 Gruppe von Direktiven zusammenzufassen, die nur für das
804 genannte Verzeichnis und dessen Unterverzeichnisse gelten, genauso
805 wie bei <code class="directive"><a href="#directory"><Directory></a></code>.
806 Als Argument dient jedoch ein regulärer Ausdruck.
807 Beispielsweise würde</p>
809 <div class="example"><p><code>
810 <DirectoryMatch "^/www/.*/[0-9]{3}">
813 <p>auf Verzeichnisse in <code>/www/</code> passen, die aus drei
814 Zeichen bestehen.</p>
818 <li><code class="directive"><a href="#directory"><Directory></a></code>
819 für eine Beschreibung, wie reguläre Ausdrücke mit
820 normalen <code class="directive"><Directory></code>-Anweisungen
821 vermischt werden.</li>
822 <li><a href="../sections.html">Wie die Abschnitte <Directory>,
823 <Location> und <Files> arbeiten</a> für eine
824 Erläuterung, wie diese verschiedenen Abschnitte miteinander
825 kombiniert werden, wenn eine Anfrage empfangen wird</li>
828 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
829 <div class="directive-section"><h2><a name="DocumentRoot" id="DocumentRoot">DocumentRoot</a>-<a name="documentroot" id="documentroot">Direktive</a></h2>
830 <table class="directive">
831 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Verzeichnis, welches den Haupt-Dokumentenbaum bildet, der im
832 Web sichtbar ist.</td></tr>
833 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>DocumentRoot <var>Verzeichnis</var></code></td></tr>
834 <tr><th><a href="directive-dict.html#Default">Voreinstellung:</a></th><td><code>DocumentRoot /usr/local/apache/htdocs</code></td></tr>
835 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Serverkonfiguration, Virtual Host</td></tr>
836 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
837 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
839 <p>Die Direktive setzt das Verzeichnis, von dem aus
840 <code class="program"><a href="../programs/httpd.html">httpd</a></code> Dateien ausliefert. Sofern nicht eine Direktive
841 wie <code class="directive"><a href="../mod/mod_alias.html#alias">Alias</a></code> greift, hängt
842 der Server Pfade aus der angeforderten URL an das Wurzelverzeichnis
843 an, um den Pfad zum Dokument zu bilden. Beispiel:</p>
845 <div class="example"><p><code>
846 DocumentRoot /usr/web
849 <p>Damit bezieht sich ein Zugriff auf
850 <code>http://www.my.host.com/index.html</code> auf
851 <code>/usr/web/index.html</code>. Wenn das <var>Verzeichnis</var> nicht
852 absolut angegeben ist, wird es relativ zu <code class="directive"><a href="#serverroot">ServerRoot</a></code> betrachtet.</p>
854 <p><code class="directive">DocumentRoot</code> sollte ohne einen
855 Schrägstrich am Ende angegeben werden.</p>
859 <li><a href="../urlmapping.html">URLs auf das Dateisystem
863 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
864 <div class="directive-section"><h2><a name="EnableMMAP" id="EnableMMAP">EnableMMAP</a>-<a name="enablemmap" id="enablemmap">Direktive</a></h2>
865 <table class="directive">
866 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Verwende Memory-Mapping, um Dateien während der
867 Auslieferung zu lesen</td></tr>
868 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>EnableMMAP On|Off</code></td></tr>
869 <tr><th><a href="directive-dict.html#Default">Voreinstellung:</a></th><td><code>EnableMMAP On</code></td></tr>
870 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Serverkonfiguration, Virtual Host, Verzeichnis, .htaccess</td></tr>
871 <tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>FileInfo</td></tr>
872 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
873 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
875 <p>Die Direktive steuert, ob <code class="program"><a href="../programs/httpd.html">httpd</a></code> Memory-Mapping
876 verwenden darf, wenn er während der Auslieferung den Inhalt einer
877 Datei lesen muss. Wenn die Bearbeitung einer Anfrage es erfordert,
878 auf die Daten in einer Datei zuzugreifen -- zum Beispiel bei der
879 Auslieferung einer mittels <code class="module"><a href="../mod/mod_include.html">mod_include</a></code> serverseitig
880 analysierten Datei --, dann verwendet der Apache standardmäßig
881 Memory-Mapping für diese Datei, sofern das Betriebssystem es
884 <p>Memory-Mapping bedeutet zuweilen eine Performanceverbesserung.
885 In einigen Umgebungen ist es jedoch besser, Memory-Mapping zu
886 deaktivieren, um Problemen während des Betriebs vorzubeugen:</p>
889 <li>Bei einigen Multiprozessorsystemen kann Memory-Mapping die
890 Performance von <code class="program"><a href="../programs/httpd.html">httpd</a></code> reduzieren.</li>
891 <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
892 einem Speicherzugriffsfehler <span class="transnote">(<em>Anm.d.Ü.:</em> ein so genannter "segmentation
893 fault")</span> abstürzen, wenn eine Datei gelöscht oder
894 gekürzt wird, während <code class="program"><a href="../programs/httpd.html">httpd</a></code> sie im Speicher
898 <p>Bei Serverkonfigurationen, die für dieses Problem
899 anfällig sind, sollten Sie das Memory-Mapping für
900 auszuliefernde Dateien deaktivieren, indem Sie schreiben:</p>
902 <div class="example"><p><code>
906 <p>Bei per NFS eingebundenen Dateien kann diese Funktion
907 explizit für die störenden Dateien deaktiviert werden,
908 indem Sie angeben:</p>
910 <div class="example"><p><code>
911 <Directory "/pfad-zu-den-nfs-dateien">
912 <span class="indent">
919 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
920 <div class="directive-section"><h2><a name="EnableSendfile" id="EnableSendfile">EnableSendfile</a>-<a name="enablesendfile" id="enablesendfile">Direktive</a></h2>
921 <table class="directive">
922 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Verwende die sendfile-Unterstützung des Kernels, um
923 Dateien an den Client auszuliefern</td></tr>
924 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>EnableSendfile On|Off</code></td></tr>
925 <tr><th><a href="directive-dict.html#Default">Voreinstellung:</a></th><td><code>EnableSendfile On</code></td></tr>
926 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Serverkonfiguration, Virtual Host, Verzeichnis, .htaccess</td></tr>
927 <tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>FileInfo</td></tr>
928 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
929 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
930 <tr><th><a href="directive-dict.html#Compatibility">Kompatibilität:</a></th><td>Verfügbar ab Apache Version 2.0.44</td></tr>
932 <p>Die Direktive steuert, ob <code class="program"><a href="../programs/httpd.html">httpd</a></code> die
933 sendfile-Unterstützung des Kernels verwenden kann, um
934 Dateiinhalte an den Client zu übermitteln. Wenn die Bearbeitung
935 einer Anfrage keinen Zugriff auf die Daten in der Datei erfordert --
936 zum Beispiel bei der Auslieferung einer statischen Datei -- und das
937 Betriebssystem es unterstützt, verwendet der Apache
938 standardmäßig sendfile, um den Dateiinhalt zu
939 übertragen, ohne die Datei jemals zu lesen.</p>
941 <p>Der sendfile-Mechanismus vermeidet getrennte Lese- und
942 Sendeoperationen sowie Puffer-Zuweisungen. Bei einigen Plattformen bzw.
943 Dateisystemen deaktivieren Sie diese Funktion jedoch besser, um Probleme
944 während des Betriebs zu vermeiden:</p>
947 <li>Einige Plattformen besitzen u.U. eine fehlerhafte
948 sendfile-Unterstützung, die das Erstellungssystem nicht erkennt,
949 insbesondere wenn die Binärdateien auf einem anderen Rechner erstellt
950 und auf eine solche Maschine mit fehlerhafter sendfile-Unterstützung
951 übertragen wurden.</li>
952 <li>Bei einem über das Netzwerk eingebundenen <code class="directive"><a href="#documentroot">DocumentRoot</a></code> (z.B. NFS oder SMB) ist der
953 Kernel möglicherweise nicht in der Lage, die Netzwerkdatei
954 über seinen eigenen Cache zu bedienen.</li>
955 <li>Unter Linux löst die Verwendung von <code>sendfile</code>
956 in Verbindung mit bestimmten Netzwerkkarten und IPv6
957 TCP-Checksummenfehler aus.</li>
960 <p>Bei Serverkonfigurationen, die für dieses Problam
961 anfällig sind, sollten die diese Funktion deaktivieren, indem
964 <div class="example"><p><code>
968 <p>Bei per NFS oder SMB eingebundenen Dateien kann diese Funktion
969 explizit für die störenden Dateien deaktiviert werden, indem
972 <div class="example"><p><code>
973 <Directory "/pfad-zu-den-nfs-dateien">
974 <span class="indent">
979 <p>Beachten Sie bitte, dass die verzeichnisbasierte und
980 .htaccess-Konfiguration von <code class="directive">EnableSendfile</code>
981 nicht vom <code class="module"><a href="../mod/mod_disk_cache.html">mod_disk_cache</a></code>-Modul unterstützt wird.
982 Nur die globale Konfiguration von <code class="directive">EnableSendfile</code>
983 wird vom Modul beachtet.
987 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
988 <div class="directive-section"><h2><a name="ErrorDocument" id="ErrorDocument">ErrorDocument</a>-<a name="errordocument" id="errordocument">Direktive</a></h2>
989 <table class="directive">
990 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Das, was der Server im Fehlerfall an den Client
992 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>ErrorDocument <var>Fehlercode</var> <var>Dokument</var></code></td></tr>
993 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Serverkonfiguration, Virtual Host, Verzeichnis, .htaccess</td></tr>
994 <tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>FileInfo</td></tr>
995 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
996 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
997 <tr><th><a href="directive-dict.html#Compatibility">Kompatibilität:</a></th><td>Die Syntax der Anführungszeichen bei Textnachrichten hat
998 sich im Apache 2.0 geändert</td></tr>
1000 <p>Im Falle eines Problems oder Fehlers kann der Apache
1001 konfiguriert werden, eine der vier Aktionen auszuführen:</p>
1004 <li>Ausgabe einer einfachen, hartkodierten Fehlermeldung</li>
1006 <li>Ausgabe einer angepassten Meldung</li>
1008 <li>Umleitung zu einem lokalen <var>URL-Pfad</var> der das
1009 Problem bzw. den Fehler behandelt</li>
1011 <li>Umleitung zu einer externen <var>URL</var>, die das Problem
1012 bzw. den Fehler behandelt</li>
1015 <p>Die erste Option ist Voreinstellung, während die Optionen
1016 2 bis 4 über die Direktive <code class="directive">ErrorDocument</code>
1017 eingestellt werden, welcher der HTTP-Statuscode und eine
1018 URL oder Nachricht folgen. Abhängig vom Problem bzw. Fehler bietet
1019 der Apache manchmal zusätzliche Informationen an.</p>
1021 <p>URLs können bei lokalen Webpfaden mit einem Schrägstrich
1022 (/) beginnen (relativ zum <code class="directive"><a href="#documentroot">DocumentRoot</a></code>-Verzeichnis) oder eine vollständige URL
1023 bilden, die der Client auflösen kann. Alternativ kann eine
1024 Nachricht für die Anzeige im Browser angeboten werden. Beispiel:</p>
1026 <div class="example"><p><code>
1027 ErrorDocument 500 http://foo.example.com/cgi-bin/tester<br />
1028 ErrorDocument 404 /cgi-bin/falsche_urls.pl<br />
1029 ErrorDocument 401 /info_zur_anmeldung.html<br />
1030 ErrorDocument 403 "Der Zugriff ist nicht erlaubt."
1033 <p>Außerdem kann der spezielle Wert <code>default</code> angegeben
1034 werden, um die schlichte, hartkodierte Nachricht des Apache zu verwenden.
1035 Es wird normalerweise nicht benötigt, doch <code>default</code>
1036 stellt die einfach, im Apache hartkodierte Meldung in Konfigurationen
1037 wieder her, die ansonsten von einem existierenden <span class="transnote">(<em>Anm.d.Ü.:</em> zuvor
1038 konfigurierten)</span> <code class="directive">ErrorDocument</code> erben
1041 <div class="example"><p><code>
1042 ErrorDocument 404 /cgi-bin/bad_urls.pl<br /><br />
1043 <Directory /web/docs><br />
1044 <span class="indent">
1045 ErrorDocument 404 default<br />
1050 <p>Wenn Sie eine <code class="directive">ErrorDocument</code>-Anweisung
1051 angeben, die auf eine entfernte URL weist (d.h. irgendetwas mit der
1052 Methode <code>http</code> davor), beachten Sie bitte, dass der Apache
1053 eine Umleitung zum Client sendet, um diesem mitzuteilen, wo das
1054 Dokument zu finden ist, auch wenn das Dokument letztlich wieder zum
1055 gleichen Server führt. Das hat mehrere Auswirkungen. Die
1056 wichtigste ist, dass der Client nicht den Original-Statuscode
1057 erhält sondern statt dessen einen Umleitungs-Statuscode. Dies
1058 wiederum kann Web-Robots und andere Clients verwirren, die den
1059 Statuscode dazu verwenden, herauszufinden ob eine URL gültig ist.
1060 Wenn Sie eine entfernte URL in einer Anweisung
1061 <code>ErrorDocument 401</code> verwenden, wird der Client
1062 darüber hinaus nicht wissen, dass er den Benutzer zur Eingabe
1063 eines Passwortes auffordern muss, da er den Statuscode 401 nicht
1064 erhält. <strong>Deshalb müssen Sie sich auf ein lokales
1065 Dokument beziehen, wenn Sie eine Anweisung <code>ErrorDocument
1066 401</code> verwenden.</strong></p>
1068 <p>Der Microsoft Internet Explorer (MSIE) ignoriert
1069 standardmäßig serverseitig generierte Fehlermeldungen, wenn
1070 sie "zu kurz" sind und ersetzt sie durch eigene "freundliche"
1071 Fehlermeldungen. Die Größe variiert abhängig von der
1072 Art des Fehlers, im Allgemeinen zeigt der MSIE jedoch den
1073 serverseitig generierten Fehler, anstatt ihn zu verstecken, wenn Ihr
1074 Fehlerdokument größer als 512 Bytes ist. Weitere Informationen
1075 sind im Artikel <a href="http://support.microsoft.com/default.aspx?scid=kb;en-us;Q294807">Q294807</a> in der Microsoft Knowledgebase verfügbar.</p>
1077 <p>Obwohl die meisten Fehlermeldungen überschrieben werden
1078 können, werden unter bestimmten Umständen die internen
1079 Meldungen ungeachtet der Einstellung der <code class="directive"><a href="#errordocument">ErrorDocument</a></code>-Direktive verwendet. Insbesondere bei
1080 einer fehlerhaften Anfrage werden der normale Bearbeitungsprozess sofort
1081 beendet und die interne Meldung zurückgegeben. Das ist notwendig, um
1082 Sicherheitsprobleme zu vermeiden, die auf Grund fehlerhafter Anfragen
1085 <p>In Versionen vor 2.0 wurden Meldungen durch ein einzelnes
1086 vorangestelltes Anführungszeichen (") erkannt.</p>
1090 <li><a href="../custom-error.html">Dokumentation zu individuellen
1091 Fehlermeldungen</a></li>
1094 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
1095 <div class="directive-section"><h2><a name="ErrorLog" id="ErrorLog">ErrorLog</a>-<a name="errorlog" id="errorlog">Direktive</a></h2>
1096 <table class="directive">
1097 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Ablageort, an dem der Server Fehler protokolliert</td></tr>
1098 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code> ErrorLog <var>Dateiname</var>|syslog[:<var>facility</var>]</code></td></tr>
1099 <tr><th><a href="directive-dict.html#Default">Voreinstellung:</a></th><td><code>ErrorLog logs/error_log (Unix) ErrorLog logs/error.log (Windows and
1100 OS/2)</code></td></tr>
1101 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Serverkonfiguration, Virtual Host</td></tr>
1102 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
1103 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
1105 <p>Die Direktive <code class="directive">ErrorLog</code> bestimmt den Namen
1106 der Datei, in welcher der Server alle auftretenden Fehler protokolliert.
1107 Wenn <var>Dateiname</var> nicht absolut ist, wird er relativ zu <code class="directive"><a href="#serverroot">ServerRoot</a></code> betrachtet.</p>
1109 <div class="example"><h3>Beispiel</h3><p><code>
1110 ErrorLog /var/log/httpd/error_log
1113 <p>Wenn der <var>Dateiname</var> mit einem senkrechten Strich (|,
1114 engl.: Pipe) beginnt, wird angenommen, dass es sich um einen Befehl
1115 handelt, der ausgeführt wird, um das Fehlerprotokolls zu
1118 <div class="example"><h3>Beispiel</h3><p><code>
1119 ErrorLog "|/usr/local/bin/httpd_errors"
1122 <p>Die Verwendung von <code>syslog</code> anstelle eines Dateinamens
1123 aktiviert die Protokollierung mittels syslogd(8), sofern das System
1124 es unterstützt. Als Voreinstellung wird der syslog-Typ (syslog
1125 facility) <code>local7</code> verwendet, Sie können dies jedoch
1126 auch überschreiben, indem Sie die Syntax
1127 <code>syslog:<var>facility</var></code> verwenden, wobei
1128 <var>facility</var> einer der Namen sein kann, die üblicherweise
1129 in syslog(1) dokumentiert sind.</p>
1131 <div class="example"><h3>Beispiel</h3><p><code>
1132 ErrorLog syslog:user
1135 <p>SICHERHEITSHINWEIS: Lesen Sie das Dokument <a href="../misc/security_tips.html#serverroot">Sicherheitshinweise</a>
1136 zu Einzelheiten darüber, warum Ihre Sicherheit gefährdet
1137 sein kann, wenn das Verzeichnis, in dem die Log-Dateien gespeichert
1138 werden, für jemand anderen, als den Benutzer, der den Server
1139 gestartet hat, beschreibbar ist.</p>
1141 <div class="warning"><h3>Anmerkung</h3>
1142 <p>Bei der Eingabe eines Dateipfads auf nicht-Unix-Plattformen sollte
1143 darauf geachtet werden, nur (Vorwärts-)Schrägstriche zu
1144 verwenden, auch wenn die Plattform rückwärts gerichtete
1145 Schrägstriche (Backslashes) erlaubt. Im Allgemeinen ist es eine gute
1146 Idee, innerhalb der Konfigurationsdateien immer
1147 Vorwärts-Schrägstriche zu verwenden.</p>
1152 <li><code class="directive"><a href="#loglevel">LogLevel</a></code></li>
1153 <li><a href="../logs.html">Apache-Log-Dateien</a></li>
1156 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
1157 <div class="directive-section"><h2><a name="FileETag" id="FileETag">FileETag</a>-<a name="fileetag" id="fileetag">Direktive</a></h2>
1158 <table class="directive">
1159 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Dateiattribute, die zur Erstellung des HTTP-Response-Headers
1160 ETag verwendet werden</td></tr>
1161 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>FileETag <var>Komponente</var> ...</code></td></tr>
1162 <tr><th><a href="directive-dict.html#Default">Voreinstellung:</a></th><td><code>FileETag INode MTime Size</code></td></tr>
1163 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Serverkonfiguration, Virtual Host, Verzeichnis, .htaccess</td></tr>
1164 <tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>FileInfo</td></tr>
1165 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
1166 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
1168 <p>Wenn dem Dokument eine Datei zugrundeliegt, bestimmt die Direktive
1169 <code class="directive">FileETag</code> die Dateiattribute, die zur Erstellung
1170 des HTTP-Response-Headers <code>ETag</code> (Entity-Tag) verwendet
1171 werden. (Der Wert von <code>ETag</code> wird bei der Cache-Verwaltung
1172 zur Einsparung von Netzwerk-Bandbreite benutzt.) Im Apache 1.3.22 und
1173 früher wurde der <code>ETag</code>-Wert <em>stets</em> aus
1174 der I-Node, der Größe und dem Datum der letzten
1175 Änderung (mtime) der Datei gebildet. Die Direktive
1176 <code class="directive">FileETag</code> erlaubt es Ihnen, zu bestimmen,
1177 welche dieser Eigenschaften -- falls überhaupt -- verwendet
1178 werden sollen. Die gültigen Schlüsselworte lauten:</p>
1181 <dt><strong>INode</strong></dt>
1182 <dd>Die I-Node-Nummer wird in die Berechnung mit einbezogen</dd>
1183 <dt><strong>MTime</strong></dt>
1184 <dd>Datum und Uhrzeit der letzten Änderung werden mit einbezogen</dd>
1185 <dt><strong>Size</strong></dt>
1186 <dd>Die Anzahl der Bytes in der Datei wird mit einbezogen</dd>
1187 <dt><strong>All</strong></dt>
1188 <dd>Alle verfügbaren Angaben werden verwendet. Die ist
1189 gleichbedeutend mit:
1190 <div class="example"><p><code>FileETag INode MTime Size</code></p></div></dd>
1191 <dt><strong>None</strong></dt>
1192 <dd>Es wird keine <code>ETag</code>-Angabe in die Antwort eingefügt,
1193 wenn dem Dokument eine Datei zugrundeliegt.</dd>
1196 <p>Den Schlüsselwörtern <code>INode</code>, <code>MTime</code>
1197 und <code>Size</code> kann entweder ein <code>+</code> oder ein
1198 <code>-</code> vorangestellt werden, was die Änderung einer
1199 Vorgabe erlaubt, die von einem größeren Umfeld
1200 geerbt wurde. Jedes Schlüselwort ohne ein solches Prefix
1201 hebt die ererbte Einstellung sofort und vollständig auf.</p>
1203 <p>Wenn die Konfiguration für ein Verzeichnis
1204 <code>FileETag INode MTime Size</code> enthält
1205 und die eines Unterverzeichnisses <code>FileETag -INode</code>,
1206 dann ist die Einstellung für das Unterverzeichnis (die an
1207 jedes Unter-Unterverzeichnis weitervererbt wird, welches dies nicht
1208 überschreibt) äquivalent mit
1209 <code>FileETag MTime Size</code>.</p>
1212 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
1213 <div class="directive-section"><h2><a name="Files" id="Files"><Files></a>-<a name="files" id="files">Direktive</a></h2>
1214 <table class="directive">
1215 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Enthält Direktiven, die sich nur auf passende Dateinamen
1217 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code><Files <var>Dateiname</var>> ... </Files></code></td></tr>
1218 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Serverkonfiguration, Virtual Host, Verzeichnis, .htaccess</td></tr>
1219 <tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>All</td></tr>
1220 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
1221 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
1223 <p>Die Direktive <code class="directive"><Files></code>
1224 begrenzt die Reichweite der enthaltenen Anweisungen auf Dateinamen.
1225 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
1226 passende <code></Files></code>-Anweisung besitzen.
1227 Die innerhalb dieses Abschnittes angegebenen Direktiven werden auf
1228 jedes Objekt mit einem Basisnamen (letzte Komponente des Dateinamens)
1229 angewendet, der auf die angegebenen Dateinamen passt. <code class="directive"><Files></code>-Container werden, nachdem die
1230 <code class="directive"><a href="#directory"><Directory></a></code>-Container
1231 und <code>.htaccess</code>-Dateien gelesen sind, jedoch vor den
1232 <code class="directive"><a href="#location"><Location></a></code>-Containern,
1233 in der Reihenfolge ihres Auftretens ausgeführt. Beachten Sie, dass
1234 <code class="directive"><Files></code>-Anweisungen innerhalb von
1235 <code class="directive"><a href="#directory"><Directory></a></code>-Containern
1236 auftreten können, um den Teil des Dateisystems einzuschränken,
1237 den sie betreffen.</p>
1239 <p>Das Argument <var>Dateiname</var> kann einen Dateinamen oder eine
1240 Zeichenkette mit Platzhaltern enthalten, wobei <code>?</code> auf ein
1241 einzelnes Zeichen passt und <code>*</code> auf eine beliebige Folge von
1242 Zeichen. Erweiterte reguläre Ausdrücke können ebenfalls
1243 verwendet werden, indem das Zeichen <code>~</code> hinzugefügt wird.
1244 Beispielsweise würde</p>
1246 <div class="example"><p><code>
1247 <Files ~ "\.(gif|jpe?g|png)$">
1250 <p>auf die gebräuchlichsten Grafikformate im Internet passen.
1251 <code class="directive"><a href="#filesmatch"><FilesMatch></a></code> wird
1252 jedoch bevorzugt.</p>
1254 <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
1255 von <code>.htaccess</code>-Dateien verwendet werden können.
1256 Dies erlaubt den Anwendern auf Dateiebene die Kontrolle über ihre
1257 eigenen Dateien.</p>
1261 <li><a href="../sections.html">Wie die Abschnitte <Directory>,
1262 <Location> und <Files> arbeiten</a> für eine
1263 Erläuterung, wie diese verschiedenen Abschnitte miteinander
1264 kombiniert werden, wenn eine Anfrage empfangen wird</li>
1267 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
1268 <div class="directive-section"><h2><a name="FilesMatch" id="FilesMatch"><FilesMatch></a>-<a name="filesmatch" id="filesmatch">Direktive</a></h2>
1269 <table class="directive">
1270 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Enthält Direktiven, die für Dateinamen gelten, die
1271 auf einen regulären Ausdruck passen</td></tr>
1272 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code><FilesMatch <var>regex</var>> ... </FilesMatch></code></td></tr>
1273 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Serverkonfiguration, Virtual Host, Verzeichnis, .htaccess</td></tr>
1274 <tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>All</td></tr>
1275 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
1276 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
1278 <p>Die Direktive <code class="directive"><FilesMatch></code>
1279 begrenzt wie die Direktive <code class="directive"><a href="#files"><Files></a></code> die enthaltenen Anweisungen auf
1280 Dateinamen. Sie akzeptiert jedoch reguläre Ausdrücke.
1281 Beispielsweise würde</p>
1283 <div class="example"><p><code>
1284 <FilesMatch "\.(gif|jpe?g|png)$">
1287 <p>auf die gebräuchlichsten Grafikformate im Internet passen.</p>
1291 <li><a href="../sections.html">Wie die Abschnitte <Directory>,
1292 <Location> und <Files> arbeiten</a> für eine
1293 Erläuterung, wie diese verschiedenen Abschnitte miteinander
1294 kombiniert werden, wenn eine Anfrage empfangen wird</li>
1297 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
1298 <div class="directive-section"><h2><a name="ForceType" id="ForceType">ForceType</a>-<a name="forcetype" id="forcetype">Direktive</a></h2>
1299 <table class="directive">
1300 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Erzwingt die Auslieferung aller passendenden Dateien mit dem
1301 angegebenen MIME-Content-Type</td></tr>
1302 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>ForceType <var>MIME-Type</var>|None</code></td></tr>
1303 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Verzeichnis, .htaccess</td></tr>
1304 <tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>FileInfo</td></tr>
1305 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
1306 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
1307 <tr><th><a href="directive-dict.html#Compatibility">Kompatibilität:</a></th><td>Wurde im Apache 2.0 in den Core verschoben</td></tr>
1309 <p>Wenn sie innerhalb einer <code>.htaccess</code>-Datei, eines
1310 <code class="directive"><a href="#directory"><Directory></a></code>-,
1311 <code class="directive"><a href="#location"><Location></a></code>-
1312 <code class="directive"><a href="#files"><Files></a></code>-Containers
1313 angegeben wird, erzwingt die Direktive die Auslieferung aller
1314 entsprechenden Dateien mit dem Content-Type, der durch
1315 <var>MIME-Type</var> definiert wurde. Wenn Sie zum Beispiel ein
1316 Verzeichnis voller GIF-Dateien haben, die Sie nicht alle durch
1317 <code>.gif</code> kennzeichnen wollen, können Sie angeben:</p>
1319 <div class="example"><p><code>
1323 <p>Beachten Sie bitte, dass die Direktive anders als <code class="directive"><a href="#defaulttype">DefaultType</a></code> alle MIME-Type-Zuordnungen
1324 überschreibt, einschließlich Dateiendungen, die einen
1325 Medientyp bezeichnen könnten.</p>
1327 <p>Sie können jede <code class="directive">ForceType</code>-Angabe
1328 durch die Verwendung des Wertes <code>None</code> überschreiben:</p>
1330 <div class="example"><p><code>
1331 # erzwinge image/gif für alle Dateien:<br />
1332 <Location /images><br />
1333 <span class="indent">
1334 ForceType image/gif<br />
1336 </Location><br />
1338 # hier jedoch normale MIME-Type-Zuordnungen:<br />
1339 <Location /images/mixed><br />
1340 <span class="indent">
1341 ForceType None<br />
1347 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
1348 <div class="directive-section"><h2><a name="HostnameLookups" id="HostnameLookups">HostnameLookups</a>-<a name="hostnamelookups" id="hostnamelookups">Direktive</a></h2>
1349 <table class="directive">
1350 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Aktiviert DNS-Lookups auf Client-IP-Adressen</td></tr>
1351 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>HostnameLookups On|Off|Double</code></td></tr>
1352 <tr><th><a href="directive-dict.html#Default">Voreinstellung:</a></th><td><code>HostnameLookups Off</code></td></tr>
1353 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Serverkonfiguration, Virtual Host, Verzeichnis</td></tr>
1354 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
1355 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
1357 <p>Diese Direktive aktiviert die DNS-Abfrage <span class="transnote">(<em>Anm.d.Ü.:</em> ein sogenannter
1358 DNS-Lookup)</span>, so dass Hostnamen protokolliert (und in
1359 <code>REMOTE_HOST</code> an CGIs/SSIs übergeben) werden könnnen.
1360 Der Wert <code>Double</code> bezieht sich auf ein
1361 Double-Reverse-DNS-Lookup. D.h. nachdem ein Reverse-Lookup
1362 durchgeführt wurde, wird dann auf dem Ergebnis ein
1363 Forward-Lookup ausgeführt. Wenigstens eine der IP-Adressen
1364 aus dem Forward-Lookup muss der Originaladresse entsprechen.
1365 (In der "tcpwrappers"-Terminologie wird dies <code>PARANOID</code>
1368 <p>Unabhängig von der Einstellung wird ein Double-Reverse-Lookup
1369 durchgeführt, wenn <code class="module"><a href="../mod/mod_authz_host.html">mod_authz_host</a></code> zur
1370 Zugriffskontrolle per Hostnamen eingesetzt wird. Dies ist aus
1371 Sicherheitsgründen notwendig. Beachten Sie, dass das Ergebnis dieses
1372 Double-Reverse-Lookups nicht generell verfügbar ist, solange Sie
1373 nicht <code>HostnameLookups Double</code> setzen. Wenn beispielsweise
1374 nur <code>HostnameLookups On</code> angegeben ist und eine Anfrage
1375 für ein Objekt erfolgt, welches durch Hostnamen-Beschränkungen
1376 geschützt ist, dann wird CGIs nur das Ergebnis des
1377 Singel-Reverse-Lookups in <code>REMOTE_HOST</code> übergeben,
1378 egal ob das Doble-Reverse-Lookup fehlschlug oder nicht.</p>
1380 <p>Die Voreinstellung ist <code>Off</code>, um Netzwerktraffic bei den
1381 Angeboten einzusparen, die nicht tatsächlich Reverse-Lookups
1382 benötigen. Es ist auch für die Endanwender besser, da sie nicht
1383 die zusätzliche Wartezeit ertragen müssen, die ein Lookup mit
1384 sich bringt. Hoch frequentierte Angebote sollten diese Direktive auf
1385 <code>Off</code>lassen. Das Hilfsprogramm <code class="program"><a href="../programs/logresolve.html">logresolve</a></code>, das standardmäßig in das
1386 Unterverzeichnis <code>bin</code> Ihres Installationsverzeichnisses
1387 kompiliert wird, kann dazu verwendet werden, um offline Hostnamen von
1388 protokollierten IP-Adressen nachzuschlagen.</p>
1391 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
1392 <div class="directive-section"><h2><a name="IfDefine" id="IfDefine"><IfDefine></a>-<a name="ifdefine" id="ifdefine">Direktive</a></h2>
1393 <table class="directive">
1394 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Schließt Direktiven ein, die nur ausgeführt werden,
1395 wenn eine Testbedingung beim Start wahr ist</td></tr>
1396 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code><IfDefine [!]<var>Parametername</var>> ...
1397 </IfDefine></code></td></tr>
1398 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Serverkonfiguration, Virtual Host, Verzeichnis, .htaccess</td></tr>
1399 <tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>All</td></tr>
1400 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
1401 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
1403 <p>Der Container <code><IfDefine <var>Test</var>>...</IfDefine>
1404 </code> wird dazu verwendet, Direktiven als bedingt zu kennzeichnen.
1405 Die Direktiven innerhalb eines <code class="directive"><IfDefine></code>-Abschnittes werden nur ausgeführt,
1406 wenn <var>Test</var> wahr ist. Ist <var>Test</var> falsch, wird alles
1407 zwischen der Start- und Endemarkierung ignoriert.</p>
1409 <p>In der <code class="directive"><IfDefine></code>-Anweisung kann
1410 <var>Test</var> eine von zwei Formen annehmen:</p>
1413 <li><var>Parametername</var></li>
1415 <li><code>!</code><var>Parametername</var></li>
1418 <p>Im ersten Fall werden die Direktiven zwischen der Start- und
1419 Endemarkierung nur ausgeführt, wenn der Parameter namens
1420 <var>Parametername</var> definiert ist. Die zweite Form kehrt den
1421 Test um und führt die Direktiven nur dann aus, wenn
1422 <var>Parametername</var> <strong>nicht</strong> definiert ist.</p>
1424 <p>Das Argument <var>Parametername</var> ist ein sogenanntes
1425 "Define", das beim beim Start des Servers in der
1426 <code class="program"><a href="../programs/httpd.html">httpd</a></code>-Befehlszeile durch
1427 <code>-D<var>Parameter</var></code> angegeben wird.</p>
1429 <p><code class="directive"><IfDefine></code>-Container können
1430 ineinander verschachtelt werden, um einfache Multi-Parameter-Tests
1431 zu implementieren. Beispiel:</p>
1433 <div class="example"><p><code>
1434 httpd -DReverseProxy ...<br />
1437 <IfDefine ReverseProxy><br />
1438 <span class="indent">
1439 LoadModule rewrite_module modules/mod_rewrite.so<br />
1440 LoadModule proxy_module modules/libproxy.so<br />
1446 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
1447 <div class="directive-section"><h2><a name="IfModule" id="IfModule"><IfModule></a>-<a name="ifmodule" id="ifmodule">Direktive</a></h2>
1448 <table class="directive">
1449 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Schließt Direktiven ein, die abhängig vom
1450 Vorhandensein oder Fehlen eines speziellen Moduls ausgeführt
1452 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code><IfModule [!]<var>Modulname</var>|<var>Modulbezeichner</var>>
1453 ... </IfModule></code></td></tr>
1454 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Serverkonfiguration, Virtual Host, Verzeichnis, .htaccess</td></tr>
1455 <tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>All</td></tr>
1456 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
1457 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
1458 <tr><th><a href="directive-dict.html#Compatibility">Kompatibilität:</a></th><td>Modulbezeichner sind ab Version 2.1
1459 verfügbar.</td></tr>
1461 <p>Der Container <code><IfModule
1462 <var>Test</var>>...</IfModule></code> wird dazu verwendet,
1463 Direktiven als abhängig von dem Vorhandensein eines speziellen
1464 Moduls zu kennzeichnen. Die Direktiven innerhalb eines <code class="directive"><IfModule></code>-Abschnitts werden nur
1465 ausgeführt, wenn <var>Test</var> wahr ist. Ist <var>Test</var>
1466 falsch, wird alles zwischen der Start- und Endemarkierung ignoriert.</p>
1468 <p>In der <code class="directive"><IfModule></code>-Anweisung
1469 kann <var>Test</var> eine von zwei Formen annehmen:</p>
1472 <li><var>Modul</var></li>
1474 <li><code>!</code><var>Modul</var></li>
1477 <p>Im ersten Fall werden die Direktiven zwischen der Start- und
1478 Endemarkierung nur ausgeführt, das Modul namens
1479 <var>Modul</var> im Apache enthalten ist -- entweder einkompiliert
1480 oder mittels <code class="directive"><a href="../mod/mod_so.html#loadmodule">LoadModule</a></code>
1481 dynamisch geladen. Die zweite Form dreht den Test um und führt die
1482 Direktiven nur aus, wenn <var>Modul</var> <strong>nicht</strong>
1485 <p>Das Argument <var>Modul</var> kann entweder der Modulbezeichner oder
1486 der Dateiname des Moduls zum Zeitpunkt seiner Kompilierung sein.
1487 <code>rewrite_module</code> beispielsweise ist der Bezeichner und
1488 <code>mod_rewrite.c</code> ist der Dateiname. Wenn ein Modul aus mehreren
1489 Quelltext-Dateien besteht, verwenden Sie den Namen der Datei, welche die
1490 Zeichenfolge <code>STANDARD20_MODULE_STUFF</code> enthält.</p>
1492 <p><code class="directive"><IfModule></code>-Container können
1493 inneinander verschachtelt werden, um einfache Multi-Modul-Tests
1496 <p>Dieser Container sollte verwendet werden, wenn Sie eine
1497 Konfigurationsdatei benötigen, die unabhängig davon funktioniert,
1498 ob ein bestimmtes Modul verfügbar ist oder nicht. Normalerweise
1499 ist es nicht notwendig, Direktiven in <code class="directive"><IfModule></code>-Containern unterzubringen.</p>
1502 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
1503 <div class="directive-section"><h2><a name="Include" id="Include">Include</a>-<a name="include" id="include">Direktive</a></h2>
1504 <table class="directive">
1505 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Fügt andere Konfigurationsdateien innerhalb der
1506 Server-Konfigurationsdatei ein</td></tr>
1507 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>Include <var>Dateiname</var>|<var>Verzeichnis</var></code></td></tr>
1508 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Serverkonfiguration, Virtual Host, Verzeichnis</td></tr>
1509 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
1510 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
1511 <tr><th><a href="directive-dict.html#Compatibility">Kompatibilität:</a></th><td>Die Platzhalter-Suche ist verfügbar seit
1514 <p>Die Direktive erlaubt das Einfügen anderer Konfigurationsdateien
1515 in die Konfigurationsdatei des Servers.</p>
1517 <p>Shell-typische (<code>fnmatch()</code>) Platzhlaterzeichen können
1518 dazu verwendet werden, mehrere Dateien auf einmal in alphabetischer
1519 Reihenfolge einzufügen. Wenn <code class="directive">Include</code>
1520 darüber hinaus auf ein Verzeichnis anstatt auf eine Datei zeigt,
1521 liest der Apache alle Dateien in diesem Verzeichnis und allen
1522 Unterverzeichnissen ein. Das Einfügen ganzer Verzeichnisse ist
1523 jedoch nicht empfehlenswert, da temporäre Dateien sehr leicht
1524 versehentlich in einem Verzeichnis zurückgelassen werden, was
1525 <code class="program"><a href="../programs/httpd.html">httpd</a></code> scheitern lassen kann.</p>
1527 <p>Der angegebene Dateiname kann ein absoluter Pfad sein oder relativ zum
1528 <code class="directive"><a href="#serverroot">ServerRoot</a></code>-Verzeichnis angegeben
1533 <div class="example"><p><code>
1534 Include /usr/local/apache2/conf/ssl.conf<br />
1535 Include /usr/local/apache2/conf/vhosts/*.conf
1538 <p>Oder Sie geben Pfade relativ zu Ihrem <code class="directive"><a href="#serverroot">ServerRoot</a></code>-Verzeichnis an:</p>
1540 <div class="example"><p><code>
1541 Include conf/ssl.conf<br />
1542 Include conf/vhosts/*.conf
1545 <p>Der Aufruf von <code>apachectl configtest</code> liefert eine Liste
1546 der Dateien, die während des Konfigurations-Tests verarbeitet
1549 <div class="example"><p><code>
1550 root@host# apachectl configtest<br />
1551 Processing config file: /usr/local/apache2/conf/ssl.conf<br />
1552 Processing config file: /usr/local/apache2/conf/vhosts/vhost1.conf<br />
1553 Processing config file: /usr/local/apache2/conf/vhosts/vhost2.conf<br />
1559 <li><code class="program"><a href="../programs/apachectl.html">apachectl</a></code></li>
1562 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
1563 <div class="directive-section"><h2><a name="KeepAlive" id="KeepAlive">KeepAlive</a>-<a name="keepalive" id="keepalive">Direktive</a></h2>
1564 <table class="directive">
1565 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Aktiviert persistente HTTP-Verbindungen</td></tr>
1566 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>KeepAlive On|Off</code></td></tr>
1567 <tr><th><a href="directive-dict.html#Default">Voreinstellung:</a></th><td><code>KeepAlive On</code></td></tr>
1568 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Serverkonfiguration, Virtual Host</td></tr>
1569 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
1570 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
1572 <p>Die Keep-Alive-Erweiterung von HTTP/1.0 und die
1573 HTTP/1.1-Funktionalität persistenter Verbindungen unterstützt
1574 langlebige HTTP-Sitzungen, die es erlauben, mehrere Anfragen über
1575 die gleich TCP-Verbindung zu senden. In einigen Fällen wurde eine
1576 Beschleunigung der Wartezeiten von beinahe 50% für HTML-Dokumente
1577 mit vielen Bildern festgestellt. Um Keep-Alive-Verbindungen zu aktivieren,
1578 setzen Sie <code>KeepAlive On</code>.</p>
1580 <p>Bei HTTP/1.0-Clients werden Keep-Alive-Verbindungen nur dann verwendet,
1581 wenn sie vom Client eigens angefordert werden. Desweiteren können
1582 Keep-Alive-Verbindungen bei einem HTTP/1.0-Client nur dann verwendet
1583 werden, wenn die Länge des Inhalts im Voraus bekannt ist. Dies
1584 impliziert, dass dynamische Inhalte wie CGI-Ausgaben, SSI-Seiten und
1585 servergenerierte Verzeichnisauflistungen im Allgemeinen keine
1586 Keep-Alive-Verbindungen mit HTTP/1.0-Clients verwenden. Bei
1587 HTTP/1.1-Clients sind Keep-Alive-Verbindungen Voreinstellung, solange
1588 nichts anderes angegeben ist. Wenn der Client es anfordert, wird
1589 Chunked-Encoding verwendet, um Inhalte mit unbekannter Länge
1590 über persistente Verbindungen zu senden.</p>
1594 <li><code class="directive"><a href="#maxkeepaliverequests">MaxKeepAliveRequests</a></code></li>
1597 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
1598 <div class="directive-section"><h2><a name="KeepAliveTimeout" id="KeepAliveTimeout">KeepAliveTimeout</a>-<a name="keepalivetimeout" id="keepalivetimeout">Direktive</a></h2>
1599 <table class="directive">
1600 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Zeitspanne, die der Server während persistenter Verbindungen
1601 auf nachfolgende Anfragen wartet</td></tr>
1602 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>KeepAliveTimeout <var>Sekunden</var></code></td></tr>
1603 <tr><th><a href="directive-dict.html#Default">Voreinstellung:</a></th><td><code>KeepAliveTimeout 5</code></td></tr>
1604 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Serverkonfiguration, Virtual Host</td></tr>
1605 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
1606 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
1608 <p>Dies legt die Anzahl der Sekunden fest, die der Apache auf weitere
1609 Anfragen wartet, bevor er die Verbindung schließt. Nachdem einmal
1610 eine Anfrage entgegen genommen wurde, wird die durch die Direktive
1611 <code class="directive"><a href="#timeout">Timeout</a></code> festgelegte Auszeit
1614 <p>Auf stark belasteten Servern kann ein hoher
1615 <code class="directive">KeepAliveTimeout</code>-Wert zu Durchsatzminderungen
1616 führen. Je höher die Auszeit angegeben ist, desto länger
1617 ist der Apache damit beschäftigt, auf untätige Clients zu
1621 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
1622 <div class="directive-section"><h2><a name="Limit" id="Limit"><Limit></a>-<a name="limit" id="limit">Direktive</a></h2>
1623 <table class="directive">
1624 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Beschränkt die eingeschlossenen Zugriffskontrollen auf
1625 bestimmte HTTP-Methoden</td></tr>
1626 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code><Limit <var>Methode</var> [<var>Methode</var>] ... > ...
1627 </Limit></code></td></tr>
1628 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Serverkonfiguration, Virtual Host, Verzeichnis, .htaccess</td></tr>
1629 <tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>All</td></tr>
1630 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
1631 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
1633 <p>Zugriffskontrollen gelten normalerweise für <strong>alle</strong>
1634 Zugriffsmethoden, was normalerweise auch das gewünschte Verhalten ist.
1635 <strong>Im Allgemeinen sollten Zugriffskontrollen nicht in einen
1636 <code class="directive"><Limit></code>-Container gepackt
1637 werden.</strong></p>
1639 <p>Der Sinn der Direktive <code class="directive"><Limit></code>
1640 ist es, den Effekt der Zugriffskontrollen auf die angegebenen
1641 HTTP-Methoden zu beschränken. Bei allen anderen Methoden haben
1642 die in der <code class="directive"><Limit></code>-Gruppe
1643 enthaltenen Zugriffsbeschränkungen <strong>keine Wirkung</strong>.
1644 Im folgenden Beispiel gilt die Zugriffskontrolle nur für die
1645 Methoden <code>POST</code>, <code>PUT</code> und <code>DELETE</code>.
1646 Alle anderen Methoden bleiben ungeschützt:</p>
1648 <div class="example"><p><code>
1649 <Limit POST PUT DELETE><br />
1650 <span class="indent">
1651 Require valid-user<br />
1656 <p>Sie können eine oder mehrere der folgenden Methoden angeben:
1657 <code>GET</code>, <code>POST</code>, <code>PUT</code>, <code>DELETE</code>,
1658 <code>CONNECT</code>, <code>OPTIONS</code>,
1659 <code>PATCH</code>, <code>PROPFIND</code>, <code>PROPPATCH</code>,
1660 <code>MKCOL</code>, <code>COPY</code>, <code>MOVE</code>,
1661 <code>LOCK</code> und <code>UNLOCK</code>. <strong>Die Methodennamen
1662 unterscheiden zwischen Groß- und Kleinschreibung.</strong> Wenn
1663 <code>GET</code> verwendet wird, sind <code>HEAD</code>-Anfragen
1664 ebenfalls eingeschränkt. Die <code>TRACE</code>-Methode kann nicht
1665 limitiert werden.</p>
1667 <div class="warning">
1668 Wenn es um Zugriffsbeschränkungen geht, sollte
1669 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
1670 werden, da <code class="directive"><a href="#limitexcept"><LimitExcept></a></code>
1671 einen Schutz gegen beliebige Methoden bietet.
1675 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
1676 <div class="directive-section"><h2><a name="LimitExcept" id="LimitExcept"><LimitExcept></a>-<a name="limitexcept" id="limitexcept">Direktive</a></h2>
1677 <table class="directive">
1678 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Beschränkt Zugriffskontrollen auf alle HTTP-Methoden
1679 außer den genannten</td></tr>
1680 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code><LimitExcept <var>Methode</var> [<var>Methode</var>] ... > ...
1681 </LimitExcept></code></td></tr>
1682 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Serverkonfiguration, Virtual Host, Verzeichnis, .htaccess</td></tr>
1683 <tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>All</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>
1687 <p><code class="directive"><LimitExcept></code> und
1688 <code></LimitExcept></code> werden dazu verwendet, eine Gruppe
1689 von Anweisungen zur Zugriffskontrolle zusammenzufassen, die dann auf
1690 jede HTTP-Methode angewendet werden, die <strong>nicht</strong>
1691 als Argument angegeben ist. D.h. dies ist das Gegenteil des
1692 <code class="directive"><a href="#limit"><Limit></a></code>-Containers
1693 und kann zur Steuerung von Standard- und nicht-Standard-/unbekannten
1694 Methoden verwendet werden. Für weitere Einzelheiten lesen Sie bitte
1695 die Beschreibung zu <code class="directive"><a href="#limit"><Limit></a></code>.</p>
1699 <div class="example"><p><code>
1700 <LimitExcept POST GET><br />
1701 <span class="indent">
1702 Require valid-user<br />
1704 </LimitExcept>
1709 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
1710 <div class="directive-section"><h2><a name="LimitInternalRecursion" id="LimitInternalRecursion">LimitInternalRecursion</a>-<a name="limitinternalrecursion" id="limitinternalrecursion">Direktive</a></h2>
1711 <table class="directive">
1712 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Bestimmt die maximale Anzahl interner Umleitungen und
1713 verschachtelter Unteranfragen</td></tr>
1714 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>LimitInternalRecursion <var>Zahl</var> [<var>Zahl</var>]</code></td></tr>
1715 <tr><th><a href="directive-dict.html#Default">Voreinstellung:</a></th><td><code>LimitInternalRecursion 10</code></td></tr>
1716 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Serverkonfiguration, Virtual Host</td></tr>
1717 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
1718 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
1719 <tr><th><a href="directive-dict.html#Compatibility">Kompatibilität:</a></th><td>Verfügbar ab Apache 2.0.47</td></tr>
1721 <p>Eine interne Umleitung erfolgt beispielsweise, wenn die Direktive
1722 <code class="directive"><a href="../mod/mod_actions.html#action">Action</a></code> verwendet wird, welche
1723 die Originalanfrage intern zu einem CGI-Skript weiterleitet. Eine
1724 Unteranfrage <span class="transnote">(<em>Anm.d.Ü.:</em> engl. Subrequest)</span> ist ein Mechanismus des
1725 Apache, um herauszufinden, was bei einer URI geschehen würde, wäre
1726 sie angefordert worden. <code class="module"><a href="../mod/mod_dir.html">mod_dir</a></code> z.B. verwendet
1727 Unteranfragen, um nach den Dateien zu suchen, die in der <code class="directive"><a href="../mod/mod_dir.html#directoryindex">DirectoryIndex</a></code>-Anweisung aufgeführt
1730 <p><code class="directive">LimitInternalRecursion</code> bewahrt den Server vor
1731 einem Absturz, wenn er in eine Endlosschleife aus internen Umleitungen
1732 oder Unteranfragen hineinläuft. Derartige Schleifen werden
1733 gewöhnlich durch Fehlkonfiguration verursacht.</p>
1735 <p>Die Direktive setzt zwei verschiedene Begrenzungen, welche je Anfrage
1736 ausgewertet werden. Die erste <var>Zahl</var> bestimmt die maximale
1737 Anzahl der Umleitungen, die aufeinander folgen dürfen. Die zweite
1738 <var>Zahl</var> legt fest, wie tief Unteranfragen ineinander
1739 verschachtelt werden dürfen. Wenn Sie lediglich eine <var>Zahl</var>
1740 angeben, wird sie beiden Begrenzungen zugewiesen.</p>
1742 <div class="example"><h3>Beispiel</h3><p><code>
1743 LimitInternalRecursion 5
1747 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
1748 <div class="directive-section"><h2><a name="LimitRequestBody" id="LimitRequestBody">LimitRequestBody</a>-<a name="limitrequestbody" id="limitrequestbody">Direktive</a></h2>
1749 <table class="directive">
1750 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Begrenzt die Gesamtgröße des vom Client gesendeten
1751 HTTP-Request-Body</td></tr>
1752 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>LimitRequestBody <var>Bytes</var></code></td></tr>
1753 <tr><th><a href="directive-dict.html#Default">Voreinstellung:</a></th><td><code>LimitRequestBody 0</code></td></tr>
1754 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Serverkonfiguration, Virtual Host, Verzeichnis, .htaccess</td></tr>
1755 <tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>All</td></tr>
1756 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
1757 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
1759 <p>Die Direktive gibt die Anzahl der <var>Bytes</var> zwischen 0
1760 (unbegrenzt) und 2147483647 (2GB) an, die im Request-Body (Datenteil der
1761 Anfrage) erlaubt sind.</p>
1763 <p>Die Direktive <code class="directive">LimitRequestBody</code> erlaubt es dem
1764 Benutzer, die Größe des HTTP-Request-Bodys in dem Kontext zu
1765 begrenzen, in dem die Anweisung angegeben ist (Server, pro Verzeichnis,
1766 pro Datei oder pro Adresse). Wenn die Anfrage des Clients dieses Limit
1767 überschreitet, gibt der Server einen Fehler zurück anstatt die
1768 Anfrage zu bearbeiten. Die Größe des Datenteils einer Anfrage
1769 kann sehr stark variieren, abhängig von der Art der Ressource und
1770 den für diese Ressource erlaubten Methoden. CGI-Skripte verwenden
1771 den Datenteil üblicherweise zum Empfang von Formulardaten. Wird
1772 die <code>PUT</code>-Methode angewendet, dann muss der Wert mindestens
1773 so groß sein wie irgendeine Darstellungsform, die der Server
1774 für diese Ressource akzeptieren soll.</p>
1776 <p>Die Direktive gibt dem Serveradministrator eine größere
1777 Kontrolle gegenüber abnormalem Verhalten von Clients, was bei der
1778 Vermeidung einiger Formen von Denial-of-Service-Attacken hilfreich
1781 <p>Wenn Sie beispielsweise das Hochladen von Dateien zu einer bestimmten
1782 Adresse erlauben, aber die Größe der hochgeladenen Dateien
1783 auf 100K beschränken wollen, können Sie die folgende Anweisung
1786 <div class="example"><p><code>
1787 LimitRequestBody 102400
1792 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
1793 <div class="directive-section"><h2><a name="LimitRequestFields" id="LimitRequestFields">LimitRequestFields</a>-<a name="limitrequestfields" id="limitrequestfields">Direktive</a></h2>
1794 <table class="directive">
1795 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Begrenzt die Anzahl der HTTP-Request-Header, die vom Client
1796 entgegengenommen werden</td></tr>
1797 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>LimitRequestFields <var>Anzahl</var></code></td></tr>
1798 <tr><th><a href="directive-dict.html#Default">Voreinstellung:</a></th><td><code>LimitRequestFields 100</code></td></tr>
1799 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Serverkonfiguration</td></tr>
1800 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
1801 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
1803 <p><var>Anzahl</var> ist ein Integer-Wert (eine positive Ganzzahl)
1804 zwischen 0 (unbegrenzt) und 32767. Die Voreinstellung wird durch die
1805 Konstante <code>DEFAULT_LIMIT_REQUEST_FIELDS</code> (<code>100</code>
1806 bei der Auslieferung) zur Kompilierungszeit gesetzt.</p>
1808 <p>Die Direktive <code class="directive">LimitRequestFields</code> erlaubt es
1809 dem Serveradministrator, die maximale Anzahl der in einem HTTP-Request
1810 erlaubten HTTP-Request-Header zu verändern. Für den Server
1811 muss dieser Wert größer sein als die Anzahl der Headerzeilen,
1812 die ein normaler Client senden könnte. Die Anzahl der Request-Header,
1813 die ein gewöhnlicher Client verwendet, überschreitet selten 20
1814 Zeilen. Allerdings kann dies zwischen den verschiedenen
1815 Client-Ausführungen variieren, oft abhängig vom Ausmaß,
1816 mit dem der Anwender die genaue Content-Negotiation-Unterstützung
1817 seines Browsers konfiguriert hat. Optionale HTTP-Erweiterungen
1818 äußern sich oft in Form von HTTP-Headern.</p>
1820 <p>Die Direktive gibt dem Serveradministrator eine größere
1821 Kontrolle gegenüber abnormalem Verhalten von Clients, was bei der
1822 Vermeidung einiger Formen von Denial-of-Service-Attacken hilfreich
1823 sein kann. Der Wert sollte erhöht werden, wenn normale Clients
1824 eine Fehlermeldung vom Server erhalten, die besagt, dass mit der Anfrage
1825 zu viele Headerzeilen gesendet wurden.</p>
1829 <div class="example"><p><code>
1830 LimitRequestFields 50
1835 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
1836 <div class="directive-section"><h2><a name="LimitRequestFieldSize" id="LimitRequestFieldSize">LimitRequestFieldSize</a>-<a name="limitrequestfieldsize" id="limitrequestfieldsize">Direktive</a></h2>
1837 <table class="directive">
1838 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Begrenzt die Länge des vom Client gesendeten
1839 HTTP-Request-Headers</td></tr>
1840 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>LimitRequestFieldsize <var>Bytes</var></code></td></tr>
1841 <tr><th><a href="directive-dict.html#Default">Voreinstellung:</a></th><td><code>LimitRequestFieldsize 8190</code></td></tr>
1842 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Serverkonfiguration</td></tr>
1843 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
1844 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
1846 <p>Die Direktive gibt die Anzahl der <var>Bytes</var> an, die in einem
1847 HTTP-Header erlaubt sind.</p>
1849 <p>Die Direktive <code class="directive">LimitRequestFieldsize</code> erlaubt es
1850 dem Serveradministrator, die maximale Größe eines
1851 HTTP-Request-Headers zu verringern oder erhöhen. Für den Server
1852 muss der Wert groß genug sein, um eine beliebige Headerzeile einer
1853 normalen Client-Anfrage vorzuhalten. Die Größe variiert stark
1854 zwischen den verschiedenen Client-Ausführungen, oft abhängig vom
1855 Ausmaß, mit dem der Anwender die genaue
1856 Content-Negotiation-Unterstützung seines Browsers konfiguriert hat.
1857 SPNEGO-Authentisierungs-Header können bis zu 12392 Bytes lang
1860 <p>Die Direktive gibt dem Serveradministrator eine größere
1861 Kontrolle gegenüber abnormalem Verhalten von Clients, was bei der
1862 Vermeidung einiger Formen von Denial-of-Service-Attacken hilfreich
1867 <div class="example"><p><code>
1868 LimitRequestFieldSize 4094
1871 <div class="note">Unter normalen Umständen sollte die Voreinstellung nicht
1872 verändert werden.</div>
1875 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
1876 <div class="directive-section"><h2><a name="LimitRequestLine" id="LimitRequestLine">LimitRequestLine</a>-<a name="limitrequestline" id="limitrequestline">Direktive</a></h2>
1877 <table class="directive">
1878 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Begrenzt die Länge der vom Client entgegengenommenen
1879 HTTP-Anfragezeile</td></tr>
1880 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>LimitRequestLine <var>Bytes</var></code></td></tr>
1881 <tr><th><a href="directive-dict.html#Default">Voreinstellung:</a></th><td><code>LimitRequestLine 8190</code></td></tr>
1882 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Serverkonfiguration</td></tr>
1883 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
1884 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
1886 <p>Die Direktive legt die Anzahl der <var>Bytes</var> fest, die in der
1887 HTTP-Anfragezeile erlaubt sind.</p>
1889 <p>Die Direktive <code class="directive">LimitRequestLine</code> erlaubt es dem
1890 Serveradministrator, die maximale Größe der
1891 HTTP-Anfragezeile zu verringern oder erhöhen. Da
1892 die Anfragezeile aus der HTTP-Methode, der URI und der Protokollversion
1893 besteht, bedeutet die <code class="directive">LimitRequestLine</code>-Direktive
1894 eine Beschränkung der Länge der für eine Anfrage an den
1895 Server erlaubten Anfrage-URI. Für den Server muss der Wert groß
1896 genug sein, um jeden seiner Ressourcennamen vorzuhalten,
1897 einschließlich aller Informationen, die im Query-String einer
1898 <code>GET</code>-Anfrage übergeben werden können.</p>
1900 <p>Die Direktive gibt dem Serveradministrator eine größere
1901 Kontrolle gegenüber abnormalem Verhalten von Clients, was bei der
1902 Vermeidung einiger Formen von Denial-of-Service-Attacken hilfreich
1907 <div class="example"><p><code>
1908 LimitRequestLine 4094
1911 <div class="note">Unter normalen Umständen sollte die Voreinstellung nicht
1912 verändert werden.</div>
1915 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
1916 <div class="directive-section"><h2><a name="LimitXMLRequestBody" id="LimitXMLRequestBody">LimitXMLRequestBody</a>-<a name="limitxmlrequestbody" id="limitxmlrequestbody">Direktive</a></h2>
1917 <table class="directive">
1918 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Begrenzt die Größe eines XML-basierten
1919 Request-Bodys</td></tr>
1920 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>LimitXMLRequestBody <var>Bytes</var></code></td></tr>
1921 <tr><th><a href="directive-dict.html#Default">Voreinstellung:</a></th><td><code>LimitXMLRequestBody 1000000</code></td></tr>
1922 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Serverkonfiguration, Virtual Host, Verzeichnis, .htaccess</td></tr>
1923 <tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>All</td></tr>
1924 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
1925 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
1927 <p>Dies gibt die Grenze für die maximale Größe (in Bytes)
1928 des XML-basierten Request-Bodys an. Der Wert <code>0</code> deaktiviert
1933 <div class="example"><p><code>
1934 LimitXMLRequestBody 0
1939 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
1940 <div class="directive-section"><h2><a name="Location" id="Location"><Location></a>-<a name="location" id="location">Direktive</a></h2>
1941 <table class="directive">
1942 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Wendet die enthaltenen Direktiven nur auf die entsprechenden
1944 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code><Location
1945 <var>URL-Pfad</var>|<var>URL</var>> ... </Location></code></td></tr>
1946 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Serverkonfiguration, Virtual Host</td></tr>
1947 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
1948 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
1950 <p>Die Direktive <code class="directive"><Location></code>
1951 begrenzt die Reichweite der enthaltenen Anweisungen auf URLs.
1952 Sie ist der Direktive <code class="directive"><a href="#directory"><Directory></a></code> ähnlich und startet einen
1953 Abschnitt, der mit der Anweisung <code></Location></code>
1954 abgeschlossen wird. <code class="directive"><Location></code>-Container werden, nachdem die
1955 <code class="directive"><a href="#directory"><Directory></a></code>-Container
1956 und <code>.htaccess</code>-Dateien gelesen wurden, und nach den
1957 <code class="directive"><a href="#files"><Files></a></code>-Containern, in
1958 der Reihenfolge ausgeführt, in der sie in der Konfigurationsdatei
1961 <p><code class="directive"><Location></code>-Abschnitte operieren
1962 vollständig außerhalb des Dateisystems. Dies hat mehrere
1963 Konsequenzen. An Wichtigsten, <code class="directive"><Location></code>-Anweisungen sollten nicht dafür
1964 verwendet werden, den Zugriff zu Teilen des Dateisystems zu steuern. Da
1965 mehrere unterschiedliche URLs auf die gleiche Stelle des Dateisystems
1966 zeigen können, könnte eine solche Zugriffskontrolle u.U.
1967 umgangen werden.</p>
1969 <div class="note"><h3>Wann sollte<code class="directive"><Location></code> verwendet werden</h3>
1971 <p>Verwenden Sie <code class="directive"><Location></code>, um
1972 Anweisungen auf Inhalte anzuwenden, die außerhalb des Dateisystems
1973 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
1974 innerhalb des Dateisystems abgelegt sind. Eine Ausnahme bildet
1975 <code><Location /></code>, welches ein einfacher Weg ist, um eine
1976 Konfiguration auf den gesamten Server anzuwenden.</p>
1979 <p>Für alle nicht-Proxy-Anfragen ist die entsprechende URL
1980 ein URL-Pfad in der Form <code>/path/</code>. Es dürfen weder ein
1981 Schema, noch ein Hostname, noch ein Port, noch ein Query-String einbezogen
1982 werden. Für Proxy-Anfragen hat die Vergleichs-URL die Form
1983 <code>schema://servername/path</code>. Das Präfix muss angegeben
1986 <p>Die URL kann Platzhalter verwenden. In einer Zeichenfolge mit
1987 Platzhaltern entspricht <code>?</code> einem einzelnen Zeichen und
1988 <code>*</code>einer beliebigen Zeichenfolge.</p>
1990 <p>Erweiterte reguläre Ausdrücke können ebenfalls
1991 verwendet werden, indem das Zeichen <code>~</code> hinzugefügt
1992 wird. Beispielsweise würde</p>
1994 <div class="example"><p><code>
1995 <Location ~ "/(extra|special)/data">
1998 <p>auf URLs passen, welche die Zeichenfolge <code>/extra/data</code>
1999 oder <code>/special/data</code> enthalten. Die Direktive <code class="directive"><a href="#locationmatch"><LocationMatch></a></code> verhält sich
2000 genauso wie <code class="directive"><Location></code> mit
2001 regulären Ausdrücken.</p>
2003 <p>Die Funktionalität von <code class="directive"><Location></code> ist insbesondere dann nützlich,
2004 wenn sie mit der <code class="directive"><a href="#sethandler">SetHandler</a></code>-Direktive
2005 kombiniert wird. Um zum Beispiel Statusabfragen zu aktivieren, sie aber
2006 nur von Browsern aus <code>foo.com</code> zuzulassen, könnten Sie
2009 <div class="example"><p><code>
2010 <Location /status><br />
2011 <span class="indent">
2012 SetHandler server-status<br />
2013 Order Deny,Allow<br />
2015 Allow from .foo.com<br />
2020 <div class="note"><h3>Anmerkung zu / (Schrägstrich, Slash)</h3>
2021 <p>Das Slash-Zeichen hat eine besondere Bedeutung, je nachdem, wo es
2022 in der URL erscheint. Manche werden sein Verhalten vom Dateisystem
2023 gewohnt sein, wo mehrere aufeinanderfolgende Schrägstriche
2024 häufig zu einem Schrägstrich zusammengefaßt werden
2025 (<em>d.h.</em> <code>/home///foo</code> ist das gleiche wie
2026 <code>/home/foo</code>). Im URL-Raum ist dies nicht notwendigerweise
2027 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
2028 müssen Sie explizit mehrere Schrägstriche angeben, wenn Sie
2029 genau dies beabsichtigen.</p>
2031 <p>Beispielsweise würde <code><LocationMatch ^/abc></code>
2032 auf die angeforderte URL <code>/abc</code> passen, nicht aber auf
2033 <code>//abc</code>. Die Direktive <code class="directive"><Location></code> (ohne reguläre Ausdrücke) verhält
2034 sich ähnlich, wenn sie für Proxy-Anfragen verwendet wird.
2035 Wenn <code class="directive"><Location></code> (ohne
2036 reguläre Ausdrücke) jedoch für nicht-Proxy-Anfragen
2037 verwendet wird, werden stillscheigend mehrere Schrächstriche mit
2038 mit einem einzigen Schrägstrich gleichgesetzt. Geben Sie
2039 beispielsweise <code><Location /abc/def></code> an und die
2040 Anfrage lautet auf <code>/abc//def</code>, dann greift die Anweisung.</p>
2045 <li><a href="../sections.html">Wie die Abschnitte <Directory>,
2046 <Location> und <Files> arbeiten</a> für eine
2047 Erläuterung, wie diese verschiedenen Abschnitte miteinander
2048 kombiniert werden, wenn eine Anfrage empfangen wird</li>
2051 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
2052 <div class="directive-section"><h2><a name="LocationMatch" id="LocationMatch"><LocationMatch></a>-<a name="locationmatch" id="locationmatch">Direktive</a></h2>
2053 <table class="directive">
2054 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Wendet die enthaltenen Direktiven nur auf URLs an, die auf
2055 reguläre Ausdrücke passen</td></tr>
2056 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code><LocationMatch
2057 <var>regex</var>> ... </LocationMatch></code></td></tr>
2058 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Serverkonfiguration, Virtual Host</td></tr>
2059 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
2060 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
2062 <p>Die Direktive <code class="directive"><LocationMatch></code>
2063 begrenzt die Reichweite der enthaltenen Anweisungen in der gleichen Weise
2064 wie <code class="directive"><a href="#location"><Location></a></code> auf URLs.
2065 Sie verwendet jedoch reguläre Ausdrücke als Argument anstelle
2066 einer einfachen Zeichenkette. Beispielsweise würde</p>
2068 <div class="example"><p><code>
2069 <LocationMatch "/(extra|special)/data">
2072 <p>auf URLs passen, welche die Zeichenfolge <code>/extra/data</code>
2073 oder <code>/special/data</code> enthalten.</p>
2077 <li><a href="../sections.html">Wie die Abschnitte <Directory>,
2078 <Location> und <Files> arbeiten</a> für eine
2079 Erläuterung, wie diese verschiedenen Abschnitte miteinander
2080 kombiniert werden, wenn eine Anfrage empfangen wird</li>
2083 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
2084 <div class="directive-section"><h2><a name="LogLevel" id="LogLevel">LogLevel</a>-<a name="loglevel" id="loglevel">Direktive</a></h2>
2085 <table class="directive">
2086 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Steuert die Ausführlichkeit des Fehlerprotokolls</td></tr>
2087 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>LogLevel <var>Level</var></code></td></tr>
2088 <tr><th><a href="directive-dict.html#Default">Voreinstellung:</a></th><td><code>LogLevel warn</code></td></tr>
2089 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Serverkonfiguration, Virtual Host</td></tr>
2090 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
2091 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
2093 <p><code class="directive">LogLevel</code> stellt die Ausführlichkeit
2094 der Nachrichten ein, die im Fehlerprotokoll aufgezeichnet werden (siehe
2095 Direktive <code class="directive"><a href="#errorlog">ErrorLog</a></code>). Die folgenden,
2096 nach absteigender Aussagekraft sortierten <var>Level</var> sind
2099 <table class="bordered">
2102 <th><strong>Level</strong> </th>
2104 <th><strong>Beschreibung</strong> </th>
2106 <th><strong>Beispiel</strong> </th>
2110 <td><code>emerg</code> </td>
2112 <td>Notfall - das System ist unbenutzbar.</td>
2114 <td>"Child cannot open lock file. Exiting"
2115 <span class="transnote">(<em>Anm.d.Ü.:</em> "Kindprozess kann die Lock-Datei nicht öffnen.
2116 Beende Programm")</span></td>
2120 <td><code>alert</code> </td>
2122 <td>Maßnahmen müssen unverzüglich ergriffen
2125 <td>"getpwuid: couldn't determine user name from uid"
2126 <span class="transnote">(<em>Anm.d.Ü.:</em> "getpwuid: kann keinen Benutzernamen aus der UID
2127 ermitteln")</span></td>
2131 <td><code>crit</code> </td>
2133 <td>Kritischer Zustand.</td>
2135 <td>"socket: Failed to get a socket, exiting child"
2136 <span class="transnote">(<em>Anm.d.Ü.:</em> "socket: Socket-Zuweisung fehlgeschlagen, beende
2137 Kindprozess")</span></td>
2141 <td><code>error</code> </td>
2143 <td>Fehlerbedingung.</td>
2145 <td>"Premature end of script headers"
2146 <span class="transnote">(<em>Anm.d.Ü.:</em> "Vorzeitiges Ende der Skript-Header")</span></td>
2150 <td><code>warn</code> </td>
2154 <td>"child process 1234 did not exit, sending another SIGHUP"
2155 <span class="transnote">(<em>Anm.d.Ü.:</em> "Kindprozess 1234 nicht beendet, sende ein weiteres
2156 SIGHUP")</span></td>
2160 <td><code>notice</code> </td>
2162 <td>Normaler, aber signifikanter Zustand.</td>
2164 <td>"httpd: caught SIGBUS, attempting to dump core in ..."
2165 <span class="transnote">(<em>Anm.d.Ü.:</em> "httpd: SIGBUS empfangen, versuche Speicherabbild nach ...
2166 zu schreiben")</span></td>
2170 <td><code>info</code> </td>
2172 <td>Information.</td>
2174 <td>"Server seems busy, (you may need to increase
2175 StartServers, or Min/MaxSpareServers)..."
2176 <span class="transnote">(<em>Anm.d.Ü.:</em> "Server scheint beschäftigt zu sein,
2177 (möglicherweise müssen Sie StartServers oder
2178 Min/MaxSpareServers erhöhen)")</span></td>
2182 <td><code>debug</code> </td>
2184 <td>Debug-Level-Nachrichten</td>
2186 <td>"Opening config file ..."
2187 <span class="transnote">(<em>Anm.d.Ü.:</em> "Öffne Konfigurationsdatei ...")</span></td>
2191 <p>Geben Sie einen bestimmten Level an, denn werden Nachrichten von
2192 allen höheren Leveln ebenso angezeigt. <em>Z.B.:</em> Wenn
2193 <code>LogLevel info</code> eingestellt ist, dann werden Nachrichten der
2194 Log-Level <code>notice</code> und <code>warn</code> ebenso eingetragen.</p>
2196 <p>Es wird empfohlen, mindestens den Level <code>crit</code> zu
2201 <div class="example"><p><code>
2205 <div class="note"><h3>Hinweis</h3>
2206 <p>Beim Protokollieren in eine reguläre Datei können
2207 Nachrichten des Levels <code>notice</code> nicht unterdrückt
2208 werden und werden daher immer protokolliert. Dies trifft allerdings
2209 nicht zu, wenn mittels <code>syslog</code> protokolliert wird.</p>
2213 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
2214 <div class="directive-section"><h2><a name="MaxKeepAliveRequests" id="MaxKeepAliveRequests">MaxKeepAliveRequests</a>-<a name="maxkeepaliverequests" id="maxkeepaliverequests">Direktive</a></h2>
2215 <table class="directive">
2216 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Anzahl der Anfragen, die bei einer persistenten Verbindung
2217 zulässig sind</td></tr>
2218 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>MaxKeepAliveRequests <var>Anzahl</var></code></td></tr>
2219 <tr><th><a href="directive-dict.html#Default">Voreinstellung:</a></th><td><code>MaxKeepAliveRequests 100</code></td></tr>
2220 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Serverkonfiguration, Virtual Host</td></tr>
2221 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
2222 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
2224 <p>Die Direktive <code class="directive">MaxKeepAliveRequests</code>
2225 begrenzt die Anzahl der Anfragen, die pro Verbindung zulässig sind,
2226 wenn <code class="directive"><a href="#keepalive">KeepAlive</a></code> eingeschaltet ist.
2227 Bei der Einstellung <code>0</code> sind unbegrenzt viele Anfragen
2228 erlaubt. Wir empfehlen für diese Einstellung einen hohen Wert
2229 für eine maximale Serverleistung.</p>
2233 <div class="example"><p><code>
2234 MaxKeepAliveRequests 500
2238 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
2239 <div class="directive-section"><h2><a name="NameVirtualHost" id="NameVirtualHost">NameVirtualHost</a>-<a name="namevirtualhost" id="namevirtualhost">Direktive</a></h2>
2240 <table class="directive">
2241 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Bestimmt eine IP-Adresse für den Betrieb namensbasierter
2242 virtueller Hosts</td></tr>
2243 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>NameVirtualHost <var>Adresse</var>[:<var>Port</var>]</code></td></tr>
2244 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Serverkonfiguration</td></tr>
2245 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
2246 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
2248 <p>Die Direktive <code class="directive">NameVirtualHost</code> ist erforderlich,
2249 wenn Sie <a href="../vhosts/">namensbasierte virtuelle Hosts</a>
2250 konfigurieren möchten.</p>
2252 <p>Obwohl <var>Adresse</var> eine Hostname sein kann, wird empfohlen,
2253 dass Sie stets eine IP-Adresse verwenden, z.B.:</p>
2255 <div class="example"><p><code>
2256 NameVirtualHost 111.22.33.44
2259 <p>Mit der <code class="directive">NameVirtualHost</code>-Anweisung geben Sie
2260 die IP-Adresse an, unter der der Server Anfragen für
2261 namensbasierte virtuelle Hosts entgegennimmt. Das ist üblicherweise
2262 die Adresse, zu der die Namen Ihrer namensbasierten virtuellen Hosts
2263 aufgelöst werden. Falls eine Firewall oder ein anderer Proxy die
2264 Anfrage in Empfang nimmt und Sie zu einer weiteren IP-Adresse des Servers
2265 weiterleitet, müssen Sie die IP-Adresse der physikalischen
2266 Schnittstelle der Maschine angeben, welche die Anfragen bedient.
2267 Wenn Sie mehrere namensbasierte Hosts an verschiedenen Adressen
2268 betreiben, wiederholen Sie einfach die Anweisung für jede
2271 <div class="note"><h3>Anmerkung</h3>
2272 <p>Beachten Sie, dass der "Hauptserver" und jeder
2273 <code>_default_</code>-Server <strong>niemals</strong> bei einer
2274 Anfrage an einer <code class="directive">NameVirtualHost</code>-IP-Adresse
2275 bedient wird (es sei denn, Sie geben aus irgendwelchen Gründen
2276 <code class="directive">NameVirtualHost</code> an, definieren dann aber keine
2277 <code class="directive">VirtualHost</code>s für diese Adresse).</p>
2280 <p>Optional können Sie die Nummer eines Ports angeben, an dem
2281 namensbasierte virtuelle Hosts verwendet werden sollen. Beispiel:</p>
2283 <div class="example"><p><code>
2284 NameVirtualHost 111.22.33.44:8080
2287 <p>IPv6-Adressen müssen, wie im folgenden Beispiel angegeben, in
2288 eckige Klammern eingeschlossen werden:</p>
2290 <div class="example"><p><code>
2291 NameVirtualHost [2001:db8::a00:20ff:fea7:ccea]:8080
2294 <p>Um an allen Schnittstellen Anfragen zu empfangen, können Sie
2295 <code>*</code> als Argument verwenden.</p>
2297 <div class="example"><p><code>
2301 <div class="note"><h3>Argument der Direktive <code class="directive"><VirtualHost></code></h3>
2302 <p>Beachten Sie, dass das Argument der <code class="directive"><VirtualHost></code>-Anweisung exakt auf das Argument
2303 der <code class="directive">NameVirtualHost</code>-Anweisung passen muss.</p>
2305 <div class="example"><p><code>
2306 NameVirtualHost 1.2.3.4<br />
2307 <VirtualHost 1.2.3.4><br />
2309 </VirtualHost><br />
2315 <li><a href="../vhosts/">Dokumentation zu virtuellen Hosts</a></li>
2318 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
2319 <div class="directive-section"><h2><a name="Options" id="Options">Options</a>-<a name="options" id="options">Direktive</a></h2>
2320 <table class="directive">
2321 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Definiert, welche Eigenschaften oder Funktionen in einem
2322 bestimmten Verzeichnis verfügbar sind</td></tr>
2323 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>Options
2324 [+|-]<var>Option</var> [[+|-]<var>Option</var>] ...</code></td></tr>
2325 <tr><th><a href="directive-dict.html#Default">Voreinstellung:</a></th><td><code>Options All</code></td></tr>
2326 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Serverkonfiguration, Virtual Host, Verzeichnis, .htaccess</td></tr>
2327 <tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>Options</td></tr>
2328 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
2329 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
2331 <p>Die Direktive <code class="directive">Options</code> steuert, welche
2332 Eigenschaften bzw. Funktionen in einem bestimmten Verzeichnis
2335 <p><var>Option</var> kann auf <code>None</code> gesetzt werden, wobei
2336 keine der besonderen Eigenschaften verfügbar sind, oder auf eines
2337 oder mehrere der folgenden:</p>
2340 <dt><code>All</code></dt>
2342 <dd>Alle Optionen außer <code>MultiViews</code>. Dies ist
2343 die Voreinstellung.</dd>
2345 <dt><code>ExecCGI</code></dt>
2347 <dd>Die Ausführung von CGI-Skripten, welche <code class="module"><a href="../mod/mod_cgi.html">mod_cgi</a></code>
2348 verwenden, ist erlaubt.</dd>
2350 <dt><code>FollowSymLinks</code></dt>
2352 <dd>Der Server folgt symbolischen Links in diesem Verzeichnis.
2354 <p>Auch wenn der Server symbolischen Links folgt, bedeutet dies
2355 <em>nicht</em>, dass der zum Abgleich gegen <code class="directive"><a href="#directory"><Directory></a></code>-Abschnitte verwendete Pfadname
2357 <p>Beachten Sie auch, dass diese Option innerhalb eines
2358 <code class="directive"><a href="#location"><Location></a></code>-Abschnitts
2359 <strong>ignoriert wird</strong>.</p>
2362 <dt><code>Includes</code></dt>
2365 Server Side Includes, die von <code class="module"><a href="../mod/mod_include.html">mod_include</a></code> bereitgestellt
2366 werden, sind erlaubt.</dd>
2368 <dt><code>IncludesNOEXEC</code></dt>
2370 <dd>Server Side Includes sind erlaubt, <code>#exec cmd</code>
2371 und <code>#exec cgi</code> sind jedoch deaktiviert. Es ist aber noch
2372 möglich, CGI-Skripte aus
2373 <code class="directive"><a href="../mod/mod_alias.html#scriptalias">ScriptAlias</a></code>-Verzeichnissen mittels
2374 <code>#include virtual</code> einzubinden.</dd>
2376 <dt><code>Indexes</code></dt>
2378 <dd>Wenn eine URL, die auf ein Verzeichnis zeigt, in dem sich keine durch
2379 <code class="directive"><a href="../mod/mod_dir.html#directoryindex">DirectoryIndex</a></code> definierte
2380 Indexdatei (<em>z.B.</em> <code>index.html</code>) befindet, dann liefert
2381 <code class="module"><a href="../mod/mod_autoindex.html">mod_autoindex</a></code> eine formatierte Auflistung des
2382 Verzeichnisses zurück.</dd>
2384 <dt><code>MultiViews</code></dt>
2386 <dd>"MultiViews" sind bei der Verwendung von
2387 <code class="module"><a href="../mod/mod_negotiation.html">mod_negotiation</a></code> erlaubt (siehe <a href="../content-negotiation.html">Content-Negotiation</a>).</dd>
2389 <dt><code>SymLinksIfOwnerMatch</code></dt>
2391 <dd>Der Server folgt nur symbolischen Links, bei denen die Zieldatei
2392 bzw. das Zielverzeichnis der gleichen Benutzerkennung gehört, wie
2394 <div class="note"><h3>Anmerkung</h3> Diese Option wird innerhalb eines
2395 <code class="directive"><a href="#location"><Location></a></code>-Abschnitts
2396 ignoriert.</div></dd>
2399 <p>Wenn mehrere <code class="directive">Options</code> auf ein Verzeichnis
2400 angewandt werden können, dann wird normalerweise die
2401 spezifischste <span class="transnote">(<em>Anm.d.Ü.:</em> Gemeint ist die zuletzt
2402 ausgeführte Option.)</span> verwendet und alle anderen werden
2403 ignoriert; die Optionen werden nicht vermischt. (Siehe auch <a href="../sections.html#mergin">Wie Abschnitte zusammengeführt
2404 werden.</a>.) Wenn jedoch <em>allen</em> Optionen der
2405 <code class="directive">Options</code>-Anweisung eines der Zeichen
2406 <code>+</code> oder <code>-</code> vorangestellt wird, werden die Optionen
2407 zusammengemischt. Jede Option mit vorangestelltem <code>+</code> wird
2408 zu den momentan gültigen Optionen hinzugefügt und jede Option
2409 mit vorangestelltem <code>-</code> wird aus den derzeit gültigen
2410 Optionen entfernt.</p>
2412 <p>So wird zum Beispiel ohne die Zeichen <code>+</code> und
2415 <div class="example"><p><code>
2416 <Directory /web/docs><br />
2417 <span class="indent">
2418 Options Indexes FollowSymLinks<br />
2420 </Directory><br />
2422 <Directory /web/docs/spec><br />
2423 <span class="indent">
2424 Options Includes<br />
2429 <p>für das Verzeichnis <code>/web/docs/spec</code> wird jetzt
2430 lediglich <code>Includes</code> gesetzt. Wenn die zweite
2431 <code class="directive">Options</code>-Anweisung jedoch <code>+</code>-
2432 und <code>-</code>-Zeichen verwenden würde,</p>
2434 <div class="example"><p><code>
2435 <Directory /web/docs><br />
2436 <span class="indent">
2437 Options Indexes FollowSymLinks<br />
2439 </Directory><br />
2441 <Directory /web/docs/spec><br />
2442 <span class="indent">
2443 Options +Includes -Indexes<br />
2448 <p>dann würden die Optionen <code>FollowSymLinks</code> und
2449 <code>Includes</code> für das Verzeichnis <code>/web/docs/spec</code>
2452 <div class="note"><h3>Anmerkung</h3>
2453 <p>Die Verwendung von <code>-IncludesNOEXEC</code> oder
2454 <code>-Includes</code> deaktiviert Server Side Includes unabhängig
2455 von der vorigen Einstellung vollständig.</p>
2458 <p>Die Voreinstellung ist <code>All</code>, sofern keine anderen Angaben
2462 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
2463 <div class="directive-section"><h2><a name="Require" id="Require">Require</a>-<a name="require" id="require">Direktive</a></h2>
2464 <table class="directive">
2465 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Wählt die authentisierten Benutzer aus, die auf eine
2466 Ressource zugreifen können</td></tr>
2467 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>Require <var>Name</var> [<var>Name</var>] ...</code></td></tr>
2468 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Verzeichnis, .htaccess</td></tr>
2469 <tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>AuthConfig</td></tr>
2470 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
2471 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
2473 <p>Die Direktive wählt aus, welche authentisierten Benutzer auf eine
2474 Ressource zugreifen dürfen. Folgende Syntax ist erlaubt:</p>
2477 <dt><code>Require user <var>User-ID</var> [<var>User-ID</var>]
2479 <dd>Nur die genannten Benutzer dürfen auf die Ressource
2482 <dt><code>Require group <var>Gruppenname</var> [<var>Gruppenname</var>]
2484 <dd>Nur Benutzer der genannten Gruppen dürfen auf die
2485 Ressource zugreifen.</dd>
2487 <dt><code>Require valid-user</code></dt>
2488 <dd>Alle gültigen Benutzer dürfen auf die Ressource
2492 <p><code class="directive">Require</code> muss von den Direktiven
2493 <code class="directive"><a href="#authname">AuthName</a></code> und <code class="directive"><a href="#authtype">AuthType</a></code> sowie Direktiven wie
2494 <code class="directive"><a href="../mod/mod_authn_file.html#authuserfile">AuthUserFile</a></code>
2495 und <code class="directive"><a href="../mod/mod_authz_groupfile.html#authgroupfile">AuthGroupFile</a></code>
2496 (zur Definition von Benutzern und Gruppen) begleitet werden, um
2497 korrekt zu funktionieren. Beispiel:</p>
2499 <div class="example"><p><code>
2500 AuthType Basic<br />
2501 AuthName "Geschützte Ressource"<br />
2502 AuthUserFile /web/users<br />
2503 AuthGroupFile /web/groups<br />
2507 <p>Zugriffskontrollen, die in dieser Form angewandt werden, gelten
2508 für <strong>alle</strong> Methoden. <strong>Dies ist normalerweise
2509 gewünscht.</strong> Wenn Sie Zugriffskontrollen nur auf bestimmte
2510 Methoden anwenden möchten, während andere Methoden
2511 ungeschützt bleiben, dann müssen Sie die
2512 <code class="directive">Require</code>-Anweisung innerhalb eines
2513 <code class="directive"><a href="#limit"><Limit></a></code>-Abschnitts
2518 <li><code class="directive"><a href="#satisfy">Satisfy</a></code></li>
2519 <li><code class="module"><a href="../mod/mod_authz_host.html">mod_authz_host</a></code></li>
2522 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
2523 <div class="directive-section"><h2><a name="RLimitCPU" id="RLimitCPU">RLimitCPU</a>-<a name="rlimitcpu" id="rlimitcpu">Direktive</a></h2>
2524 <table class="directive">
2525 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Begrenzt den CPU-Verbrauch von Prozessen, die von
2526 Apache-Kindprozessen gestartet wurden</td></tr>
2527 <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>
2528 <tr><th><a href="directive-dict.html#Default">Voreinstellung:</a></th><td><code>unbestimmt; verwendet die Voreinstellung des Systems</code></td></tr>
2529 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Serverkonfiguration, Virtual Host, Verzeichnis, .htaccess</td></tr>
2530 <tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>All</td></tr>
2531 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
2532 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
2534 <p>Akzeptiert einen oder zwei Parameter. Der erste Paramater setzt eine
2535 weiche Ressourcenbegrenzung für alle Prozesse, der zweite Parameter
2536 setzt die Maximalgrenze für die Ressourcennutzung. Jeder der
2537 Parameter kann eine Zahl oder <code>max</code> sein. <code>max</code>
2538 zeigt dem Server an, dass das vom Betriebssystem erlaubte Maximum
2539 verwendet werden soll. Das Anheben der maximal erlaubten Ressourcennutzung
2540 erfordert, dass der Server als <code>root</code> läuft, zumindest in
2541 der anfänglichen Startphase.</p>
2543 <p>Dies wird auf Prozesse angewendet, die von Anfragen bearbeitenden
2544 Apache-Kindprozessen abgespalten werden, nicht auf die
2545 Apache-Kindprozesse selbst. Das beinhaltet CGI-Skripte und
2546 SSI-exec-Befehle, nicht jedoch Prozesse, die vom Apache-Elternprozess
2547 abgespalten werden, wie z.B. Protokollierung.</p>
2549 <p>CPU-Ressourcenbegrenzung wird in Sekunden pro Prozess
2554 <li><code class="directive"><a href="#rlimitmem">RLimitMEM</a></code></li>
2555 <li><code class="directive"><a href="#rlimitnproc">RLimitNPROC</a></code></li>
2558 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
2559 <div class="directive-section"><h2><a name="RLimitMEM" id="RLimitMEM">RLimitMEM</a>-<a name="rlimitmem" id="rlimitmem">Direktive</a></h2>
2560 <table class="directive">
2561 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Begrenzt den Speicherverbrauch von Prozessen, die von
2562 Apache-Kindprozessen gestartet wurden</td></tr>
2563 <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>
2564 <tr><th><a href="directive-dict.html#Default">Voreinstellung:</a></th><td><code>unbestimmt; verwendet die Voreinstellung des Systems</code></td></tr>
2565 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Serverkonfiguration, Virtual Host, Verzeichnis, .htaccess</td></tr>
2566 <tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>All</td></tr>
2567 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
2568 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
2570 <p>Akzeptiert einen oder zwei Parameter. Der erste Paramater setzt eine
2571 weiche Ressourcenbegrenzung für alle Prozesse, der zweite Parameter
2572 setzt die Maximalgrenze für die Ressourcennutzung. Jeder der
2573 Parameter kann eine Zahl oder <code>max</code> sein. <code>max</code>
2574 zeigt dem Server an, dass das vom Betriebssystem erlaubte Maximum
2575 verwendet werden soll. Das Anheben der maximal erlaubten Ressourcennutzung
2576 erfordert, dass der Server als <code>root</code> läuft, zumindest in
2577 der anfänglichen Startphase.</p>
2579 <p>Dies wird auf Prozesse angewendet, die von Anfragen bearbeitenden
2580 Apache-Kindprozessen abgespalten werden, nicht auf die
2581 Apache-Kindprozesse selbst. Das beinhaltet CGI-Skripte und
2582 SSI-exec-Befehle, nicht jedoch Prozesse, die vom Apache-Elternprozess
2583 abgespalten werden, wie z.B. Protokollierung.</p>
2585 <p>Die Begrenzung des Speicherverbrauchs wird in Bytes pro Prozess
2590 <li><code class="directive"><a href="#rlimitcpu">RLimitCPU</a></code></li>
2591 <li><code class="directive"><a href="#rlimitnproc">RLimitNPROC</a></code></li>
2594 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
2595 <div class="directive-section"><h2><a name="RLimitNPROC" id="RLimitNPROC">RLimitNPROC</a>-<a name="rlimitnproc" id="rlimitnproc">Direktive</a></h2>
2596 <table class="directive">
2597 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Begrenzt die Anzahl der Prozesse, die von Prozessen gestartet
2598 werden können, der ihrerseits von Apache-Kinprozessen gestartet
2600 <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>
2601 <tr><th><a href="directive-dict.html#Default">Voreinstellung:</a></th><td><code>unbestimmt; verwendet die Voreinstellung des Systems</code></td></tr>
2602 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Serverkonfiguration, Virtual Host, Verzeichnis, .htaccess</td></tr>
2603 <tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>All</td></tr>
2604 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
2605 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
2607 <p>Akzeptiert einen oder zwei Parameter. Der erste Paramater setzt eine
2608 weiche Ressourcenbegrenzung für alle Prozesse, der zweite Parameter
2609 setzt die Maximalgrenze für die Ressourcennutzung. Jeder der
2610 Parameter kann eine Zahl oder <code>max</code> sein. <code>max</code>
2611 zeigt dem Server an, dass das vom Betriebssystem erlaubte Maximum
2612 verwendet werden soll. Das Anheben der maximal erlaubten Ressourcennutzung
2613 erfordert, dass der Server als <code>root</code> läuft, zumindest in
2614 der anfänglichen Startphase.</p>
2616 <p>Dies wird auf Prozesse angewendet, die von Anfragen bearbeitenden
2617 Apache-Kindprozessen abgespalten werden, nicht auf die
2618 Apache-Kindprozesse selbst. Dies beinhaltet CGI-Skripte und
2619 SSI-exec-Befehle, nicht jedoch Prozesse, die vom Apache-Elternprozess
2620 abgespalten werden, wie z.B. Protokollierung.</p>
2622 <p>Prozessbegrenzungen steuern die Anzahl der Prozesse pro Benutzer.</p>
2624 <div class="note"><h3>Anmerkung</h3>
2625 <p>Wenn CGI-Prozesse nicht unter anderen Benutzerkennungen als der
2626 User-ID des Webservers laufen, dann beschränkt diese Direktive
2627 die Anzahl der Prozesse, die der Server selbst erstellen kann.
2628 Kennzeichen einer solchen Situation sind
2629 <strong><code>cannot fork</code></strong>-Meldungen
2630 <span class="transnote">(<em>Anm.d.Ü.:</em> <code>kann nicht abspalten</code>)</span> in der
2631 Datei <code>error_log</code>.</p>
2636 <li><code class="directive"><a href="#rlimitmem">RLimitMEM</a></code></li>
2637 <li><code class="directive"><a href="#rlimitcpu">RLimitCPU</a></code></li>
2640 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
2641 <div class="directive-section"><h2><a name="Satisfy" id="Satisfy">Satisfy</a>-<a name="satisfy" id="satisfy">Direktive</a></h2>
2642 <table class="directive">
2643 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Zusammenspiel von rechnerbasierter Zugriffskontrolle und
2644 Benutzerauthentisierung</td></tr>
2645 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>Satisfy Any|All</code></td></tr>
2646 <tr><th><a href="directive-dict.html#Default">Voreinstellung:</a></th><td><code>Satisfy All</code></td></tr>
2647 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Verzeichnis, .htaccess</td></tr>
2648 <tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>AuthConfig</td></tr>
2649 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
2650 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
2651 <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>
2653 <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
2654 entweder <code>All</code> oder <code>Any</code> sein. Die Direktive ist
2655 nur dann nützlich, wenn der Zugriff zu einem bestimmten Bereich
2656 durch Benutzername/Passwort <em>und</em> Clientrechner-Adressen
2657 eingeschränkt ist. In diesem Fall verlangt die Voreinstellung
2658 (<code>All</code>), dass der Client die Adressbeschränkung passiert
2659 <em>und</em> eine gültige Benutzerkennung und ein gültiges
2660 Passwort übermittelt. Mit der Auswahl <code>Any</code> wird dem
2661 Client der Zugriff erlaubt, wenn er entweder die Rechner-Beschänkung
2662 passiert oder einen gültigen Benutzernamen und ein gültiges
2663 Passwort übermittelt. Dies kann verwendet werden, um einen Bereich
2664 mit einem Passwort zu schützen, jedoch Clients von bestimmten
2665 Adressen ohne Abfrage des Passwortes zuzulassen.</p>
2667 <p>Wenn Sie beispielsweise möchten, dass Personen aus Ihrem
2668 privaten Netzwerk unbechänkten Zugriff zu Teilen Ihres
2669 Webangebots haben, jedoch verlangen, dass Personen außerhalb
2670 Ihres privaten Netzwerks ein Passwort übergeben müssen,
2671 können Sie eine Konfiguration ähnlich der folgenden
2674 <div class="example"><p><code>
2675 Require valid-user<br />
2676 Allow from 192.168.1<br />
2680 <p>Seit Version 2.0.51 können
2681 <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
2682 beschränkt werden.</p>
2686 <li><code class="directive"><a href="../mod/mod_authz_host.html#allow">Allow</a></code></li>
2687 <li><code class="directive"><a href="#require">Require</a></code></li>
2690 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
2691 <div class="directive-section"><h2><a name="ScriptInterpreterSource" id="ScriptInterpreterSource">ScriptInterpreterSource</a>-<a name="scriptinterpretersource" id="scriptinterpretersource">Direktive</a></h2>
2692 <table class="directive">
2693 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Methode zur Ermittlung des Interpreters von
2694 CGI-Skripten</td></tr>
2695 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>ScriptInterpreterSource Registry|Registry-Strict|Script</code></td></tr>
2696 <tr><th><a href="directive-dict.html#Default">Voreinstellung:</a></th><td><code>ScriptInterpreterSource Script</code></td></tr>
2697 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Serverkonfiguration, Virtual Host, Verzeichnis, .htaccess</td></tr>
2698 <tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>FileInfo</td></tr>
2699 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
2700 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
2701 <tr><th><a href="directive-dict.html#Compatibility">Kompatibilität:</a></th><td>ausschließlich Win32;
2702 Die Option <code>Registry-Strict</code> ist verfügbar seit Apache
2705 <p>Die Direktive steuert, wie der Apache den Interpreter zur Ausführung
2706 von CGI-Skripten bestimmt. Die Voreinstellung ist <code>Script</code>. Dies
2707 veranlaßt den Apache, den Interpreter zu verwenden, auf den die
2708 Shebang-Zeile (erste Zeile, beginnt mit <code>#!</code>) im Skript zeigt.
2709 Auf Win32-Systemen sieht diese Zeile üblicherweise so aus:</p>
2711 <div class="example"><p><code>
2712 #!C:/Perl/bin/perl.exe
2715 <p>oder, wenn <code>perl</code> im Pfad (Umgebungsvariable <code>PATH</code>) liegt,
2718 <div class="example"><p><code>
2722 <p>Die Einstellung <code>ScriptInterpreterSource Registry</code>
2723 veranlaßt eine Suche in <code>HKEY_CLASSES_ROOT</code> der
2724 Windows-Registrierungsdatenbank und verwendet die Endung der Skript-Datei
2725 (z.B. <code>.pl</code>) als Suchargument. Der durch den Unterschlüssel
2726 <code>Shell\ExecCGI\Command</code> oder, falls dieser nicht existiert,
2727 <code>Shell\Open\Command</code> definierte Befehl wird zum Öffnen der
2728 Skript-Datei verwendet. Wenn der Schlüssel zur Dateiendung oder
2729 beide Unterschlüssel fehlen, dann verwendet der Apache die Option
2730 <code>Script</code>.</p>
2732 <div class="warning"><h3>Sicherheit</h3>
2733 <p>Seien Sie vorsichtig, <code>ScriptInterpreterSource Registry</code> bei
2734 Verzeichnissen zu verwenden, auf die eine <code class="directive"><a href="../mod/mod_alias.html#scriptalias">ScriptAlias</a></code>-Anweisung zeigt, denn der
2735 Apache versucht <strong>jede</strong> Datei innerhalb des Verzeichnisses
2736 auszuführen. Die Einstellung <code>Registry</code> kann
2737 unerwünschte Programmaufrufe bei Dateien verursachen, die
2738 üblicherweise nicht ausgeführt werden. Auf den meisten
2739 Windows-Systemen beispielsweise startet der voreingestellte
2740 Öffnen-Befehl für <code>.htm</code>-Dateien den Microsoft
2741 Internet Explorer, so dass jede HTTP-Anfrage nach einer existierenden
2742 <code>.htm</code>-Datei im Skript-Verzeichnis den Browser im Hintergrund
2743 starten würde. Dies ist eine wirksame Methode, Ihr System binnen
2744 etwa einer Minute zum Absturz zu bringen.</p>
2747 <p>Die seit Apache 2.0 neue Option <code>Registry-Strict</code>
2748 macht das gleiche wie <code>Registry</code>, verwendet jedoch nur den
2749 Unterschlüssel <code>Shell\ExecCGI\Command</code>. Der Schlüssel
2750 <code>ExecCGI</code> ist gewöhnlich nicht voreingestellt. Er muss
2751 manuell eingerichtet werden und schützt Ihr System so for
2752 versehentlichen Programmaufrufen.</p>
2755 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
2756 <div class="directive-section"><h2><a name="ServerAdmin" id="ServerAdmin">ServerAdmin</a>-<a name="serveradmin" id="serveradmin">Direktive</a></h2>
2757 <table class="directive">
2758 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>E-Mail-Adresse, die der Server in Fehlermeldungen einfügt,
2759 welche an den Client gesendet werden</td></tr>
2760 <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>
2761 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Serverkonfiguration, Virtual Host</td></tr>
2762 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
2763 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
2765 <p><code class="directive">ServerAdmin</code> legt die Kontaktadresse fest,
2766 die der Server in jede Fehlermeldung einfügt, die er an den
2767 Client zurückschickt. Wenn <code>httpd</code> das übergebene
2768 Argument nicht als URL erkennt, nimmt er an, dess es sich um eine
2769 <var>E-Mail-Adresse</var> handelt und stellt in Hyperlinks
2770 <code>mailto:</code> voran. Es ist jedoch sogar sinnvoll, eine
2771 E-Mail-Adresse zu verwenden, da viele CGI-Skripte davon ausgehen. Wenn Sie
2772 eine URL verwenden möchten, sollten Sie auf einem anderen unter Ihrer
2773 Kontrolle stehenden Server verweisen. Andernfalls können Besucher Sie
2774 im Fehlerfall möglicherweise nicht kontaktieren.</p>
2776 <p>Es kann sich lohnen, hierfür eine reservierte Adresse
2779 <div class="example"><p><code>
2780 ServerAdmin www-admin@foo.example.com
2783 <p>da Anwender nicht unbedingt erwähnen, dass sie vom Server
2787 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
2788 <div class="directive-section"><h2><a name="ServerAlias" id="ServerAlias">ServerAlias</a>-<a name="serveralias" id="serveralias">Direktive</a></h2>
2789 <table class="directive">
2790 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Alternativer Name für einen Host, der verwendet wird, wenn
2791 Anfragen einem namensbasierten virtuellen Host zugeordnet werden</td></tr>
2792 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>ServerAlias <var>Hostname</var> [<var>Hostname</var>] ...</code></td></tr>
2793 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>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>
2797 <p>Die Direktive <code class="directive">ServerAlias</code> bestimmt die
2798 alternativen Namen eines Hosts zur Verwendung mit <a href="../vhosts/name-based.html">namensbasierten virtuellen Hosts</a>.</p>
2800 <div class="example"><p><code>
2801 <VirtualHost *><br />
2802 ServerName server.domain.com<br />
2803 ServerAlias server server2.domain.com server2<br />
2805 </VirtualHost>
2810 <li><a href="../vhosts/">Apache-Dokumentation zu virtuellen
2814 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
2815 <div class="directive-section"><h2><a name="ServerName" id="ServerName">ServerName</a>-<a name="servername" id="servername">Direktive</a></h2>
2816 <table class="directive">
2817 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Rechnername und Port, die der Server dazu verwendet, sich
2818 selbst zu identifizieren</td></tr>
2819 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>ServerName
2820 <var>voll-qualifizierter-Domainname</var>[:<var>port</var>]</code></td></tr>
2821 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Serverkonfiguration, Virtual Host</td></tr>
2822 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
2823 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
2824 <tr><th><a href="directive-dict.html#Compatibility">Kompatibilität:</a></th><td>Diese Direktive löst in Version 2.0 die
2825 Funktionalität der Direktive <code class="directive">Port</code> aus
2826 Version 1.3 ab.</td></tr>
2828 <p>Die Direktive <code class="directive">ServerName</code> bestimmt den
2829 Rechnernamen und Port, den der Server dazu verwendet, sich selbst
2830 zu identifizieren. Diese werden bei der Erstellung von Umleitungs-URLs
2831 benötigt. Wenn beispielsweise der Name der Maschine, die den Webserver
2832 beherbergt, <code>simple.example.com</code> lautet, die Maschine jedoch
2833 auch einen DNS-Alias <code>www.example.com</code> besitzt und Sie den
2834 Webserver so identifizieren möchten, sollten Sie die folgende
2835 Anweisung verwenden:</p>
2837 <div class="example"><p><code>
2838 ServerName www.example.com:80
2841 <p>Wenn kein <code class="directive">ServerName</code> angegeben wurde,
2842 dann versucht der Server den Rechnernamen mittels eines Reverse-Lookup
2843 herzuleiten. Wenn kein Port in der
2844 <code class="directive">ServerName</code>-Anweisung angegeben wurde, dann
2845 verwendet der Server den Port der eingegangenen Anfrage. Für eine
2846 optimale Zuverlässigkeit und Berechenbarkeit sollten Sie einen
2847 eindeutigen Rechnernamen und Port angeben, in dem Sie die Direktive
2848 <code class="directive">ServerName</code> verwenden.</p>
2850 <p>Wenn Sie <a href="../vhosts/name-based.html">namensbasierte
2851 virtuelle Hosts</a> verwenden, gibt <code class="directive">ServerName</code>
2852 innerhalb eines <code class="directive"><a href="#virtualhost"><VirtualHost></a></code>-Abschnitts an, welcher
2853 Hostname im <code>Host:</code>-Header der Anfrage auftauchen muss,
2854 damit sie diesem virtuellen Host zugeordnet wird.</p>
2856 <p>Lesen Sie bitte die Beschreibung der Direktive <code class="directive"><a href="#usecanonicalname">UseCanonicalName</a></code> für Einstellungen, die
2857 bestimmen, ob selbstreferenzierende URLs (z.B. vom Modul
2858 <code class="module"><a href="../mod/mod_dir.html">mod_dir</a></code>) auf den angegebenen Port zeigen oder auf die
2859 Portnummern die in der Anfrage des Clients angegeben ist.</p>
2863 <li><a href="../dns-caveats.html">Probleme bezüglich DNS und
2865 <li><a href="../vhosts/">Apache-Dokumentation zu virtuellen
2867 <li><code class="directive"><a href="#usecanonicalname">UseCanonicalName</a></code></li>
2868 <li><code class="directive"><a href="#namevirtualhost">NameVirtualHost</a></code></li>
2869 <li><code class="directive"><a href="#serveralias">ServerAlias</a></code></li>
2872 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
2873 <div class="directive-section"><h2><a name="ServerPath" id="ServerPath">ServerPath</a>-<a name="serverpath" id="serverpath">Direktive</a></h2>
2874 <table class="directive">
2875 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Veralteter URL-Pfad für einen namensbasierten
2876 virtuellen Host, auf den von einem inkompatiblen Browser zugegriffen
2878 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>ServerPath <var>URL-Pfad</var></code></td></tr>
2879 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Virtual Host</td></tr>
2880 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
2881 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
2883 <p>Die Direktive <code class="directive">ServerPath</code> legt den
2884 veralteten <span class="transnote">(<em>Anm.d.Ü.:</em> Gemeint ist eigentlich "Altlast" aufgrund
2885 antiquierter Clients.)</span> URL-Pfad eines Hosts zur Verwendung mit
2886 <a href="../vhosts/">namensbasierten virtuellen Hosts</a> fest.</p>
2890 <li><a href="../vhosts/">Apache-Dokumentation zu virtuellen
2894 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
2895 <div class="directive-section"><h2><a name="ServerRoot" id="ServerRoot">ServerRoot</a>-<a name="serverroot" id="serverroot">Direktive</a></h2>
2896 <table class="directive">
2897 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Basisverzeichnis der Serverinstallation</td></tr>
2898 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>ServerRoot <var>Verzeichnis</var></code></td></tr>
2899 <tr><th><a href="directive-dict.html#Default">Voreinstellung:</a></th><td><code>ServerRoot /usr/local/apache</code></td></tr>
2900 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Serverkonfiguration</td></tr>
2901 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
2902 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
2904 <p>Die Direktive <code class="directive">ServerRoot</code> bestimmt das
2905 Verzeichnis, in dem der Server installiert ist. Üblicherweise
2906 enthält es die Unterverzeichnisse <code>conf/</code> und
2907 <code>logs/</code>. Relative Pfadangaben anderer Direktiven (wie z.B.
2908 <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
2909 Verzeichnis betrachtet.</p>
2911 <div class="example"><h3>Beispiel</h3><p><code>
2912 ServerRoot /home/httpd
2917 <li><a href="../invoking.html">Die <code>httpd</code>-Option
2918 <code>-d</code></a></li>
2919 <li><a href="../misc/security_tips.html#serverroot">Sicherheitshinweise</a>
2920 für Informationen, wie die Rechte auf das <code class="directive">ServerRoot</code>-Verzeichnis richtig gesetzt werden</li>
2923 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
2924 <div class="directive-section"><h2><a name="ServerSignature" id="ServerSignature">ServerSignature</a>-<a name="serversignature" id="serversignature">Direktive</a></h2>
2925 <table class="directive">
2926 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Konfiguriert die Fußzeile von servergenerierten
2927 Dokumenten</td></tr>
2928 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>ServerSignature On|Off|EMail</code></td></tr>
2929 <tr><th><a href="directive-dict.html#Default">Voreinstellung:</a></th><td><code>ServerSignature Off</code></td></tr>
2930 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Serverkonfiguration, Virtual Host, Verzeichnis, .htaccess</td></tr>
2931 <tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>All</td></tr>
2932 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
2933 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
2935 <p>Die Direktive <code class="directive">ServerSignature</code> ermöglicht
2936 die Gestaltung einer unter servergenerierten Dokumenten (z.B.
2937 Fehlerdokumente, FTP-Verzeichnislisten von <code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code>,
2938 <code class="module"><a href="../mod/mod_info.html">mod_info</a></code>-Ausgaben, ...) angefügten
2939 Fußzeile. Ein möglicher Grund für die Aktivierung einer
2940 solchen Fußzeile ist, dass der Anwender bei einer Kette von
2941 Proxy-Servern oft keine Möglichkeit hat, zu erkennen, welcher der
2942 verketteten Server gegenwärtig die zurückgegebene Fehlermeldung
2945 <p>Die (Vor-)Einstellung <code>Off</code> unterdrückt die
2946 Fußzeile (und ist damit kompatibel zum Verhalten des Apache 1.2 und
2947 früher). Die Einstellung <code>On</code> fügt schlicht eine
2948 Zeile mit der Versionsnummer des Servers und dem Servernamen (<code class="directive"><a href="#servername">ServerName</a></code>) des bedienenden virtuellen Hosts an.
2949 Die Einstellung <code>EMail</code> erstellt zusätzlich einen
2950 "mailto:"-Verweis zum Serveradministrator (<code class="directive"><a href="#serveradmin">ServerAdmin</a></code>) des referenzierten Dokuments.</p>
2952 <p>Ab Version 2.0.44 werden die Details der angegebenen Versionsnummer des
2953 Servers von der Direktive <code class="directive"><a href="#servertokens">ServerTokens</a></code> kontrolliert.</p>
2957 <li><code class="directive"><a href="#servertokens">ServerTokens</a></code></li>
2960 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
2961 <div class="directive-section"><h2><a name="ServerTokens" id="ServerTokens">ServerTokens</a>-<a name="servertokens" id="servertokens">Direktive</a></h2>
2962 <table class="directive">
2963 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Konfiguriert den HTTP-Response-Header
2964 <code>Server</code></td></tr>
2965 <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>
2966 <tr><th><a href="directive-dict.html#Default">Voreinstellung:</a></th><td><code>ServerTokens Full</code></td></tr>
2967 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Serverkonfiguration</td></tr>
2968 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
2969 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
2971 <p>die Direktive steuert, ob der Response-Header <code>Server</code>,
2972 der an den Client zurückgesendet wird, eine Beschreibung des
2973 allgemeinen Betriesbsystemtyps des Servers wie auch Informationen
2974 über einkompilierte Module enthält.</p>
2977 <dt><code>ServerTokens Prod[uctOnly]</code></dt>
2979 <dd>Der Server sendet (<em>z.B.</em>): <code>Server:
2982 <dt><code>ServerTokens Major</code></dt>
2984 <dd>Der Server sendet (<em>z.B.</em>): <code>Server:
2985 Apache/2</code></dd>
2987 <dt><code>ServerTokens Minor</code></dt>
2989 <dd>Der Server sendet (<em>z.B.</em>): <code>Server:
2990 Apache/2.0</code></dd>
2992 <dt><code>ServerTokens Min[imal]</code></dt>
2994 <dd>Der Server sendet (<em>z.B.</em>): <code>Server:
2995 Apache/2.0.41</code></dd>
2997 <dt><code>ServerTokens OS</code></dt>
2999 <dd>Der Server sendet (<em>z.B.</em>): <code>Server: Apache/2.0.41
3002 <dt><code>ServerTokens Full</code> (oder nicht angegeben)</dt>
3004 <dd>Der Server sendet (<em>z.B.</em>): <code>Server: Apache/2.0.41
3005 (Unix) PHP/4.2.2 MyMod/1.2</code></dd>
3008 <p>Diese Einstellung gilt für den gesamten Server und kann nicht
3009 auf Virtual-Host-Basis aktiviert oder deaktiviert werden.</p>
3011 <p>Ab Version 2.0.44 steuert diese Direktive auch die Informationen, die
3012 durch die Direktive <code class="directive"><a href="#serversignature">ServerSignature</a></code>
3013 angeboten werden.</p>
3017 <li><code class="directive"><a href="#serversignature">ServerSignature</a></code></li>
3020 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
3021 <div class="directive-section"><h2><a name="SetHandler" id="SetHandler">SetHandler</a>-<a name="sethandler" id="sethandler">Direktive</a></h2>
3022 <table class="directive">
3023 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Erzwingt die Verarbeitung aller passenden Dateien durch
3024 einen Handler</td></tr>
3025 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>SetHandler <var>Handlername</var>|None</code></td></tr>
3026 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Serverkonfiguration, Virtual Host, Verzeichnis, .htaccess</td></tr>
3027 <tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>FileInfo</td></tr>
3028 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
3029 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
3030 <tr><th><a href="directive-dict.html#Compatibility">Kompatibilität:</a></th><td>Seit Apache 2.0 im Core</td></tr>
3032 <p>Wenn die Direktive innerhalb einer <code>.htaccess</code>-Datei
3033 oder in einem <code class="directive"><a href="#directory"><Directory></a></code>- oder
3034 <code class="directive"><a href="#location"><Location></a></code>-Abschnitt
3035 angegeben wird, erzwingt sie, dass alle entsprechenden Dateien von dem
3036 durch <var>Handlername</var> angegebenen <a href="../handler.html">Handler</a> analysiert werden. Wenn Sie
3037 beispielsweise ein Verzeichnis haben, dessen Dateien unabhängig von
3038 der Endung gänzlich als Image-Maps interpretiert werden sollen,
3039 können Sie folgendes in eine <code>.htaccess</code>-Datei in
3040 dem Verzeichnis schreiben:</p>
3042 <div class="example"><p><code>
3043 SetHandler imap-file
3046 <p>Noch ein Beispiel: wenn Sie den Server immer, wenn die URL
3047 <code>http://servername/status</code> aufgerufen wird, einen
3048 Statusbericht anzeigen lassen möchten, dann können
3049 Sie folgendes in die <code>httpd.conf</code> schreiben:</p>
3051 <div class="example"><p><code>
3052 <Location /status><br />
3053 <span class="indent">
3054 SetHandler server-status<br />
3058 <p>Sie können eine zuvor definierte
3059 <code class="directive">SetHandler</code>-Anweisung aufheben, indem Sie den Wert
3060 <code>None</code> verwenden.</p>
3064 <li><code class="directive"><a href="../mod/mod_mime.html#addhandler">AddHandler</a></code></li>
3067 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
3068 <div class="directive-section"><h2><a name="SetInputFilter" id="SetInputFilter">SetInputFilter</a>-<a name="setinputfilter" id="setinputfilter">Direktive</a></h2>
3069 <table class="directive">
3070 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Bestimmt die Filter, die Client-Anfragen und POST-Eingaben
3071 verarbeiten</td></tr>
3072 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>SetInputFilter <var>Filter</var>[;<var>Filter</var>...]</code></td></tr>
3073 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Serverkonfiguration, Virtual Host, Verzeichnis, .htaccess</td></tr>
3074 <tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>FileInfo</td></tr>
3075 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
3076 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
3078 <p>Die Direktive <code class="directive">SetInputFilter</code> bestimmt den oder
3079 die Filter, die Client-Anfragen und POST-Eingaben verarbeiten, wenn
3080 sie vom Server empfangen werden. Diese gelten zusätzlich zu
3081 anderweitig definierten Filtern, einschließlich denen der Direktive
3082 <code class="directive"><a href="../mod/mod_mime.html#addinputfilter">AddInputFilter</a></code>.</p>
3084 <p>Wenn mehr als ein Filter angegeben wird, dann müssen diese
3085 durch Semikolon voneinander getrennt in der Reihenfolge angegeben werden,
3086 in der sie die Daten verarbeiten sollen.</p>
3090 <li><a href="../filter.html">Filter</a>-Dokumentation</li>
3093 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
3094 <div class="directive-section"><h2><a name="SetOutputFilter" id="SetOutputFilter">SetOutputFilter</a>-<a name="setoutputfilter" id="setoutputfilter">Direktive</a></h2>
3095 <table class="directive">
3096 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Bestimmt die Filter, die Antworten des Servers verarbeiten</td></tr>
3097 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>SetOutputFilter <var>Filter</var>[;<var>Filter</var>...]</code></td></tr>
3098 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Serverkonfiguration, Virtual Host, Verzeichnis, .htaccess</td></tr>
3099 <tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>FileInfo</td></tr>
3100 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
3101 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
3103 <p>Die Direktive <code class="directive">SetOutputFilter</code> bestimmt
3104 die Filter, die Antworten des Servers verarbeiten, bevor sie an den
3105 Client gesendet werden. Diese gelten zusätzlich zu anderweitig
3106 definierten Filtern, einschließlich denen der Direktive
3107 <code class="directive"><a href="../mod/mod_mime.html#addoutputfilter">AddOutputFilter</a></code>.</p>
3109 <p>Die folgende Konfiguration verarbeitet zum Beispiel alle Dateien
3110 im Verzeichnis <code>/www/data</code> als Server Side Includes.</p>
3112 <div class="example"><p><code>
3113 <Directory /www/data/><br />
3114 <span class="indent">
3115 SetOutputFilter INCLUDES<br />
3120 <p>Wenn mehr als ein Filter angegeben wird, dann müssen diese
3121 durch Semikolon voneinander getrennt in der Reihenfolge angegeben werden,
3122 in der sie die Daten verarbeiten sollen.</p>
3126 <li><a href="../filter.html">Filter</a>-Dokumentation</li>
3129 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
3130 <div class="directive-section"><h2><a name="TimeOut" id="TimeOut">TimeOut</a>-<a name="timeout" id="timeout">Direktive</a></h2>
3131 <table class="directive">
3132 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Zeitspanne, die der Server auf verschiedene Ereignisse wartet,
3133 bevor er die Anfrage abbricht</td></tr>
3134 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>TimeOut <var>Sekunden</var></code></td></tr>
3135 <tr><th><a href="directive-dict.html#Default">Voreinstellung:</a></th><td><code>TimeOut 300</code></td></tr>
3136 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Serverkonfiguration</td></tr>
3137 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
3138 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
3140 <p>Die Direktive <code class="directive">TimeOut</code> definiert derzeit die
3141 Zeitspanne, die der Apache auf drei Dinge wartet:</p>
3144 <li>Die gesamte Zeispanne, die benötigt wird, um eine GET-Anfrage
3147 <li>Die Zeitspanne zwischen dem Empfang von TCP-Paketen einer
3148 POST- oder PUT-Anfrage.</li>
3150 <li>Die Zeitspanne zwischen ACKs bei der Übermittlung der
3151 TCP-Pakete der Antwort.</li>
3154 <p>Wir haben vor, diese Zeitspannen in Zukunft separat konfigurierbar zu
3155 machen. Vor Version 1.2 war der Zeitgeber auf 1200 voreingestellt, wurde
3156 dann aber auf 300 herabgesetzt, was immer noch weit mehr ist, als in den
3157 meisten Situationen benötigt wird. Die Voreinstellung wurde nicht
3158 weiter herabgesetzt, da gelegentlich noch Stellen im Code existieren
3159 können, wo der Zeitgeber nicht zurückgesetzt wird, wenn ein
3160 Paket verschickt wird.</p>
3163 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
3164 <div class="directive-section"><h2><a name="UseCanonicalName" id="UseCanonicalName">UseCanonicalName</a>-<a name="usecanonicalname" id="usecanonicalname">Direktive</a></h2>
3165 <table class="directive">
3166 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Bestimmt, wie der Server seinen eigenen Namen und Port
3168 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>UseCanonicalName On|Off|DNS</code></td></tr>
3169 <tr><th><a href="directive-dict.html#Default">Voreinstellung:</a></th><td><code>UseCanonicalName Off</code></td></tr>
3170 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Serverkonfiguration, Virtual Host, Verzeichnis</td></tr>
3171 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
3172 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
3174 <p>In vielen Situationen muss der Apache eine
3175 <em>selbstreferenzierende</em> URL -- d.h. eine URL, die auf den selben
3176 Server zurück verweist -- zusammenbauen. Bei <code>UseCanonicalName
3177 On</code> verwendet der Apache den Hostnamen und Port, der in der
3178 <code class="directive"><a href="#servername">ServerName</a></code>-Anweisung angegeben ist,
3179 um den kanonischen Namen des Servers zu erstellen. Dieser Name wird in
3180 allen selbstreferenzierenden URLs sowie in CGI-Skripten für die
3181 Werte von <code>SERVER_NAME</code> und <code>SERVER_PORT</code>
3184 <p>Bei <code>UseCanonicalName Off</code> bildet der Apache
3185 selbstreferenzierende URLs, indem er den vom Client übermittelten
3186 Hostnamen und Port verwendet, sofern diese vorhanden sind (andernfalls
3187 wird der kanonische Name, wie oben beschrieben, benutzt). Die Werte
3188 sind die gleichen, die zur Anwendung von <a href="../vhosts/name-based.html">namensbasierten virtuellen Hosts</a>
3189 verwendet werden, und sie sind mit den gleichen Clients verfügbar
3190 <span class="transnote">(<em>Anm.d.Ü.:</em> , die auch in der Lage sind, auf namensbasierte virtuelle Hosts
3191 zuzugreifen, d.h. einen <code>Host</code>-Header mitschicken)</span>.
3192 Die CGI-Variablen <code>SERVER_NAME</code> und <code>SERVER_PORT</code>
3193 werden ebenfalls aus den vom Client angeboten Werten erstellt.</p>
3195 <p>Ein Intranet-Server, auf den Anwender mit kurzen Namen wie
3196 <code>www</code> zugreifen, ist ein Beispiel, wo dies sinnvoll sein kann.
3197 Sie werden bemerken, dass der Apache den Benutzer auf
3198 <code>http://www.domain.com/splat/</code> umleitet, wenn dieser einen
3199 Kurznamen und eine URL, die einem Verzeichnis entspricht, ohne
3200 abschließenden Schrägstrich eingibt, wie z.B.
3201 <code>http://www/splat</code>. Wenn Sie Authentisierung aktiviert haben,
3202 bewirkt dies, dass der Benutzer sich zweimal identifizieren muss
3203 (einmal für <code>www</code> und noch einmal für
3204 <code>www.domain.com</code> -- lesen Sie für weitere Informationen <a href="http://httpd.apache.org/docs/misc/FAQ.html#prompted-twice">die
3205 FAQ zu diesem Thema</a>). Wenn <code class="directive">UseCanonicalName</code>
3206 jedoch auf <code>Off</code> gesetzt ist, denn wird der Apache zu
3207 <code>http://www/splat/</code> umleiten.</p>
3209 <p>Es existiert noch eine dritte Option, <code>UseCanonicalName DNS</code>,
3210 die für den Betrieb von IP-basierten Massen-Virtual-Hosts gedacht ist,
3211 um antiquierte Clients zu unterstützen, die keinen
3212 <code>Host:</code>-Header bereit stellen. Um selbstreferenzierende
3213 URLs zu ermitteln, führt der Apache bei dieser Option ein
3214 Reverse-DNS-Lookup auf die IP-Adresse des Servers aus, zu der der Client
3215 Verbindung aufgenommen hat.</p>
3217 <div class="warning"><h3>Warnung</h3>
3218 <p>Wenn CGI-Skripte Vermutungen aufgrund des Wertes von
3219 <code>SERVER_NAME</code> anstellen, können sie durch diese
3220 Option fehlschlagen. Clients steht es im Wesentlichen frei, einen Wert
3221 für den Hostnamen anzugeben, wie er will. Wenn das
3222 CGI-Skript <code>SERVER_NAME</code> jedoch lediglich dazu verwendet,
3223 selbstreferenzierende URLs zu erstellen, sollte das gerade noch
3224 in Ordnung sein.</p>
3229 <li><code class="directive"><a href="#servername">ServerName</a></code></li>
3230 <li><code class="directive"><a href="../mod/mpm_common.html#listen">Listen</a></code></li>
3233 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
3234 <div class="directive-section"><h2><a name="VirtualHost" id="VirtualHost"><VirtualHost></a>-<a name="virtualhost" id="virtualhost">Direktive</a></h2>
3235 <table class="directive">
3236 <tr><th><a href="directive-dict.html#Description">Beschreibung:</a></th><td>Enthält Direktiven, die nur auf bestimmte Hostnamen oder
3237 IP-Adressen angewendet werden</td></tr>
3238 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code><VirtualHost
3239 <var>Adresse</var>[:<var>Port</var>] [<var>Adresse</var>[:<var>Port</var>]]
3240 ...> ... </VirtualHost></code></td></tr>
3241 <tr><th><a href="directive-dict.html#Context">Kontext:</a></th><td>Serverkonfiguration</td></tr>
3242 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Core</td></tr>
3243 <tr><th><a href="directive-dict.html#Module">Modul:</a></th><td>core</td></tr>
3245 <p><code class="directive"><VirtualHost></code> und
3246 <code></VirtualHost></code> werden dazu verwendet, eine Gruppe
3247 von Direktiven zusammenzufassen, die nur auf einen bestimmten virtuellen
3248 Host angewendet werden. Jede Direktive, die im Virtual-Host-Kontext
3249 zulässig ist, kann verwendet werden. Wenn der Server eine Anfrage
3250 für ein bestimmtes Dokument eines bestimmten virtuellen Hosts
3251 empfängt, dann benutzt er die im
3252 <code class="directive"><VirtualHost></code>-Container enthaltenen
3253 Konfigurationsanweisungen. <var>Adresse</var> kann sein:</p>
3256 <li>Die IP-Adresse des virtuellen Hosts.</li>
3258 <li>Ein voll qualifizierter Domainname für die IP-Adresse des
3259 virtuellen Hosts.</li>
3261 <li>Das Zeichen <code>*</code>, welches nur in Kombination mit
3262 <code>NameVirtualHost *</code> verwendet wird, um allen IP-Adressen
3263 zu entsprechen.</li>
3265 <li>Die Zeichenkette <code>_default_</code>, die nur mit IP-basierten
3266 virtuellen Hosts verwendet wird, um nicht zugewiesene IP-Adressen
3270 <div class="example"><h3>Beispiel</h3><p><code>
3271 <VirtualHost 10.1.2.3><br />
3272 <span class="indent">
3273 ServerAdmin webmaster@host.foo.com<br />
3274 DocumentRoot /www/docs/host.foo.com<br />
3275 ServerName host.foo.com<br />
3276 ErrorLog logs/host.foo.com-error_log<br />
3277 TransferLog logs/host.foo.com-access_log<br />
3279 </VirtualHost>
3282 <p>IPv6-Adressen müssen in eckigen Klammern angegeben werden, da die
3283 optionale Portnummer sonst nicht erkannt werden kann. Hier ein
3286 <div class="example"><p><code>
3287 <VirtualHost [2001:db8::a00:20ff:fea7:ccea]><br />
3288 <span class="indent">
3289 ServerAdmin webmaster@host.example.com<br />
3290 DocumentRoot /www/docs/host.example.com<br />
3291 ServerName host.example.com<br />
3292 ErrorLog logs/host.example.com-error_log<br />
3293 TransferLog logs/host.example.com-access_log<br />
3295 </VirtualHost>
3298 <p>Jeder virtuelle Host muss einer anderen IP-Adresse, einem anderen Port
3299 oder einem anderen Hostnamen für den Server entsprechen. Im ersten
3300 Fall muss die Servermaschine so eingerichtet sein, dass sie IP-Pakete
3301 für mehrere Adressen akzeptiert. (Wenn der Rechner nicht mehrere
3302 Netzwerkkarten besitzt, kann dies mit dem Befehl <code>ifconfig
3303 alias</code> durchgeführt werden -- sofern Ihr Betriebssystem das
3306 <div class="note"><h3>Anmerkung</h3>
3307 <p>Die Verwendung von <code class="directive"><VirtualHost></code>
3308 beeinflusst <strong>nicht</strong>, an welchen Adressen der Apache
3309 lauscht. Sie müssen mit <code class="directive"><a href="../mod/mpm_common.html#listen">Listen</a></code> sicherstellen, dass der Apache
3310 an der richtigen Adresse lauscht.</p>
3313 <p>Bei der Verwendung IP-basierter virtuellen Hosts kann der spezielle
3314 Name <code>_default_</code> benutzt werden. In diesem Fall weist
3315 der Apache jede IP-Adresse diesem virtuellen Host zu, die nicht explizit in
3316 einem anderen virtuellen Host angegeben ist. Falls kein virtueller Host
3317 <code>_default_</code> angegeben ist, wird die "Hauptserver"-Konfiguration,
3318 die aus allen Definitionen außerhalb der Virtual-Host-Abschnitte
3319 besteht, für nicht passende IPs verwendet. (Beachten Sie jedoch,
3320 dass eine IP-Adressen die zu einer <code class="directive"><a href="#namevirtualhost">NameVirtualHost</a></code>-Anweisung passt, weder den
3321 "Hauptserver" noch den virtuellen Host <code>_default_</code> verwendet.
3322 Lesen Sie für weitere Details die Dokumentation zu <a href="../vhosts/name-based.html">namensbasierten virtuell Hosts</a>.)</p>
3324 <p>Sie können einen speziellen <code>:Port</code> angeben,
3325 um den entsprechenden Port zu wechseln. Falls nicht angegeben, wird
3326 er auf den gleichen Port voreingestellt, wie die letzte
3327 <code class="directive"><a href="../mod/mpm_common.html#listen">Listen</a></code>-Anweisung des
3328 Hauptservers. Sie können auch <code>:*</code> angeben, um alle
3329 Ports dieser Adresse zu akzeptieren. (Dies wird zusammen mit
3330 <code>_default_</code> empfohlen.)</p>
3332 <div class="warning"><h3>Sicherheit</h3>
3333 <p>Lesen Sie das Dokument <a href="../misc/security_tips.html">Sicherheitshinweise</a> für
3334 Details, warum Ihre Sicherheit gefährdet sein kann, wenn das
3335 Verzeichnis, in dem Protokolldateien gespeichert werden, für
3336 jemanden anderes als den Benutzer beschreibbar ist, der den Server
3342 <li><a href="../vhosts/">Apache-Dokumentation zu virtuellen
3344 <li><a href="../dns-caveats.html">Probleme bezüglich DNS und
3346 <li><a href="../bind.html">Bestimmen, welche Adressen und Ports
3347 der Apache verwendet</a></li>
3348 <li><a href="../sections.html">Wie die Abschnitte <Directory>,
3349 <Location> und <Files> arbeiten</a> für eine
3350 Erläuterung, wie diese verschiedenen Abschnitte miteinander
3351 kombiniert werden, wenn eine Anfrage empfangen wird</li>
3355 <div class="bottomlang">
3356 <p><span>Verfügbare Sprachen: </span><a href="../de/mod/core.html" title="Deutsch"> de </a> |
3357 <a href="../en/mod/core.html" hreflang="en" rel="alternate" title="English"> en </a> |
3358 <a href="../fr/mod/core.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
3359 <a href="../ja/mod/core.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
3360 <a href="../tr/mod/core.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
3361 </div><div id="footer">
3362 <p class="apache">Copyright 2010 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>
3363 <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>