granicus.if.org Git - apache/blob - docs/manual/configuring.xml.de

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