httpd.conf

httpd.conf - Konfigurationsdatei des Apache HTTP Servers

Beschreibung

Server liest Einstellungen aus der Textdatei httpd.conf

Ablageort

wird bei Kompilierung festgelegt
kann mit Befehlszeilenoption -f überschrieben werden

Struktur

Verwendung der Direktive Include

um weitere Konfigurationsdateien (wie ports.conf) einzulesen

.htaccess

Dezentrale Verwaltung der Konfiguration

spezieller Dateien innerhalb des Web-Verzeichnisbaums

Konfigurationsdateien

Hauptkonfigurationsdateien
Syntax der Konfigurationsdateien
Module
Geltungsbereich der Richtlinien
.htaccess-Dateien

Hauptkonfigurationsdateien

Verwandte Module	Verwandte Richtlinien
`mod_mime`	`<IfDefine>` `Include` `TypesConfig`

Der Apache-HTTP-Server wird konfiguriert, indem Direktiven in einfache Textkonfigurationsdateien eingetragen werden

Die Hauptkonfigurationsdatei heißt normalerweise httpd.conf
Der Speicherort dieser Datei wird bei der Kompilierung festgelegt, kann aber mit der Befehlszeilenoption -füberschrieben werden
Darüber hinaus können andere Konfigurationsdateien mit der Include-Direktivehinzugefügt werden, und es können Platzhalter verwendet werden, um viele Konfigurationsdateien einzuschließen
Jede Direktive kann in jede dieser Konfigurationsdateien eingefügt werden. Änderungen an den Hauptkonfigurationsdateien werden von httpd nur erkannt, wenn er gestartet oder neu gestartet wird

Der Server liest auch eine Datei mit Mime-Dokumenttypen; der Dateiname wird durch die TypesConfig-Direktive festgelegt und lautet standardmäßig mime.types

Syntax

httpd-Konfigurationsdateien enthalten eine Direktive pro Zeile

Der Backslash "\" kann als letztes Zeichen in einer Zeile verwendet werden, um anzuzeigen, dass die Direktive in der nächsten Zeile fortgesetzt wird
Zwischen dem Backslash und dem Ende der Zeile dürfen keine anderen Zeichen oder Leerzeichen stehen

Argumente für Direktiven werden durch Leerzeichen getrennt

Wenn ein Argument Leerzeichen enthält, müssen Sie es in Anführungszeichen setzen

Bei den Direktiven in den Konfigurationsdateien wird die Groß- und Kleinschreibung nicht beachtet, aber bei den Argumenten für Direktiven wird häufig die Groß- und Kleinschreibung beachtet

Zeilen, die mit dem Hash-Zeichen "#" beginnen, gelten als Kommentare und werden ignoriert
Kommentare dürfen nicht in der gleichen Zeile wie eine Konfigurationsanweisung enthalten sein. Leerzeichen, die vor einer Direktive stehen, werden ignoriert, so dass Sie Direktiven zur besseren Übersichtlichkeit einrücken können
Leerzeilen werden ebenfalls ignoriert

Die Werte von Variablen, die mit Define oder Shell-Umgebungsvariablen definiert wurden, können in Konfigurationsdateizeilen mit der Syntax ${VAR} verwendet werden

Wenn "VAR" der Name einer gültigen Variable ist, wird der Wert dieser Variable an dieser Stelle in der Konfigurationsdateizeile ersetzt, und die Verarbeitung wird fortgesetzt, als ob der Text direkt in der Konfigurationsdatei gefunden würde
Mit Define definierte Variablen haben Vorrang vor Shell-Umgebungsvariablen
Wird die "VAR"-Variable nicht gefunden, bleiben die Zeichen ${VAR}unverändert, und es wird eine Warnung protokolliert
Variablennamen dürfen keine Doppelpunkte ":" enthalten, um Konflikte mit der Syntax von RewriteMap zu vermeiden

Nur Shell-Umgebungsvariablen, die vor dem Start des Servers definiert wurden, können in Erweiterungen verwendet werden

Umgebungsvariablen, die in der Konfigurationsdatei selbst definiert werden, zum Beispiel mit SetEnv, werden zu spät wirksam, um für Erweiterungen in der Konfigurationsdatei verwendet zu werden

Die maximale Länge einer Zeile in normalen Konfigurationsdateien beträgt nach dem Ersetzen von Variablen und dem Verbinden von fortgesetzten Zeilen etwa 16 MiB

In .htaccess-Dateien beträgt die maximale Länge 8190 Zeichen

Sie können Ihre Konfigurationsdateien auf Syntaxfehler überprüfen, ohne den Server zu starten, indem Sie apachectl configtest oder die Befehlszeilenoption -t verwenden

Sie können mod_info's -DDUMP_CONFIG verwenden, um die Konfiguration mit allen enthaltenen Dateien und Umgebungsvariablen aufzulösen und alle Kommentare und nicht passenden <IfDefine> und <IfModule> Abschnitte zu entfernen

Die Ausgabe spiegelt jedoch nicht die Zusammenführung oder das Überschreiben wider, die bei wiederholten Direktiven auftreten können

Module

httpd ist ein modularer Server

Verwandte Module	Verwandte Richtlinien
`mod_so`	`<IfModule>` `LoadModule`

Das bedeutet, dass nur die grundlegendsten Funktionen im Kernserver enthalten sind

Erweiterte Funktionen sind über Module verfügbar, die in httpd geladen werden können
Standardmäßig wird ein Basissatz von Modulen zur Kompilierungszeit in den Server aufgenommen
Wenn der Server so kompiliert ist, dass er dynamisch geladeneModule verwendet, können Module separat kompiliert und jederzeit mit der LoadModule-Direktivehinzugefügt werden
Andernfalls muss httpd neu kompiliert werden, um Module hinzuzufügen oder zu entfernen
Konfigurationsdirektiven können abhängig vom Vorhandensein eines bestimmten Moduls aufgenommen werden, indem sie in einen <IfModule>-Block eingeschlossen werden. <IfModule>-Blöcke sind jedoch nicht erforderlich und können in einigen Fällen die Tatsache verschleiern, dass ein wichtiges Modul fehlt

Mit der Befehlszeilenoption -l können Sie sehen, welche Module derzeit in den Server kompiliert sind

Sie können auch mit der Befehlszeilenoption -Msehen, welche Module dynamisch geladen werden

Geltungsbereiche

Hauptkonfigurationsdateien

Direktiven gelten für den gesamten Server

**Geltungsbereiche von Direktiven**
Verwandte Module	Verwandte Richtlinien
	`<Directory>` `<DirectoryMatch>` `<Files>` `<FilesMatch>` `<Location>` `<LocationMatch>` `<VirtualHost>`

Teile des Servers

Wenn Sie die Konfiguration nur für einen Teil des Servers ändern möchten

können Sie Ihre Direktiven

in den Abschnitten

<Directory>
<DirectoryMatch>
<Files>
<FilesMatch>
<Location>
<LocationMatch>

unterbringen

Diese Abschnitte beschränken die Anwendung der Direktiven, die sie einschließen, auf bestimmte Dateisystemorte oder URLs

Sie können auch verschachtelt werden, was eine sehr feinkörnige Konfiguration ermöglicht

Virtuelles Hosting

httpd ist in der Lage, viele verschiedene Websites gleichzeitig zu bedienen

Dies wird als virtuelles Hosting bezeichnet
Richtlinien können auch in <VirtualHost>-Abschnitteeingefügt werden, so dass sie nur für Anfragen für eine bestimmte Website gelten

Direktiven

Obwohl die meisten Direktiven in jedem dieser Abschnitte platziert werden können, sind einige Direktiven in bestimmten Kontexten nicht sinnvoll

Direktiven, die die Prozesserstellung steuern, können beispielsweise nur im Hauptserverkontext platziert werden
Um herauszufinden, welche Direktiven in welchen Abschnitten platziert werden können, überprüfen Sie den Kontext der jeweiligen Direktive
Weitere Informationen finden Sie unter Wie funktionieren die Abschnitte Verzeichnis, Ort und Dateien?

.htaccess-Dateien

.htaccess

Anhang

Siehe auch

Apache/HTTP/Konfiguration

Links

Weblinks