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