core.xml.de

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

<?xml version="1.0"?>
<!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">
<?xml-stylesheet type="text/xsl" href="../style/manual.de.xsl"?>
<!-- English Revision: 151420 -->

<!--
 Copyright 2003-2004 The Apache Software Foundation

 Licensed under the Apache License, Version 2.0 (the "License");
 you may not use this file except in compliance with the License.
 You may obtain a copy of the License at

     http://www.apache.org/licenses/LICENSE-2.0

 Unless required by applicable law or agreed to in writing, software
 distributed under the License is distributed on an "AS IS" BASIS,
 WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 See the License for the specific language governing permissions and
 limitations under the License.
-->

<modulesynopsis metafile="core.xml.meta">

<name>core</name>
<description>St&auml;ndig verf&uuml;gbare Kernfunktionen des Apache HTTP
Servers</description>
<status>Core</status>

<directivesynopsis>
<name>AcceptPathInfo</name>
<description>Ressourcen lassen angeh&auml;ngte Pfadangaben zu</description>
<syntax>AcceptPathInfo On|Off|Default</syntax>
<default>AcceptPathInfo Default</default>
<contextlist><context>server config</context>
<context>virtual host</context><context>directory</context>
<context>.htaccess</context></contextlist>
<override>FileInfo</override>
<compatibility>Verf&uuml;gbar ab Apache 2.0.30</compatibility>

<usage>
    <p>Die Direktive steuert, ob Anfragen akzeptiert oder
    abgewiesen werden, bei denen nach der tats&auml;chlichen
    Datei (oder einer nicht existierenden Datei in einem existierenden
    Verzeichnis) zus&auml;tzliche Pfadangaben folgen. Die angeh&auml;ngte
    Pfadangabe kann Skripten in der Umgebungsvariable <code>PATH_INFO</code>
    verf&uuml;gbar gemacht werden.</p>

    <p>Nehmen wir beispielsweise an, dass <code>/test/</code> auf ein
    Verzeichnis zeigt, welches lediglich eine Datei <code>here.html</code>
    enth&auml;lt. Dann wird bei Anfragen nach
    <code>/test/here.html/more</code> und
    <code>/test/nothere.html/more</code> beides Mal <code>/more</code>
    als <code>PATH_INFO</code> ermittelt.</p>

    <p>Die drei m&ouml;glichen Argumente f&uuml;r die Direktive
    <directive>AcceptPathInfo</directive> sind:</p>

    <dl>
    <dt><code>Off</code></dt><dd>Eine Anfrage wird nur dann akzeptiert,
    wenn sie exakt auf ein existierendes Verzeichnis (oder eine Datei)
    abgebildet werden kann. Daher w&uuml;rde eine Anfrage mit einer nach dem
    tats&auml;chlichen Dateinamen angeh&auml;ngten Pfadangabe, wie
    <code>/test/here.html/more</code> im obigen Beispiel, den Fehler
    404 NOT FOUND <transnote>nicht gefunden</transnote>
    zur&uuml;ckgeben.</dd>

    <dt><code>On</code></dt>
    <dd>Eine Anfrage wird akzeptiert, wenn eine vorangestellte Pfadangabe
    auf ein existierendes Verzeichnis abgebildet werden kann. Das
    obige Beispiel <code>/test/here.html/more</code> wird akzeptiert,
    wenn <code>/test/here.html</code> auf eine g&uuml;ltige Datei
    zeigt.</dd>

    <dt><code>Default</code></dt>
    <dd>Die Behandlung von Anfragen mit angeh&auml;ngten Pfadangaben
    wird von dem f&uuml;r die Anfrage verantwortlichen <a
    href="../handler.html">Handler</a> bestimmt. Der Core-Handler
    f&uuml;r gew&ouml;hnliche Dateien weist <code>PATH_INFO</code>-Zugriffe
    standardm&auml;&szlig;ig zur&uuml;ck. Handler, die Skripte bedienen,
    wie z.B. <a href="mod_cgi.html">cgi-script</a> und
    <a href="mod_isapi.html">isapi-isa</a>, sind im Allgemeinen darauf
    voreingestellt, <code>PATH_INFO</code> zu akzeptieren.</dd>
    </dl>

    <p>Das eigentliche Ziel von <code>AcceptPathInfo</code> ist es, Ihnen
    das &Uuml;berschreiben der Voreinstellung der Handler bez&uuml;glich
    der Akzeptanz oder Ablehnung von <code>PATH_INFO</code> zu erlauben.
    Eine solche &Auml;nderung ist zum Beispiel notwendig, wenn Sie einen
    <a href="../filter.html">Filter</a> wie <a
    href="mod_include.html">INCLUDES</a> verwenden, um Inhalte
    abh&auml;ngig von <code>PATH_INFO</code> zu generieren. Der
    Core-Handler w&uuml;rde die Anfrage normalerweise abweisen. Verwenden
    Sie die folgende Konfiguration, um dennoch solch ein Skript zu
    erm&ouml;glichen.</p>

    <example>
      &lt;Files "mypaths.shtml"&gt;<br />
      <indent>
        Options +Includes<br />
        SetOutputFilter INCLUDES<br />
        AcceptPathInfo On<br />
      </indent>
      &lt;/Files&gt;
    </example>

</usage>
</directivesynopsis>

<directivesynopsis>
<name>AccessFileName</name>
<description>Name der dezentralen Konfigurationsdateien</description>
<syntax>AccessFileName <var>Dateiname</var> [<var>Dateiname</var>] ...</syntax>
<default>AccessFileName .htaccess</default>
<contextlist><context>server config</context><context>virtual host</context>
</contextlist>

<usage>
    <p>Aus dieser Namensliste sucht der Server w&auml;hrend der
    Bearbeitung einer Anfrage in jedem Verzeichnis nach der ersten
    existierenden Datei, sofern im betreffenden Verzeichnis dezentrale
    Konfigurationsdateien <a href="#allowoverride">erlaubt sind</a>.
    Beispiel:</p>

    <example>
      AccessFileName .acl
    </example>

    <p>Vor der R&uuml;cksendung des Dokuments
    <code>/usr/local/web/index.html</code> wird der Server
    <code>/.acl</code>, <code>/usr/.acl</code>,
    <code>/usr/local/.acl</code> und <code>/usr/local/web/.acl</code>
    einlesen, solange diese nicht mit</p>

    <example>
      &lt;Directory /&gt;<br />
      <indent>
        AllowOverride None<br />
      </indent>
      &lt;/Directory&gt;
    </example>

    <p>deaktiviert wurden.</p>
</usage>
<seealso><directive module="core">AllowOverride</directive></seealso>
<seealso><a href="../configuring.html">Konfigurationsdateien</a></seealso>
<seealso><a href="../howto/htaccess.html">.htaccess-Dateien</a></seealso>
</directivesynopsis>

<directivesynopsis>
<name>AddDefaultCharset</name>
<description>Standard-Charset-Parameter, der bei Antworten vom Content-Type 
  <code>text/plain</code> oder <code>text/html</code> hinzugef&uuml;gt wird
</description>
<syntax>AddDefaultCharset On|Off|<var>Zeichenkodierung</var></syntax>
<default>AddDefaultCharset Off</default>
<contextlist><context>server config</context>
<context>virtual host</context><context>directory</context>
<context>.htaccess</context></contextlist>
<override>FileInfo</override>

<usage>
  <p>Die Direktive gibt einen Standardwert f&uuml;r den Charset-Paramter des
    Medientyps (den Namen einer Zeichencodierung) an, der einer Antwort
    genau dann hinzugef&uuml;gt wird, wenn der Content-Type der Antwort entweder
    <code>text/plain</code> oder <code>text/html</code> ist. Dies sollte jedes
    mittels <code>META</code>-Element im Datenteil der Antwort angegebene
    Charset &uuml;berschreiben. Das genaue Verhalten h&auml;ngt jedoch oft von
    der Client-Konfiguration des Benutzers ab. Die Einstellung
    <code>AddDefaultCharset Off</code> deaktiviert diese Funktionalit&auml;t.
    <code>AddDefaultCharset On</code> aktiviert die Standard-Zeichenkodierung
    <code>iso-8859-1</code>. Jeder andere Wert wird als die zu verwendende
    <var>Zeichenkodierung</var> aufgefa&szlig;t, die eines der bei <a
      href="http://www.iana.org/assignments/character-sets">IANA registrierten
      Charset-Werte</a> zur Verwendung in MIME-Medientypen sein sollte. Zum
    Beispiel:</p>

    <example>
      AddDefaultCharset utf-8
    </example>

    <p><directive>AddDefaultCharset</directive> sollte nur verwendet werden,
      wenn von allen Textressourcen, f&uuml;r die es gilt, bekannt ist, dass sie
      in dieser Zeichkodierung vorliegen, oder wenn es zu unbequem ist, ihre
      Zeichenkodierung indivuell zu benennen. Ein solches Beispiel ist das
      Hinzuf&uuml;gen des Charset-Parameters zu Ressourcen, die generierte
      Inhalte enthalten. Ein Beispiel sind CGI-Skript-Altlasten, die aufgrund von
      in die Ausgabe integrierten Daten, die durch den Benutzer &uuml;bermittelt
      wurden, gegen Cross-Site-Scripting-Angriffe verwundbar sind. Eine bessere
      L&ouml;sung w&auml;re jedoch, diese Skripte zu korrigieren (oder zu
      l&ouml;schen), da die Angabe einer Standard-Zeichencodierung keine
      Anwender sch&uuml;tzt, die in ihrem Browser die Funktion zur
      automatischen Erkennung der Zeichenkodierung aktiviert haben.</p>
</usage>
<seealso><directive module="mod_mime">AddCharset</directive></seealso> 
</directivesynopsis>

<directivesynopsis>
<name>AddOutputFilterByType</name>
<description>einen Ausgabefilter einem bestimmten MIME-Type
zuordnen</description>
<syntax>AddOutputFilterByType <var>Filter</var>[;<var>Filter</var>...]
<var>MIME-Type</var> [<var>MIME-Type</var>] ...</syntax>
<contextlist><context>server config</context>
<context>virtual host</context><context>directory</context>
<context>.htaccess</context></contextlist>
<override>FileInfo</override>
<compatibility>Verf&uuml;gbar ab Apache 2.0.33</compatibility>

<usage>
    <p>Die Direktive aktiviert f&uuml;r eine Anfrage abh&auml;ngig vom
    MIME-Type der Antwort einen bestimmten Ausgabe-<a href="../filter.html"
    >Filter</a>.</p>

    <p>Das folgende Beispiel verwendet den Filter <code>DEFLATE</code>,
    der von <module>mod_deflate</module> angeboten wird. Er komprimiert
    jede Ausgabe, die  als <code>text/html</code> oder <code>text/plain</code>
    gekennzeichnet ist, (gleichg&uuml;ltig, ob statisch oder dynamisch)
    bevor sie an den Client gesendet wird.</p>

    <example>
      AddOutputFilterByType DEFLATE text/html text/plain
    </example>

    <p>Wenn Sie den Inhalt von mehr als einem Filter verarbeiten lassen
    wollen, dann m&uuml;ssen deren Namen durch Semikolons voneinander
    getrennt werden. Es ist ebenfalls m&ouml;glich, eine
    <directive>AddOutputFilterByType</directive>-Direktive f&uuml;r
    jeden von diesen Filtern zu verwenden.</p>

    <p>Die folgende Konfiguration sorgt daf&uuml;r, dass alle
    Skriptausgaben, die als <code>text/html</code> gekennzeichnet
    sind, zuerst vom <code>INCLUDES</code>-Filter und dann vom
    <code>DEFLATE</code>-Filter verarbeitet werden.</p>

    <example>
    &lt;Location /cgi-bin/&gt;<br />
    <indent>
      Options Includes<br />
      AddOutputFilterByType INCLUDES;DEFLATE text/html<br />
    </indent>
    &lt;/Location&gt;
    </example>

    <note type="warning"><title>Hinweis:</title>
      <p>Die Aktivierung von Filtern mittels
      <directive>AddOutputFilterByType</directive> kann in einigen
      F&auml;llen ganz oder teilweise fehlschlagen. Beispielsweise
      werden keine Filter angewendet, wenn der MIME-Type nicht bestimmt
      werden kann und auf die Einstellung der <directive
      module="core">DefaultType</directive>-Anweisung zur&uuml;ckf&auml;llt,
      selbst wenn die <directive
      module="core">DefaultType</directive>-Einstellung die gleiche ist.</p>

      <p>Wenn Sie jedoch sicherstellen wollen, dass der Filter
      angewendet wird, sollten Sie den Content-Type z.B. mit
      <directive module="mod_mime">AddType</directive> oder
      <directive module="core">ForceType</directive> der Ressource
      explizit zuordnen. Das Setzen des Content-Types innerhalb
      eines (nicht-nph) CGI-Skriptes funktioniert ebenfalls
      zuverl&auml;ssig.</p>

      <p>Die Typ-gebundenen Ausgabefilter werden niemals auf
      Proxy-Anfragen angewendet.</p>
    </note>
</usage>

<seealso><directive module="mod_mime">AddOutputFilter</directive></seealso>
<seealso><directive module="core">SetOutputFilter</directive></seealso>
<seealso><a href="../filter.html">Filter</a></seealso>
</directivesynopsis>

<directivesynopsis>
<name>AllowEncodedSlashes</name>
<description>Legt fest, ob kodierte Pfadtrennzeichen in URLs durchgereicht
werden d&uuml;rfen</description>
<syntax>AllowEncodedSlashes On|Off</syntax>
<default>AllowEncodedSlashes Off</default>
<contextlist><context>server config</context><context>virtual host</context>
</contextlist>
<compatibility>Verf&uuml;gbar ab Apache 2.0.46</compatibility>

<usage>
    <p>Die <directive>AllowEncodedSlashes</directive>-Direktive erlaubt die
    Verwendung von URLs, welche kodierte Pfadtrennzeichen (<code>%2F</code>
    f&uuml;r <code>/</code> und auf entsprechenden Systemen zus&auml;tzlich
    <code>%5C</code> f&uuml;r <code>\</code>) enthalten. Normalerweise werden
    derartige URLs mit einem 404-Fehler (Nicht gefunden) abgewiesen.</p>

    <p><directive>AllowEncodedSlashes</directive> <code>On</code> ist
    vor allem in Verbindung mit <code>PATH_INFO</code> hilfreich.</p>

    <note><title>Anmerkung</title>
      <p>Das Erlauben von Schr&auml;gstrichen impliziert <em>nicht</em> deren 
      <em>Dekodierung</em>. Vorkommen von <code>%2F</code> oder <code>%5C</code>
      (<em>nur</em> auf entsprechenden Systemen) werden unver&auml;ndert in der
      ansonsten dekodierten URL belassen.</p>
    </note>
</usage>
<seealso><directive module="core">AcceptPathInfo</directive></seealso>
</directivesynopsis>

<directivesynopsis>
<name>AllowOverride</name>
<description>Direktiven-Typen, die in <code>.htaccess</code>-Dateien
erlaubt sind.</description>
<syntax>AllowOverride All|None|<var>Direktiven-Typ</var>