1 <?xml version='1.0' encoding='UTF-8' ?>
2 <!DOCTYPE manualpage SYSTEM "./style/manualpage.dtd">
3 <?xml-stylesheet type="text/xsl" href="./style/manual.de.xsl"?>
4 <!-- English Revision: 420990:1673947 (outdated) -->
7 Licensed to the Apache Software Foundation (ASF) under one or more
8 contributor license agreements. See the NOTICE file distributed with
9 this work for additional information regarding copyright ownership.
10 The ASF licenses this file to You under the Apache License, Version 2.0
11 (the "License"); you may not use this file except in compliance with
12 the License. You may obtain a copy of the License at
14 http://www.apache.org/licenses/LICENSE-2.0
16 Unless required by applicable law or agreed to in writing, software
17 distributed under the License is distributed on an "AS IS" BASIS,
18 WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
19 See the License for the specific language governing permissions and
20 limitations under the License.
23 <manualpage metafile="configuring.xml.meta">
25 <title>Konfigurationsdateien</title>
28 <p>Dieses Dokument beschreibt die Dateien, die zur Konfiguration des Apache
29 HTTP Servers verwendet werden.</p>
33 <title>Hauptkonfigurationsdateien</title>
36 <module>mod_mime</module>
39 <directive module="core" type="section">IfDefine</directive>
40 <directive module="core">Include</directive>
41 <directive module="mod_mime">TypesConfig</directive>
45 <p>Der Apache wird konfiguriert, indem <a
46 href="mod/directives.html">Direktiven</a> in einfache Textdateien
47 eingetragen werden. Die Hauptkonfigurationsdatei heißt
48 üblicherweise <code>httpd.conf</code>. Der Ablageort dieser Datei
49 wird bei der Kompilierung festgelegt, kann jedoch mit der
50 Befehlszeilenoption <code>-f</code> überschrieben werden. Durch
51 Verwendung der Direktive <directive module="core">Include</directive>
52 können außerdem weitere Konfigurationsdateien hinzugefügt
53 werden. Zum Einfügen von mehreren Konfigurationsdateien können
54 Platzhalter verwendet werden. Jede Direktive darf in jeder dieser
55 Konfigurationsdateien angegeben werden. Änderungen in den
56 Hauptkonfigurationsdateien werden vom Apache nur beim Start oder Neustart
59 <p>Der Server liest auch eine Datei mit MIME-Dokumenttypen ein. Der
60 Name dieser Datei wird durch die Direktive <directive
61 module="mod_mime">TypesConfig</directive> bestimmt. Die Voreinstellung
62 ist <code>mime.types</code>.</p>
66 <title>Syntax der Konfigurationsdateien</title>
68 <p>Die Konfigurationsdateien des Apache enthalten eine Direktive pro Zeile.
69 Der Backslash "\" läßt sich als letztes Zeichen in einer Zeile
70 dazu verwenden, die Fortsetzung der Direktive in der nächsten Zeile
71 anzuzeigen. Es darf kein weiteres Zeichen oder Whitespace zwischen dem
72 Backslash und dem Zeilenende folgen.</p>
74 <p>In den Konfigurationsdateien wird bei den Direktiven nicht zwischen
75 Groß- und Kleinschreibung unterschieden. Bei den Argumenten der
76 Direktiven wird dagegen oftmals zwischen Groß- und Kleinschreibung
77 differenziert. Zeilen, die mit dem Doppelkreuz "#" beginnen, werden als
78 Kommentare betrachtet und ignoriert. Kommentare dürfen
79 <strong>nicht</strong> am Ende einer Zeile nach der Direktive
80 eingefügt werden. Leerzeilen und Whitespaces vor einer Direktive
81 werden ignoriert. Dadurch lassen sich Direktiven zur besseren Lesbarbeit
84 <p>Sie können die Syntax Ihrer Konfigurationsdateien auf Fehler
85 prüfen, ohne den Server zu starten, indem Sie <code>apachectl
86 configtest</code> oder die Befehlszeilenoption <code>-t</code>
90 <section id="modules">
95 <module>mod_so</module>
98 <directive module="core" type="section">IfModule</directive>
99 <directive module="mod_so">LoadModule</directive>
103 <p>Der Apache ist ein modularer Server. Das bedeutet, dass nur die abolute
104 Grundfunktionalität im Kernserver enthalten ist. Weitergehende
105 Fähigkeiten sind mittels <a href="mod/">Modulen</a> verfügbar,
106 die in den Apache geladen werden können. Standardmäßig
107 wird bei der Kompilierung ein Satz von Basismodulen <transnote>die so
108 genannten <a href="mod/module-dict.html#Status"
109 >Base</a>-Module</transnote> in den Server eingebunden. Wenn der
110 Server für die Verwendung von <a href="dso.html">dynamisch
111 ladbaren</a> Modulen kompiliert wurde, dann können Module separat
112 kompiliert und jederzeit mittels der Direktive <directive
113 module="mod_so">LoadModule</directive> hinzugefügt werden.
114 Andernfalls muss der Apache neu kompiliert werden, um Module
115 hinzuzufügen oder zu entfernen. Konfigurationsanweisungen können
116 abhängig vom Vorhandensein eines bestimmten Moduls eingesetzt werden,
117 indem sie in einen <directive module="core" type="section"
118 >IfModule</directive>-Block eingeschlossen werden.</p>
120 <p>Um zu sehen, welche Module momentan in den Server einkompiliert sind,
121 kann die Befehlszeilenoption <code>-l</code> verwendet werden.</p>
125 <title>Der Gültigkeitsbereich von Direktiven</title>
129 <directive module="core" type="section">Directory</directive>
130 <directive module="core" type="section">DirectoryMatch</directive>
131 <directive module="core" type="section">Files</directive>
132 <directive module="core" type="section">FilesMatch</directive>
133 <directive module="core" type="section">Location</directive>
134 <directive module="core" type="section">LocationMatch</directive>
135 <directive module="core" type="section">VirtualHost</directive>
139 <p>Direktiven in den Hauptkonfigurationsdateien gelten für den
140 gesamten Server. Wenn Sie die Konfiguration nur für einen Teil des
141 Servers verändern möchten, können Sie den
142 Gültigkeitsbereich der Direktiven beschränken, indem Sie diese
143 in <directive module="core" type="section">Directory</directive>-,
144 <directive module="core" type="section">DirectoryMatch</directive>-,
145 <directive module="core" type="section">Files</directive>-,
146 <directive module="core" type="section">FilesMatch</directive>-,
147 <directive module="core" type="section">Location</directive>- oder
148 <directive module="core"
149 type="section">LocationMatch</directive>-Abschnitte eingefügen.
150 Diese Abschnitte begrenzen die Anwendung der umschlossenen Direktiven
151 auf bestimmte Pfade des Dateisystems oder auf
152 bestimmte URLs. Sie können für eine fein abgestimmte
153 Konfiguration auch ineinander verschachtelt werden.</p>
155 <!-- <glossary ref="website">Websites</glossary> -->
156 <p>Der Apache besitzt die Fähigkeit, mehrere verschiedene Websites
157 gleichzeitig zu bedienen. Dies wird <a href="vhosts/">virtuelles
158 Hosten</a> genannt. Direktiven können auch in ihrem
159 Gültigkeitsgereich eingeschränkt werden, indem sie innerhalb
160 eines <directive module="core"
161 type="section">VirtualHost</directive>-Abschnittes angegeben werden.
162 Sie werden dann nur auf Anfragen für eine bestimmte Website
165 <p>Obwohl die meisten Direktiven in jedem dieser Abschnitte platziert
166 werden können, ergeben einige Direktiven in manchen Kontexten
167 keinen Sinn. Direktiven zur Prozesssteuerung beispielsweise
168 dürfen nur im Kontext des Hauptservers angegeben werden. Prüfen
169 Sie den <a href="mod/directive-dict.html#Context">Kontext</a> der
170 Direktive, um herauszufinden, welche Direktiven in welche Abschnitte
171 eingefügt werden können. Weitere Informationen finden Sie unter
172 "<a href="sections.html">Wie Directory-, Location- und Files-Abschnitte
174 <!-- seealso draus machen? zumindest aber korrigieren -->
177 <section id="htaccess">
178 <title>.htaccess-Dateien</title>
182 <directive module="core">AccessFileName</directive>
183 <directive module="core">AllowOverride</directive>
187 <p>Der Apache ermöglicht die dezentrale Verwaltung der
188 Konfiguration mittes spezieller Dateien innerhalb des
189 Web-Verzeichnisbaums. Diese speziellen Dateien heißen
190 gewöhnlich <code>.htaccess</code>, mit der Direktive <directive
191 module="core">AccessFileName</directive> kann jedoch auch ein anderer
192 Name festgelegt werden. In <code>.htaccess</code>-Dateien angegebene
193 Direktiven werden auf das Verzeichnis und dessen Unterverzeichnisse
194 angewendet, in dem die Datei abgelegt ist. <code>.htaccess</code>-Dateien
195 folgen der gleichen Syntax wie die Hauptkonfigurationsdateien. Da
196 <code>.htaccess</code>-Dateien bei jeder Anfrage eingelesen werden,
197 werden Änderungen in diesen Dateien sofort wirksam.</p>
199 <p>Prüfen Sie den <a
200 href="mod/directive-dict.html#Context">Kontext</a> der Direktive, um
201 herauszufinden, welche Direktiven in <code>.htaccess</code>-Dateien
202 angegeben werden können. Darüber hinaus steuert der
203 Serveradministrator mit der Einstellung der Direktive <directive
204 module="core">AllowOverride</directive> in den
205 Hauptkonfigurationsdateien welche Direktiven in
206 <code>.htaccess</code>-Dateien verwendet werden dürfen.</p>
208 <p>Weitere Informationen über <code>.htaccess</code>-Dateien finden
210 href="howto/htaccess.html">.htaccess-Einführung</a>.</p>