httpd.conf
httpd.conf - Kurzbeschreibung
Beschreibung
httpd.conf ist der Dateiname der Konfigurationsdatei eines Apache HTTP Servers
- Der Server liest verschiedene Konfigurationseigenschaften aus dieser Textdatei
- Diese Konfigurationseigenschaften können direkt in der Datei mithilfe von Superbenutzerberechtigungen bearbeitet werden
- Die httpd.conf-Datei kann sich auf jedem Unix-basierten System befinden
- Der Ablageort der httpd.conf wird bei der Kompilierung festgelegt, kann mit der Befehlszeilenoption -f überschrieben werden und durch Verwendung der Direktive Include um weitere Konfigurationsdateien (wie ports.conf) ergänzt werden
Die dezentrale Verwaltung der Konfiguration des Apache erfolgt mittels spezieller Dateien innerhalb des Web-Verzeichnisbaums, die gewöhnlich .htaccess heißen
Konfigurationsdateien
Hauptkonfigurationsdateien |
Syntax der Konfigurationsdateien |
Module |
Geltungsbereich der Richtlinien |
.htaccess-Dateien |
Hauptkonfigurationsdateien
Verwandte Module | Verwandte Richtlinien |
---|---|
|
|
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-Direktive
hinzugefü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 der Konfigurationsdateien
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
Verwandte Module | Verwandte Richtlinien |
---|---|
|
|
httpd ist ein modularer Server
- 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-Direktive
hinzugefü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
-M
sehen, welche Module dynamisch geladen werden
Geltungsbereich der Richtlinien
Verwandte Module | Verwandte Richtlinien |
---|---|
|
Direktiven in den Hauptkonfigurationsdateien gelten für den gesamten Server
- 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>
und<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
httpd ist in der Lage, viele verschiedene Websites gleichzeitig zu bedienen
- Dies wird als virtuelles Hosting bezeichnet
- Richtlinien können auch in
<VirtualHost>-Abschnitte
eingefügt werden, so dass sie nur für Anfragen für eine bestimmte Website gelten
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
Verwandte Module | Verwandte Richtlinien |
---|---|
|
httpd ermöglicht eine dezentrale Verwaltung der Konfiguration über spezielle Dateien, die innerhalb des Webbaums platziert werden
- Die speziellen Dateien heißen in der Regel
.htaccess
, aber jeder Name kann in der DirektiveAccessFileName
angegeben werden - Direktiven in
.htaccess-Dateien
gelten für das Verzeichnis, in dem Sie die Datei ablegen, sowie für alle Unterverzeichnisse - Die
.htaccess-Dateien
folgen der gleichen Syntax wie die Hauptkonfigurationsdateien - Da
.htaccess-Dateien
bei jeder Anfrage gelesen werden, sind Änderungen in diesen Dateien sofort wirksam
Um herauszufinden, welche Direktiven in .htaccess-Dateien
platziert werden können, prüfen Sie den Kontext der Direktive
- Der Serveradministrator steuert weiter, welche Direktiven in
.htaccess-Dateien
platziert werden können, indem er dieAllowOverride-Direktive
in den Hauptkonfigurationsdateien konfiguriert
Weitere Informationen zu .htaccess-Dateien
finden Sie in der Anleitung zu .htaccess
Anhang
Siehe auch
Links
Weblinks