mod rewrite

Dieser Artikel wurde für die folgenden Ubuntu-Versionen getestet:

Ubuntu 16.10 Yakkety Yak
Ubuntu 12.04 Precise Pangolin

Zum Verständnis dieses Artikels sind folgende Seiten hilfreich:

Inhaltsverzeichnis

mod_rewrite
Modul nutzen
Beispiele
Links

"mod_rewrite" ist ein Apache-Modul, um URLs zu manipulieren. Mit der RewriteEngine des Apache-Webservers ist es möglich, die angeforderte URL anhand von Regeln "umzuschreiben" (en: to rewrite). Basierend auf einem Parser für Reguläre Ausdrücke kann die angeforderte URL manipuliert werden.

mod_rewrite¶

Als erstes muss das Modul aktiviert werden

sudo a2enmod rewrite

Das Verzeichnis für die Prozess-ID fehlt eventuell, man muss es daher mit

sudo mkdir -p /var/run/apache2
sudo chown -R www-data /var/run/apache2

anlegen. Danach sollten alle Module aktiviert werden. Ansonsten kann dies zu einen 500 Internal Server Error führen.

sudo a2enmod actions

Schließlich muss die Konfiguration von Apache wieder neu eingelesen werden

sudo /etc/init.d/apache2 force-reload

Modul nutzen¶

Üblicherweise wird die Rewrite-Bedingungen direkt über .htaccess-Dateien in den entsprechenden Verzeichnissen des Webservers festgelegt.

1 2	RewriteEngine on RewriteCond ...

Um das Modul in .htaccess-Dateien zu aktivieren, muss meist noch im Verzeichnis /etc/apache2/sites-enabled/ die Datei 000-default bzw. default (je nach Version) angepasst werden. Dazu muss die Datei in einem Editor mit Root-Rechten geöffnet werden ^[2]:

Anschließend muss die letzte Zeile in dieser Passage

1
2
3

<Directory /var/www/>
                Options Indexes FollowSymLinks MultiViews
                AllowOverride None

geändert werden. Um das Umschreiben von URLs zu erlauben, muss das "None" durch "FileInfo" ersetzt werden. Andere mögliche Werte können in der Dokumentation nachgelesen werden (siehe Links am Ende des Artikels).

Beispiele¶

Webmailer auf HTTPS umleiten¶

Oftmals wird z.B. gewünscht, dass gewisse Seiten nur über https erreicht werden können. Ein klassisches Beispiel sind Webmailer wie Squirrelmail oder RoundCube Webmail {en} .

In der Datei /etc/apache2/sites-available/default müssen dafür z.B. die Zeilen:

RewriteEngine   on
RewriteRule     ^/webmail(.*)$ https://%{SERVER_NAME}/webmail$1 [L,R]
RewriteLog      "/var/log/apache2/rewrite.log"
RewriteLogLevel 2

hinzugefügt ^[2] werden. Hier würde http://domain.tld/webmail automatisch auf https://domain.tld/webmail umgeleitet werden.