core.xml.de

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

[<var>Direktiven-Typ</var>] ...</syntax>
<default>AllowOverride All</default>
<contextlist><context>directory</context></contextlist>

<usage>
    <p>Wenn der Server eine <code>.htaccess</code>-Datei (wie durch
    <directive module="core">AccessFileName</directive> definiert)
    findet, muss er wissen, welche in der Datei angegebenen Direktiven
    fr&uuml;here Konfigurationsanweisungen &uuml;berschreiben
    d&uuml;rfen.</p>

    <note><title>Nun in &lt;Directory&gt;-Abschnitten verf&uuml;gbar</title>
    <directive>AllowOverride</directive> ist nur in <directive
    type="section" module="core">Directory</directive>-Abschnitten
    g&uuml;ltig, die ohne regul&auml;re Ausdr&uuml;ke definiert wurden, nicht
    in <directive type="section" module="core">Location</directive>-, 
    <directive module="core" type="section">DirectoryMatch</directive>- oder
    <directive type="section" module="core">Files</directive>-Abschnitten.
    </note>

    <p>Wenn diese Anweisung auf <code>None</code> gesetzt wird, dann
    werden <a href="#accessfilename">.htaccess</a>-Dateien komplett
    ignoriert. In diesem Fall wird der Server nicht einmal versuchen,
    die <code>.htaccess</code>-Dateien im Dateisystem zu lesen.</p>

    <p>Wenn diese Anweisung auf <code>All</code> gesetzt wird, dann
    ist jede Direktive in den <code>.htaccess</code>-Dateien erlaubt,
    die den <a href="directive-dict.html#Context">Kontext</a>
    .htaccess besitzt.</p>

    <p>Der <var>Direktiven-Typ</var> kann eine der folgenden
    Anweisungsgruppen sein.</p>

    <dl>
      <dt>AuthConfig</dt>

      <dd>
      Erlaubt die Verwendung von Autorisierungs-Anweisungen (<directive
      module="mod_auth_dbm">AuthDBMGroupFile</directive>,
      <directive module="mod_auth_dbm">AuthDBMUserFile</directive>,
      <directive module="mod_auth">AuthGroupFile</directive>,
      <directive module="core">AuthName</directive>,
      <directive module="core">AuthType</directive>, <directive
      module="mod_auth">AuthUserFile</directive>, <directive
      module="core">Require</directive> <em>usw.</em>).</dd>

      <dt>FileInfo</dt>

      <dd>
      Erlaubt die Verwendung von Direktiven zur Steuerung der
      Dokumenttypen (<directive
      module="core">DefaultType</directive>, <directive
      module="core">ErrorDocument</directive>, <directive
      module="core">ForceType</directive>, <directive
      module="mod_negotiation">LanguagePriority</directive>,
      <directive module="core">SetHandler</directive>, <directive
      module="core">SetInputFilter</directive>, <directive
      module="core">SetOutputFilter</directive>, und
      <module>mod_mime</module>-Direktiven Add* und Remove*
      <em>usw.</em>).</dd>

      <dt>Indexes</dt>

      <dd>
      Erlaubt die Verwendung von Direktiven zur Steuerung von
      Verzeichnisindizes (<directive
      module="mod_autoindex">AddDescription</directive>,
      <directive module="mod_autoindex">AddIcon</directive>, <directive
      module="mod_autoindex">AddIconByEncoding</directive>,
      <directive module="mod_autoindex">AddIconByType</directive>,
      <directive module="mod_autoindex">DefaultIcon</directive>, <directive
      module="mod_dir">DirectoryIndex</directive>, <directive
      module="mod_autoindex">FancyIndexing</directive>, <directive
      module="mod_autoindex">HeaderName</directive>, <directive
      module="mod_autoindex">IndexIgnore</directive>, <directive
      module="mod_autoindex">IndexOptions</directive>, <directive
      module="mod_autoindex">ReadmeName</directive>
      <em>usw.</em>).</dd>

      <dt>Limit</dt>

      <dd>
      Erlaubt die Verwendung von Direktiven zur Steuerung des
      Zugriffs von Hosts (<directive
      module="mod_access">Allow</directive>, <directive
      module="mod_access">Deny</directive> und <directive
      module="mod_access">Order</directive>).</dd>

      <dt>Options</dt>

      <dd>
      Erlaubt die Verwendung von Direktiven zur Steuerung spezieller
      Verzeichniseigenschaften (<directive module="core">Options</directive>
      und <directive module="mod_include">XBitHack</directive>).</dd>
    </dl>

    <p>Beispiel:</p>

    <example>
      AllowOverride AuthConfig Indexes
    </example>

    <p>Im obigen Beispiel erzeugen alle Direktiven einen internal server
      error <transnote>(Server-interner Fehler)</transnote>, die weder der
      Gruppe <code>AuthConfig</code> noch der Gruppe <code>Indexes</code>
      angeh&ouml;ren.</p>
</usage>

<seealso><directive module="core">AccessFileName</directive></seealso>
<seealso><a href="../configuring.html">Konfigurationsdateien</a></seealso>
<seealso><a href="../howto/htaccess.html">.htaccess-Dateien</a></seealso>
</directivesynopsis>

<directivesynopsis>
<name>AuthName</name>
<description>Autorisierungsbereich zur Verwendung in der
HTTP-Authentisierung</description>
<syntax>AuthName <var>auth-Bereich</var></syntax>
<contextlist><context>directory</context><context>.htaccess</context>
</contextlist>
<override>AuthConfig</override>

<usage>
    <p>Die Direktive legt den Namen des Autorisierungsbereiches
    <transnote>Der Autorisierungsbereich wird auch Realm genannt.</transnote>
    f&uuml;r ein Verzeichnis fest. Dieser Realm wird dem Client mitgeteilt,
    damit der Anwender wei&szlig;, welchen Benutzernamen und welches Passwort
    er zu &uuml;bermitteln hat. <directive>AuthName</directive> akzeptiert ein
    Argument. Falls der Name des Realm Leerzeichen enth&auml;lt, muss er in
    Anf&uuml;hrungszeichen eingeschlossen werden. Um zu funktionieren, muss
    die Anweisung von den Direktiven <directive
    module="core">AuthType</directive> und <directive
    module="core">Require</directive> sowie von
    Direktiven wie <directive module="mod_auth">AuthUserFile</directive>
    und <directive module="mod_auth">AuthGroupFile</directive>
    begleitet werden.</p>

   <p>Beispiel:</p>

   <example>
     AuthName "Top Secret"
   </example>

    <p>Die <code>AuthName</code> &uuml;bergebene Zeichenkette ist das,
    was in dem von den meisten Browsern angebotenen Passwort-Dialog
    angezeigt wird.</p>
</usage>
<seealso><a
    href="../howto/auth.html">Authentisierung, Autorisierung und
    Zugriffskontrolle</a></seealso>
</directivesynopsis>

<directivesynopsis>
<name>AuthType</name>
<description>Art der Authentisierung</description>
<syntax>AuthType Basic|Digest</syntax>
<contextlist><context>directory</context><context>.htaccess</context>
</contextlist>
<override>AuthConfig</override>

<usage>
    <p>Die Direktive w&auml;hlt die Art der Benutzer-Authentisierung
    f&uuml;r ein Verzeichnis aus. Derzeit sind lediglich <code>Basic</code>
    und <code>Digest</code> implementiert.
    Um zu funktionieren, muss die Anweisung von den Direktiven <directive
    module="core">AuthName</directive> und <directive
    module="core">Require</directive> sowie von
    Direktiven wie <directive module="mod_auth">AuthUserFile</directive>
    und <directive module="mod_auth">AuthGroupFile</directive>
    begleitet werden.</p>
</usage>
<seealso><a href="../howto/auth.html">Authentisierung, Autorisierung und
    Zugriffskontrolle</a></seealso>
</directivesynopsis>

<directivesynopsis>
<name>CGIMapExtension</name>
<description>Technik zur Bestimmung des Interpreters f&uuml;r
CGI-Skripte</description>
<syntax>CGIMapExtension <var>CGI-Pfad</var> <var>.Endung</var></syntax>
<contextlist><context>directory</context><context>.htaccess</context>
</contextlist>
<override>FileInfo</override>
<compatibility>ausschlie&szlig;lich NetWare</compatibility>

<usage>
    <p>Die Direktive wird zur Steuerung verwendet, wie Apache
    den Interpreter ermittelt, der zur Ausf&uuml;hrung von
    CGI-Skripten verwendet wird. Beispielsweise bestimmt die Angabe
    von <code>CGIMapExtension sys:\foo.nlm .foo</code>, dass
    alle CGI-Scripte mit der Endung <code>.foo</code> an den
    FOO-Interpreter &uuml;bergeben werden.</p>
</usage>
</directivesynopsis>

<directivesynopsis>
<name>ContentDigest</name>
<description>Aktiviert die Generierung von <code>Content-MD5</code>
HTTP-Response-Headern</description>
<syntax>ContentDigest On|Off</syntax>
<default>ContentDigest Off</default>
<contextlist><context>server config</context><context>virtual host</context>
<context>directory</context><context>.htaccess</context>
</contextlist>
<override>Options</override>
<status>Experimental</status>

<usage>
    <p>Die Direktive aktiviert die Generierung von
    <code>Content-MD5</code>-Headern, wie sie in RFC1864 bzw. RFC2068
    definiert sind.</p>

    <p>MD5 ist ein Algorithmus zur Berechnung eines "Datenextrakts"
    (zuweilen "Fingerabdruck" genannt) <transnote>Der "Datenextrakt" wird im
    Englischen als "message digest" oder "fingerprint" bezeichnet.</transnote>
    aus beliebig langen Daten. Es gilt als zuverl&auml;ssig, dass
    Ver&auml;nderungen an den Daten sich in Ver&auml;nderungen des
    Extrakts wiederspiegeln.</p>

    <p>Der <code>Content-MD5</code>-Header bietet eine
    End-to-End-Integrit&auml;tspr&uuml;fung (MIC) <transnote>MIC steht f&uuml;r
    "message integrity check".</transnote> des Daten-Inhalts. Ein Proxy oder
    Client kann diesen Header pr&uuml;fen, um zuf&auml;llige Ver&auml;nderungen
    des Entity-Inhalts bei der &Uuml;bertragung festzustellen.
    Beispielheader:</p>

    <example>
      Content-MD5: AuLb7Dp1rqtRtxz2m9kRpA==
    </example>

    <p>Beachten Sie bitte, dass dies Performanceprobleme auf Ihrem
    System verursachen kann, da der Extrakt bei jeder Anfrage
    berechnet wird (der Wert wird nicht zwischengespeichert).</p>

    <p><code>Content-MD5</code> wird nur f&uuml;r Dokumente gesendet,
    die von <module>core</module> bedient werden, nicht jedoch bei
    Modulen. SSI-Dokumente, CGI-Skript-Ausgaben und Byte-Range-Antworten
    besitzen diesen Header beispielsweise nicht.</p>
</usage>
</directivesynopsis>

<directivesynopsis>
<name>DefaultType</name>
<description>MIME-Content-Type, der gesendet wird, wenn der Server den Typ
nicht auf andere Weise ermitteln kann.</description>
<syntax>DefaultType <var>MIME-Type</var></syntax>
<default>DefaultType text/plain</default>
<contextlist><context>server config</context><context>virtual host</context>
<context>directory</context><context>.htaccess</context>
</contextlist>
<override>FileInfo</override>

<usage>
    <p>Es kann vorkommen, dass der Server ein Dokument ausliefern muss,
    dessen Typ er nicht mit Hilfe seiner MIME-Type-Zuordnungen bestimmen
    kann.</p>

    <p>Der Server muss den Client &uuml;ber den Content-Type des
    Dokumentes informieren. Daher verwendet er im Falle eines
    unbekannten Typs die <code>DefaultType</code>-Einstellung.
    Zum Beispiel:</p>

    <example>
      DefaultType image/gif
    </example>

    <p>w&auml;re angemessen f&uuml;r ein Verzeichnis, das viele GIF-Bilder
    enth&auml;lt, deren Dateinamen nicht Endung <code>.gif</code>
    besitzen.</p>

    <p>Beachten Sie bitte, dass die Direktive anders als <directive
    module="core">ForceType</directive> lediglich den Standard-MIME-Type
    bestimmt. Alle anderen MIME-Type-Definitionen, einschlie&szlig;lich
    Dateierweiterungen, die den Medien-Typ anzeigen k&ouml;nnen,
    &uuml;berschreiben diese Voreinstellung.</p>
</usage>
</directivesynopsis>

<directivesynopsis type="section">
<name>Directory</name>
<description>Umschlie&szlig;t eine Gruppe von Direktiven, die nur auf
das genannte Verzeichnis des Dateisystems und Unterverzeichnisse angewendet
werden</description>
<syntax>&lt;Directory <var>Verzeichnispfad</var>&gt;
... &lt;/Directory&gt;</syntax>
<contextlist><context>server config</context><context>virtual host</context>
</contextlist>

<usage>
    <p><directive type="section">Directory</directive> und
    <code>&lt;/Directory&gt;</code> werden dazu verwendet, eine Gruppe
    von Direktiven zusammenzufassen, die nur f&uuml;r das genannte
    Verzeichnis und dessen Unterverzeichnisse gelten. Jede Direktive,
    die im Verzeichnis-Kontext erlaubt ist, kann verwendet werden.
    <var>Verzeichnispfad</var> ist entweder der vollst&auml;ndige Pfad zu
    einem Verzeichnis oder eine Zeichenkette mit Platzhaltern wie sie von der
    Unix-Shell zum Abgleich verwendet werden. In einer Zeichenkette
    mit Platzhaltern <transnote>sogenannte wild-cards</transnote> entspricht
    <code>?</code> einem einzelnen Zeichen und <code>*</code> einer
    Zeichenkette beliebiger L&auml;nge. Sie k&ouml;nnen auch auch
    <code>[]</code>-Zeichenbereiche verwenden. Keiner der Platzhalter
    entspricht dem Zeichen "/". Daher passt <code>&lt;Directory
    /*/public_html&gt;</code> nicht auf <code>/home/user/public_html</code>,
    <code>&lt;Directory /home/*/public_html&gt;</code> jedoch tut es.
    Beispiel:</p>