mod_alias Zuweisung unterschiedlicher Teile des Host-Dateisystems im Dokumentbaum zu URLs und URL-Umleitung Base mod_alias.c alias_module

Die in diesem Modul enthaltenen Direktiven erlauben die Manipulation und Steuerung von URLs beim Eingang von Anfragen beim Server. Die Alias- und ScriptAlias-Direktiven nehmen Zuweisungen zwischen URLs und Dateisystempfaden vor. Auf diese Weise können Inhalte, die direkt unter der DocumentRoot liegen, als Teil des Web-Dokumentbaums bedient werden. Die ScriptAlias-Direktive kennzeichnet das Zielverzeichnis zusätzlich als ein Verzeichnis, das nur CGI-Skripte enthält.

Die Redirect-Direktiven fordern die Clients auf, eine neue Anfrage mit einer anderen URL zu versuchen. Sie werden häufig benutzt, wenn eine Ressource an einer anderen Ort verlagert wurde.

 mod_rewrite URLs auf das Dateisystem abbilden Alias Ordnet URLs Positionen im Dateisystem zu Alias URL-Pfad| Dateipfad|Verzeichnispfad server configvirtual host

Die Alias-Direktive ermöglicht das Speichern von Dokumenten im Dateisystem an anderer Position als unter DocumentRoot. URLs deren Pfad mit URL-Pfad (%-Kodierung) beginnt, werden lokalen Dateien zugeordnet, die mit Verzeichnispfad beginnen.

Beispiel: Alias /image /ftp/pub/image

Bei einer Anforderung von http://myserver/image/foo.gif liefert der Server die Datei /ftp/pub/image/foo.gif zurück.

Wird dem URL-Pfad ein Schrägstrich / nachgestellt, verlangt der Server einen nachgestellten Schrägstrich /, um den Alias vervollständigen zu können. Wenn Sie Alias /icons/ /usr/local/apache/icons/ verwenden, wird daher die URL /icons nicht zugeordnet.

Möglicherweise müssen weitere Directory-Abschnitte angegeben werden, die sich mit dem anzusprechenden Ziel decken. Alias-Zuordnungen erfolgen vor Überprüfung der Directory-Abschnitte, so dass das Ziel eines Alias davon betroffen ist. (Beachten Sie aber, dass Location-Abschnitte vor der Alias-Zuordnung durchlaufen und daher angewendet werden.)

Insbesondere bei der Anlage eines Alias für ein Verzeichnis außerhalb der DocumentRoot kann es erforderlich sein, den Zugriff auf das Zielverzeichnis explizit zuzulassen.

Beispiel: Alias /image /ftp/pub/image
<Directory /ftp/pub/image>
Order allow,deny
Allow from all
 </Directory> AliasMatch Weist URLs mit regulären Ausdrücken Positionen im Dateisystem zu AliasMatch Regulärer Ausdruck Dateipfad|Verzeichnispfad server configvirtual host

Diese Direktive entspricht der Alias-Direktive, verwendet aber standardmäßige reguläre Ausdrücke anstelle eines einfachen Präfixvergleichs. Der angegebene reguläre Ausdruck wird mit dem URL-Pfad verglichen und bei Übereinstimmung ersetzt der Server alle geklammerten Übereinstimmungen durch die angegebene Zeichenfolge und verwendet sie als Dateinamen. Das Verzeichnis /icons kann beispielsweise so aktiviert werden:

AliasMatch ^/icons(.*) /usr/local/apache/icons$1 Redirect Sendet eine externe Umleitung, die vom Client eine andere URL anfordert. Redirect [Status] URL-Pfad URL server configvirtual host directory.htaccess FileInfo

Die Redirect-Direktive ordnet eine alte URL einer neuen zu. Die neue URL wird an den Client zurückgegeben, der ihn mit dieser neuen Adresse noch einmal anfragt. URL-Pfad ist ein Pfad (%-Kodierung). Jede Anforderung von Dokumenten, die mit diesem Pfad beginnt, erhält einen Umleitungsfehler mit einer neuen URL (%-Kodierung), die mit URL beginnt.

Beispiel: Redirect /service http://foo2.bar.com/service

Fordert der Client http://myserver/service/foo.txt an, dann wird er an http://foo2.bar.com/service/foo.txt verwiesen.

Hinweis

Redirect-Direktiven haben ungeachtet der Reihenfolge der Konfigurationsdatei Vorrang vor Alias- und ScriptAlias-Direktiven. Außerdem muss es sich beim URL-Pfad um einen absoluten und nicht um einen relativen Pfad handeln. Das gilt auch für htaccess-Dateien oder innerhalb von Directory-Abschnitten.

Wird das Argument Status nicht angegeben, bleibt die Umleitung "temporär" (HTTP status 302). Das zeigt dem Client an, dass diese Ressource temporär verschoben wurde. Das Status-Argument kann für die Rückgabe anderer HTTP-Statuscodes verwendet werden:

permanent
Gibt einen permanenten Redirect-Status (301) zurück, der anzeigt, dass die Ressource dauerhaft verlagert wurde.
temp
Gibt einen temporären Redirect-Status (302) zurück (Standardeinstellung).
seeother
Gibt den Status "See Other" (303) zurück, der angibt, dass die Ressource ersetzt wurde.
gone
Gibt den Status "Gone" (410) zurück, der angibt, dass die Ressource dauerhaft entfernt wurde. Wird dieser Status verwendet, sollte das URL-Argument weggelassen werden.

Andere Statuscodes können durch Angabe des numerischen Statuscodes als Wert für Status zurückgegeben werden. Liegt der Status zwischen 300 und 399, muss das Argument URL angegeben werden, andernfalls kann es weggelassen werden. Beachten Sie dass der Status dem Apache-Code bekannt sein muss (siehe die Funktion send_error_response in http_protocol.c).

Beispiel: Redirect permanent /one http://example.com/two
Redirect 303 /three http://example.com/other RedirectMatch Übergibt einen externen Redirect, der auf einer Übereinstimmung mit einem regulären Ausdruck für den aktuellen URL basiert. RedirectMatch [Status] Regulärer Ausdruck URL server configvirtual host directory.htaccess FileInfo

Diese Direktive entspricht der Direktive Redirect, verwendet aber standardmäßige reguläre Ausdrücke anstelle eines einfachen Präfixvergleichs. Der angegebene reguläre Ausdruck wird mit dem URL-Pfad verglichen und bei Übereinstimmung ersetzt der Server alle geklammerten Übereinstimmungen durch die angegebene Zeichenfolge und verwendet sie als Dateiname. Alle GIF-Dateien können beispielsweise wie folgt zu ähnlich bezeichneten JPEG-Dateien auf einem Server umgelenkt werden:

RedirectMatch (.*)\.gif$ http://www.anotherserver.com$1.jpg RedirectTemp Übergibt einen externen temporären Redirect und fordert den Client auf, eine andere URL zu wählen. RedirectTemp URL-Pfad URL server configvirtual host directory.htaccess FileInfo

Diese Direktive teilt dem Client mit, dass die Umlenkung nur temporär ist (Status 302). Sie stimmt mit Redirect temp überein.

 RedirectPermanent übergibt einen externen permanenten Redirect und fordert den Client auf, eine andere URL zu wählen. RedirectPermanent URL-Pfad URL server configvirtual host directory.htaccess FileInfo

Diese Direktive informiert den Client über eine permanente Umlenkung (Status 301). Stimmt mit Redirect permanent überein.

 ScriptAlias Ordnet eine URL einer Position im Dateisystem zu und kennzeichnet das Zielobjekt als CGI-Skript. ScriptAlias URL-Pfad Dateipfad|Verzeichnispfad server configvirtual host

Die ScriptAlias-Direktive liefert das gleiche Ergebnis wie die Alias-Direktive, allerdings wird das Zielverzeichnis als Verzeichnis mit CGI-Skripten gekennzeichnet, die vom CGI-Skript-Handler des Moduls mod_cgi behandelt werden. URLs mit einem URL-Pfad am Anfang (%-Kodierung) werden Skripten zugeordnet, die mit dem zweiten Argument beginnen, bei dem es sich um eine vollständige Pfadangabe im lokalen Dateisystem handelt.

Beispiel: ScriptAlias /cgi-bin/ /web/cgi-bin/

Die Anforderung von http://myserver/cgi-bin/foo würde den Server dazu veranlassen, das Skript /web/cgi-bin/foo auszuführen.

 ScriptAliasMatch Ordnet eine URL mit Hilfe eines regulären Ausdrucks eine Position im Dateisystem zu und kennzeichnet das Zielobjekt als CGI-Skript. ScriptAliasMatch Regulärer Ausdruck Dateipfad|Verzeichnispfad server configvirtual host

Diese Direktive entspricht der Direktive ScriptAlias, verwendet jedoch standardmäßige reguläre Ausdrücke anstelle eines einfachen Präfixvergleichs. Der angegebene reguläre Ausdruck wird mit dem URL-Pfad verglichen und bei Übereinstimmung ersetzt der Server geklammerte Übereinstimmungen durch die angegebene Zeichenfolge und benutzt sie als Dateiname. Das standardmäßige /cgi-bin kann beispielsweise wie folgt aktiviert werden:

ScriptAliasMatch ^/cgi-bin(.*) /usr/local/apache/cgi-bin$1