core.xml.de

Apache HTTP Server 是一个功能强大的灵活的与HTTP/1.1相兼容的web服务器.这里给出的是Apache HTTP服务器的源码。

<seealso><a href="../sections.html">Wie die Abschnitte &lt;Directory&gt;,
    &lt;Location&gt; und &lt;Files&gt; arbeiten</a> f&uuml;r eine
    Erl&auml;uterung, wie diese verschiedenen Abschnitte miteinander
    kombiniert werden, wenn eine Anfrage empfangen wird</seealso>
</directivesynopsis>

<directivesynopsis>
<name>ForceType</name>
<description>Erzwingt die Auslieferung aller passendenden Dateien mit dem
angegebenen MIME-Content-Type</description>
<syntax>ForceType <var>MIME-Type</var>|None</syntax>
<contextlist><context>directory</context><context>.htaccess</context>
</contextlist>
<override>FileInfo</override>
<compatibility>Wurde im Apache 2.0 in den Core verschoben</compatibility>

<usage>
    <p>Wenn sie innerhalb einer <code>.htaccess</code>-Datei, eines
    <directive type="section" module="core">Directory</directive>-,
    <directive type="section" module="core">Location</directive>-
    <directive type="section" module="core">Files</directive>-Containers
    angegeben wird, erzwingt die Direktive die Auslieferung aller
    entsprechenden Dateien mit dem Content-Type, der durch
    <var>MIME-Type</var> definiert wurde. Wenn Sie zum Beispiel ein
    Verzeichnis voller GIF-Dateien haben, die Sie nicht alle durch
    <code>.gif</code> kennzeichnen wollen, k&ouml;nnen Sie angeben:</p>

    <example>
      ForceType image/gif
    </example>

    <p>Beachten Sie bitte, dass die Direktive anders als <directive
    module="core">DefaultType</directive> alle MIME-Type-Zuordnungen
    &uuml;berschreibt, einschlie&szlig;lich Dateiendungen, die einen
    Medientyp bezeichnen k&ouml;nnten.</p>

    <p>Sie k&ouml;nnen jede <directive>ForceType</directive>-Angabe
    durch die Verwendung des Wertes <code>None</code> &uuml;berschreiben:</p>

    <example>
      # erzwinge image/gif f&uuml;r alle Dateien:<br />
      &lt;Location /images&gt;<br />
        <indent>
          ForceType image/gif<br />
        </indent>
      &lt;/Location&gt;<br />
      <br />
      # hier jedoch normale MIME-Type-Zuordnungen:<br />
      &lt;Location /images/mixed&gt;<br />
      <indent>
        ForceType None<br />
      </indent>
      &lt;/Location&gt;
    </example>
</usage>
</directivesynopsis>

<directivesynopsis>
<name>HostnameLookups</name>
<description>Aktiviert DNS-Lookups auf Client-IP-Adressen</description>
<syntax>HostnameLookups On|Off|Double</syntax>
<default>HostnameLookups Off</default>
<contextlist><context>server config</context><context>virtual host</context>
<context>directory</context></contextlist>

<usage>
    <p>Diese Direktive aktiviert die DNS-Abfrage <transnote>ein sogenannter
    DNS-Lookup</transnote>, so dass Hostnamen protokolliert (und in
    <code>REMOTE_HOST</code> an CGIs/SSIs &uuml;bergeben) werden k&ouml;nnnen.
    Der Wert <code>Double</code> bezieht sich auf ein
    Double-Reverse-DNS-Lookup. D.h. nachdem ein Reverse-Lookup
    durchgef&uuml;hrt wurde, wird dann auf dem Ergebnis ein
    Forward-Lookup ausgef&uuml;hrt. Wenigstens eine der IP-Adressen
    aus dem Forward-Lookup muss der Originaladresse entsprechen.
    (In der "tcpwrappers"-Terminologie wird dies <code>PARANOID</code>
    genannt.)</p>

    <p>Unabh&auml;ngig von der Einstellung wird ein Double-Reverse-Lookup
    durchgef&uuml;hrt, wenn <module>mod_access</module> zur Zugriffskontrolle
    per Hostnamen eingesetzt wird. Dies ist aus Sicherheitsgr&uuml;nden
    notwendig. Beachten Sie, dass das Ergebnis dieses
    Double-Reverse-Lookups nicht generell verf&uuml;gbar ist, solange Sie
    nicht <code>HostnameLookups Double</code> setzen. Wenn beispielsweise
    nur <code>HostnameLookups On</code> angegeben ist und eine Anfrage
    f&uuml;r ein Objekt erfolgt, welches durch Hostnamen-Beschr&auml;nkungen
    gesch&uuml;tzt ist, dann wird CGIs nur das Ergebnis des
    Singel-Reverse-Lookups in <code>REMOTE_HOST</code> &uuml;bergeben,
    egal ob das Doble-Reverse-Lookup fehlschlug oder nicht.</p>

    <p>Die Voreinstellung ist <code>Off</code>, um Netzwerktraffic bei den
    Angeboten einzusparen, die nicht tats&auml;chlich Reverse-Lookups
    ben&ouml;tigen. Es ist auch f&uuml;r die Endanwender besser, da sie nicht
    die zus&auml;tzliche Wartezeit ertragen m&uuml;ssen, die ein Lookup mit
    sich bringt. Hoch frequentierte Angebote sollten diese Direktive auf
    <code>Off</code>lassen. Das Hilfsprogramm <program>
    logresolve</program>, das standardm&auml;&szlig;ig in das
    Unterverzeichnis <code>bin</code> Ihres Installationsverzeichnisses
    kompiliert wird, kann dazu verwendet werden, um offline Hostnamen von
    protokollierten IP-Adressen nachzuschlagen.</p>
</usage>
</directivesynopsis>

<directivesynopsis>
<name>IdentityCheck</name>
<description>Erm&ouml;glicht die Protokollierung der Identit&auml;t des
entfernten Anwenders nach RFC1413</description>
<syntax>IdentityCheck On|Off</syntax>
<default>IdentityCheck Off</default>
<contextlist><context>server config</context><context>virtual host</context>
<context>directory</context></contextlist>
<usage>
    <p>Die Direktive erm&ouml;glicht die RFC1413-konforme Protokollierung des
    entfernten Benutzernamens f&uuml;r jede Verbindung, bei der auf der
    Client-Maschine identd oder etwas &auml;hnliches l&auml;uft. Die
    Information wird im Zugriffsprotokoll festgehalten.</p>

    <p>Der Information sollte au&szlig;er f&uuml;r eine rudiment&auml;re
    Benutzerverfolgung in keinster Weise vertraut werden.</p>

    <p>Beachten Sie bitte, dass dies betr&auml;chtliche Zeitprobleme
    beim Zugriff auf Ihren Server verursachen kann, da f&uuml;r jede Anfrage
    eine solche R&uuml;ckfrage durchgef&uuml;hrt werden muss. Wenn
    Firewalls beteiligt sind, kann unter Umst&auml;nden jede R&uuml;ckfrage
    fehlschlagen und weitere 30 Sekunden Wartezeit zu jedem Hit
    zuf&uuml;gen. Daher ist dies im Allgemeinen bei &ouml;ffentlichen
    Servern, die im Internet erreichbar sind, nicht besonders sinnvoll.</p>
</usage>
</directivesynopsis>

<directivesynopsis type="section">
<name>IfDefine</name>
<description>Schlie&szlig;t Direktiven ein, die nur ausgef&uuml;hrt werden,
wenn eine Testbedingung beim Start wahr ist</description>
<syntax>&lt;IfDefine [!]<var>Parametername</var>&gt; ...
    &lt;/IfDefine&gt;</syntax>
<contextlist><context>server config</context><context>virtual host</context>
<context>directory</context><context>.htaccess</context>
</contextlist>
<override>All</override>

<usage>
    <p>Der Container <code>&lt;IfDefine <var>Test</var>&gt;...&lt;/IfDefine&gt;
    </code> wird dazu verwendet, Direktiven als bedingt zu kennzeichnen.
    Die Direktiven innerhalb eines <directive
    type="section">IfDefine</directive>-Abschnittes werden nur ausgef&uuml;hrt,
    wenn <var>Test</var> wahr ist. Ist <var>Test</var> falsch, wird alles
    zwischen der Start- und Endemarkierung ignoriert.</p>

    <p>In der <directive type="section">IfDefine</directive>-Anweisung kann
    <var>Test</var> eine von zwei Formen annehmen:</p>

    <ul>
      <li><var>Parametername</var></li>

      <li><code>!</code><var>Parametername</var></li>
    </ul>

    <p>Im ersten Fall werden die Direktiven zwischen der Start- und
    Endemarkierung nur ausgef&uuml;hrt, wenn der Parameter namens
    <var>Parametername</var> definiert ist. Die zweite Form kehrt den
    Test um und f&uuml;hrt die Direktiven nur dann aus, wenn
    <var>Parametername</var> <strong>nicht</strong> definiert ist.</p>

    <p>Das Argument <var>Parametername</var> ist ein sogenanntes
    "Define", das beim beim Start des Servers in der
    <program>httpd</program>-Befehlszeile durch
    <code>-D<var>Parameter</var></code> angegeben wird.</p>

    <p><directive type="section">IfDefine</directive>-Container k&ouml;nnen
    ineinander verschachtelt werden, um einfache Multi-Parameter-Tests
    zu implementieren. Beispiel:</p>

    <example>
      httpd -DReverseProxy ...<br />
      <br />
      # httpd.conf<br />
      &lt;IfDefine ReverseProxy&gt;<br />
      <indent>
        LoadModule rewrite_module modules/mod_rewrite.so<br />
        LoadModule proxy_module   modules/libproxy.so<br />
      </indent>
      &lt;/IfDefine&gt;
    </example>
</usage>
</directivesynopsis>

<directivesynopsis type="section">
<name>IfModule</name>
<description>Schlie&szlig;t Direktiven ein, die abh&auml;ngig vom
Vorhandensein oder Fehlen eines speziellen Moduls ausgef&uuml;hrt
werden</description>
<syntax>&lt;IfModule [!]<var>Modulname</var>&gt; ...
    &lt;/IfModule&gt;</syntax>
<contextlist><context>server config</context><context>virtual host</context>
<context>directory</context><context>.htaccess</context>
</contextlist>
<override>All</override>

<usage>
    <p>Der Container <code>&lt;IfModule
    <var>Test</var>&gt;...&lt;/IfModule&gt;</code> wird dazu verwendet,
    Direktiven als abh&auml;ngig von dem Vorhandensein eines speziellen
    Moduls zu kennzeichnen. Die Direktiven innerhalb eines <directive
    type="section">IfModule</directive>-Abschnitts werden nur
    ausgef&uuml;hrt, wenn <var>Test</var> wahr ist. Ist <var>Test</var>
    falsch, wird alles zwischen der Start- und Endemarkierung ignoriert.</p>

    <p>In der <directive type="section">IfModule</directive>-Anweisung
    kann <var>Test</var> eine von zwei Formen annehmen:</p>

    <ul>
      <li><var>Modulname</var></li>

      <li><code>!</code><var>Modulname</var></li>
    </ul>

    <p>Im ersten Fall werden die Direktiven zwischen der Start- und
    Endemarkierung nur ausgef&uuml;hrt, das Modul namens
    <var>Modulname</var> im Apache enthalten ist -- entweder einkompiliert
    oder mittels <directive module="mod_so">LoadModule</directive>
    dynamisch geladen. Die zweite Form dreht den Test um und f&uuml;hrt die
    Direktiven nur aus, wenn <var>Modulname</var> <strong>nicht</strong>
    enthalten ist.</p>

    <p>Das Argument <var>Modulname</var> ist der Dateiname des Moduls zum
    Zeitpunkt seiner Kompilierung, z.B. <code>mod_rewrite.c</code>.
    Wenn ein Modul aus mehreren Quelltext-Dateien besteht, verwenden Sie den
    Namen der Datei, welche die Zeichenfolge
    <code>STANDARD20_MODULE_STUFF</code> enth&auml;lt.</p>

    <p><directive type="section">IfModule</directive>-Container k&ouml;nnen
    inneinander verschachtelt werden, um einfache Multi-Modul-Tests
    durchzuf&uuml;hren.</p>

    <p>Dieser Container sollte verwendet werden, wenn Sie eine
    Konfigurationsdatei ben&ouml;tigen, die unabh&auml;ngig davon funktioniert,
    ob ein bestimmtes Modul verf&uuml;gbar ist oder nicht. Normalerweise
    ist es nicht notwendig, Direktiven in <directive
    type="section">IfModule</directive>-Containern unterzubringen.</p>
</usage>
</directivesynopsis>

<directivesynopsis>
<name>Include</name>
<description>F&uuml;gt andere Konfigurationsdateien innerhalb der
Server-Konfigurationsdatei ein</description>
<syntax>Include <var>Dateiname</var>|<var>Verzeichnis</var></syntax>
<contextlist><context>server config</context><context>virtual host</context>
<context>directory</context>
</contextlist>
<compatibility>Die Platzhalter-Suche ist verf&uuml;gbar seit
2.0.41</compatibility>

<usage>
    <p>Die Direktive erlaubt das Einf&uuml;gen anderer Konfigurationsdateien
    in die Konfigurationsdatei des Servers.</p>

    <p>Shell-typische (<code>fnmatch()</code>) Platzhlaterzeichen k&ouml;nnen
    dazu verwendet werden, mehrere Dateien auf einmal in alphabetischer
    Reihenfolge einzuf&uuml;gen. Wenn <directive>Include</directive>
    dar&uuml;ber hinaus auf ein Verzeichnis anstatt auf eine Datei zeigt,
    liest der Apache alle Dateien in diesem Verzeichnis und allen
    Unterverzeichnissen ein. Das Einf&uuml;gen ganzer Verzeichnisse ist
    jedoch nicht empfehlenswert, da tempor&auml;re Dateien sehr leicht
    versehentlich in einem Verzeichnis zur&uuml;ckgelassen werden, was
    <program>httpd</program> scheitern lassen kann.</p>

  <p>Der angegebene Dateiname kann ein absoluter Pfad sein oder relativ zum
    <directive module="core">ServerRoot</directive>-Verzeichnis angegeben
    werden.</p>

    <p>Beispiele:</p>

    <example>
      Include /usr/local/apache2/conf/ssl.conf<br />
      Include /usr/local/apache2/conf/vhosts/*.conf
    </example>

    <p>Oder Sie geben Pfade relativ zu Ihrem <directive
    module="core">ServerRoot</directive>-Verzeichnis an:</p>

    <example>
      Include conf/ssl.conf<br />
      Include conf/vhosts/*.conf
    </example>

    <p>Der Aufruf von <code>apachectl configtest</code> liefert eine Liste
    der Dateien, die w&auml;hrend des Konfigurations-Tests verarbeitet
    werden:</p>

    <example>
      root@host# apachectl configtest<br />
      Processing config file: /usr/local/apache2/conf/ssl.conf<br />
      Processing config file: /usr/local/apache2/conf/vhosts/vhost1.conf<br />
      Processing config file: /usr/local/apache2/conf/vhosts/vhost2.conf<br />
      Syntax OK
    </example>
</usage>

<seealso><program>apachectl</program></seealso>
</directivesynopsis>

<directivesynopsis>
<name>KeepAlive</name>
<description>Akti