• Tweet

• Tweet

Mit RewriteRule kann man die Rewrite-Engine des Softwaremoduls mod_rewrite des Apache-Webservers bedienen, also Anfragen an den Webserver intern umschreiben oder weiterleiten.

Somit können wir mit Rewrite Regeln wunderbar Weiterleitungen einrichten oder dynamische URLs unter statischen Adressen erreichbar machen.

Voraussetzung: Wir haben einen Apache Webserver mit installierten mod_rewrite Modul. Wir legen im Hauptverzeichnis der Domain eine Textdatei Namens .htacces an und fügen darin folgenden Text ein:

RewriteEngine On
ab hier zeilenweise die gewünschten Rewrite Bedingungen bzw. Rewrite Regeln einfügen...

RewriteRule

Allgemeine Syntax von RewriteRule:

RewriteRule Argument1 Argument2 [spezielle Angaben]

RewriteRule ist die Anweisung, Argument1 die vom Besucher aufgerufene URL, Argument2 die URL zu der der Webserver intern unsichtbar für den Besucher weiterleitet bzw. umschreibt.

Argument1 wird oft als regulärer Ausdruck angeführt, wobei ^ den regulären Ausdruck einleitet und $ ihn beendet.

RewriteRule-Beispiel: einfache Weiterleitung:

RewriteRule ^/seite1.html$ http://www.anderedomain.tld/seite2.html [R=301,L]

Ruft ein Besucher die URL http://www.domain.tld/seite1.html auf, so wird er automatisch zu http://www.anderedomain.tld/seite2.html weitergeleitet. Die Angabe R=301 gibt an, dass eine 301 Weiterleitung (permanente Weiterleitung) genutzt werden soll, das L (last rule) gibt an, dass es sich um die letzte Anweisung bzw. Regel handelt. Nachfolgende Anweisungen bzw. Regeln werden nicht berücksichtigt.

RewriteRule-Beispiel: einfache Umschreibung:

RewriteRule ^(.*)\.html$ /index.php?produkt=$1 [QSA,L]

Mit dieser Rewrite Regel wird die dynamischen URL http://www.domain.tld/index.php?produkt=auto als statische Adresse in der Form auto.html verfügbar gemacht d.h. der Besucher kann http://www.domain.tld/auto.html in der Adressleiste eintippen, der Webserver wandelt die statische Adresse intern, unsichtbar für den Besucher, in die dynamische URL http://www.domain.tld/index.php?produkt=auto um.

Innerhalb von regulären Ausdrücken steht der Punkt für ein beliebiges Zeichen, außer für Zeilenumbrüche. Das * Zeichen gibt an, dass das vorige Zeichen keinmal oder beliebig oft vorkommen kann. Der Ausdruck .* steht also für eine beliebige Zeichenfolge.

Die runde Klammerpaar kennzeichnet einen Platzhalter in der aufgerufenen URL, der in der umgeschriebenen URL mittels $1 eingefügt werden kann. Gibt es mehrere Platzhalter so werden sie von links nach rechts durchgezählt und können mit $2, $3 usw. eingefügt werden.

QSA (appaned query string) wird benötigt, damit ein eventuell der statischen Adresse zusätzlich angehängter Query String, der umgeschriebenen URL auch angehängt wird. Damit wird ein Aufruf von http://www.domain.tld/auto.html?marke=mercedes in die URL http://www.domain.tld/index.php?produkt=auto&marke=mercedes umgeschrieben.

RewriteCond

Nehmen wir zusätzlich zu den Rewrite Regeln die Rewrite Bedingungen hinzu, dann erhalten wir ein sehr mächtiges Werkzeug der URL Umschreibung.

Mit RewriteCond definieren wir eine Bedingung, von der abhängig gemacht wird, ob die folgende ReWriteRule Regel ausgeführt wird oder nicht. Die allgemeine Syntax lautet:

RewriteCond Argument1 Argument2

RewriteCond ist die Anweisung, Argument1 der Text der mit dem Text Argument2 verglichen werden soll. Argument1 kann neben normalem Text Servervariabeln wie z.B. HTTP_USER_AGENT, HTTP_HOST oder REQUEST_FILENAME enthalten. Argument2 wird oft als regulärer Ausdruck oder in Form von speziellen Flags angeführt.

RewriteCond-Beispiele:

RewriteCond %{HTTP_HOST} ^www\.domain\.tld$

%{HTTP_HOST} steht für die Servervariable HTTP_HOST, welche den übertragenen Domainnamen enthält.

^www\.hauptdomain\.tld$ steht für den regulären Ausdruck der www.domain.tld maskiert. Das ^Zeichen steht für den Beginn, das $ Zeichen für Ende des regulären Ausdruckes. Das \ Zeichen wird benötigt, damit der Punkt als normales Textzeichen und nicht als Sonderzeichen des regulären Ausdruckes verwendet wird.

Die angeführte Bedingung bedeutet also: wenn die per http übertragene Domain gleich www.domain.tld ist dann…

RewriteCond %{HTTP_HOST} !^ww\.domain\.tld$

Wenn die per http übertragene Domain ungleich www.domain.tld ist dann…

Ein Rufzeichen negiert also den Vergleichstext.

Als Argument2 kann man anstatt regulärer Ausdrücke auch spezielle Flags setzten z.B. –d oder –f

RewriteCond %{REQUEST_FILENAME} -d

Wenn der per http übertragene Dateiname gleich einem existierenden Verzeichnis dann..

RewriteCond %{REQUEST_FILENAME} -f

Wenn der per http übertragene Dateiname gleich einem existierenden Dateinamen dann..

Beispiele RewriteCond und RewriteRule:

Alle nicht existierenden URLs umleiten:

RewriteEngine On
RewriteCond %{REQUEST_FILENAME} !-d
RewriteCond %{REQUEST_FILENAME} !-f
RewriteRule ^(.*)$ http://www.zieldomain.tld/$1 [R=301,L]