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: 420990:1662012 (outdated) -->
   5
   6 <!--
   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
  13
  14      http://www.apache.org/licenses/LICENSE-2.0
  15
  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.
  21 -->
  22
  23 <manualpage metafile="configuring.xml.meta">
  24
  25   <title>Konfigurationsdateien</title>
  26
  27   <summary>
  28     <p>Dieses Dokument beschreibt die Dateien, die zur Konfiguration des Apache
  29       HTTP Servers verwendet werden.</p>
  30   </summary>
  31
  32   <section id="main">
  33     <title>Hauptkonfigurationsdateien</title>
  34     <related>
  35       <modulelist>
  36         <module>mod_mime</module>
  37       </modulelist>
  38       <directivelist>
  39         <directive module="core" type="section">IfDefine</directive>
  40         <directive module="core">Include</directive>
  41         <directive module="mod_mime">TypesConfig</directive>
  42       </directivelist>
  43     </related>
  44
  45     <p>Der Apache wird konfiguriert, indem <a
  46         href="mod/directives.html">Direktiven</a> in einfache Textdateien
  47       eingetragen werden. Die Hauptkonfigurationsdatei hei&szlig;t
  48       &uuml;blicherweise <code>httpd.conf</code>. Der Ablageort dieser Datei
  49       wird bei der Kompilierung festgelegt, kann jedoch mit der
  50       Befehlszeilenoption <code>-f</code> &uuml;berschrieben werden. Durch
  51       Verwendung der Direktive  <directive module="core">Include</directive>
  52       k&ouml;nnen au&szlig;erdem weitere Konfigurationsdateien hinzugef&uuml;gt
  53       werden. Zum Einf&uuml;gen von mehreren Konfigurationsdateien k&ouml;nnen
  54       Platzhalter verwendet werden. Jede Direktive darf in jeder dieser
  55       Konfigurationsdateien angegeben werden. &Auml;nderungen in den
  56       Hauptkonfigurationsdateien werden vom Apache nur beim Start oder Neustart
  57       erkannt.</p>
  58
  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>
  63   </section>
  64
  65   <section id="syntax">
  66     <title>Syntax der Konfigurationsdateien</title>
  67
  68     <p>Die Konfigurationsdateien des Apache enthalten eine Direktive pro Zeile.
  69       Der Backslash "\" l&auml;&szlig;t sich als letztes Zeichen in einer Zeile
  70       dazu verwenden, die Fortsetzung der Direktive in der n&auml;chsten Zeile
  71       anzuzeigen. Es darf kein weiteres Zeichen oder Whitespace zwischen dem
  72       Backslash und dem Zeilenende folgen.</p>
  73
  74     <p>In den Konfigurationsdateien wird bei den Direktiven nicht zwischen
  75       Gro&szlig;- und Kleinschreibung unterschieden. Bei den Argumenten der
  76       Direktiven wird dagegen oftmals zwischen Gro&szlig;- und Kleinschreibung
  77       differenziert. Zeilen, die mit dem Doppelkreuz "#" beginnen, werden als
  78       Kommentare betrachtet und ignoriert. Kommentare d&uuml;rfen
  79       <strong>nicht</strong> am Ende einer Zeile nach der Direktive
  80       eingef&uuml;gt werden. Leerzeilen und Whitespaces vor einer Direktive
  81       werden ignoriert. Dadurch lassen sich Direktiven zur besseren Lesbarbeit
  82       einr&uuml;cken.</p>
  83
  84     <p>Sie k&ouml;nnen die Syntax Ihrer Konfigurationsdateien auf Fehler
  85       pr&uuml;fen, ohne den Server zu starten, indem Sie <code>apachectl
  86         configtest</code> oder die Befehlszeilenoption <code>-t</code>
  87       verwenden.</p>
  88   </section>
  89
  90   <section id="modules">
  91     <title>Module</title>
  92
  93     <related>
  94       <modulelist>
  95         <module>mod_so</module>
  96       </modulelist>
  97       <directivelist>
  98         <directive module="core" type="section">IfModule</directive>
  99         <directive module="mod_so">LoadModule</directive>
 100       </directivelist>
 101     </related>
 102
 103     <p>Der Apache ist ein modularer Server. Das bedeutet, dass nur die abolute
 104       Grundfunktionalit&auml;t im Kernserver enthalten ist. Weitergehende
 105       F&auml;higkeiten sind mittels <a href="mod/">Modulen</a> verf&uuml;gbar,
 106       die in den Apache geladen werden k&ouml;nnen. Standardm&auml;&szlig;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&uuml;r die Verwendung von <a href="dso.html">dynamisch
 111         ladbaren</a> Modulen kompiliert wurde, dann k&ouml;nnen Module separat
 112       kompiliert und jederzeit mittels der Direktive <directive
 113         module="mod_so">LoadModule</directive> hinzugef&uuml;gt werden.
 114       Andernfalls muss der Apache neu kompiliert werden, um Module
 115       hinzuzuf&uuml;gen oder zu entfernen. Konfigurationsanweisungen k&ouml;nnen
 116       abh&auml;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>
 119
 120     <p>Um zu sehen, welche Module momentan in den Server einkompiliert sind,
 121       kann die Befehlszeilenoption <code>-l</code> verwendet werden.</p>
 122   </section>
 123
 124   <section id="scope">
 125     <title>Der G&uuml;ltigkeitsbereich von Direktiven</title>
 126
 127     <related>
 128       <directivelist>
 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>
 136       </directivelist>
 137     </related>
 138
 139     <p>Direktiven in den Hauptkonfigurationsdateien gelten f&uuml;r den
 140       gesamten Server. Wenn Sie die Konfiguration nur f&uuml;r einen Teil des
 141       Servers ver&auml;ndern m&ouml;chten, k&ouml;nnen Sie den
 142       G&uuml;ltigkeitsbereich der Direktiven beschr&auml;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&uuml;gen.
 150       Diese Abschnitte begrenzen die Anwendung der umschlossenen Direktiven
 151       auf bestimmte Pfade des Dateisystems oder auf
 152       bestimmte URLs. Sie k&ouml;nnen f&uuml;r eine fein abgestimmte
 153       Konfiguration auch ineinander verschachtelt werden.</p>
 154
 155     <!-- <glossary ref="website">Websites</glossary> -->
 156     <p>Der Apache besitzt die F&auml;higkeit, mehrere verschiedene Websites
 157       gleichzeitig zu bedienen. Dies wird <a href="vhosts/">virtuelles
 158         Hosten</a> genannt. Direktiven k&ouml;nnen auch in ihrem
 159       G&uuml;ltigkeitsgereich eingeschr&auml;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&uuml;r eine bestimmte Website
 163       angewendet.</p>
 164
 165     <p>Obwohl die meisten Direktiven in jedem dieser Abschnitte platziert
 166       werden k&ouml;nnen, ergeben einige Direktiven in manchen Kontexten
 167       keinen Sinn. Direktiven zur Prozesssteuerung beispielsweise
 168       d&uuml;rfen nur im Kontext des Hauptservers angegeben werden. Pr&uuml;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&uuml;gt werden k&ouml;nnen.  Weitere Informationen finden Sie unter
 172       "<a href="sections.html">Wie Directory-, Location- und Files-Abschnitte
 173         arbeiten</a>".</p>
 174     <!-- seealso draus machen? zumindest aber korrigieren -->
 175   </section>
 176
 177   <section id="htaccess">
 178     <title>.htaccess-Dateien</title>
 179
 180     <related>
 181       <directivelist>
 182         <directive module="core">AccessFileName</directive>
 183         <directive module="core">AllowOverride</directive>
 184       </directivelist>
 185     </related>
 186
 187     <p>Der Apache erm&ouml;glicht die dezentrale Verwaltung der
 188       Konfiguration mittes spezieller Dateien innerhalb des
 189       Web-Verzeichnisbaums. Diese speziellen Dateien hei&szlig;en
 190       gew&ouml;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 &Auml;nderungen in diesen Dateien sofort wirksam.</p>
 198
 199     <p>Pr&uuml;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&ouml;nnen. Dar&uuml;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&uuml;rfen.</p>
 207
 208     <p>Weitere Informationen &uuml;ber <code>.htaccess</code>-Dateien finden
 209       Sie in der <a
 210         href="howto/htaccess.html">.htaccess-Einf&uuml;hrung</a>.</p>
 211   </section>
 212 </manualpage>