[[:dw|{{ :wiki2.png?40|}}]]
===== URL Rewriting =====

Damit die URL Ihres Dokuwiki in eine leichter lesbare Form gebracht wird, kann der Apache2 Webserver und Dokuwiki für das URL-Rewriting konfiguriert werden. Dokuwiki unterstützt bereits das URL Rewriting, welches jedoch out of the box deaktiviert ist, weil dafür einige Konfigurationen am Webserver Voraussetzungen sind((http://www.dokuwiki.org/de:rewrite)).

**Apache2 Rewriting Module:** Eine Apache2 Standard Installation auf Debian hat das Rewrite Module bereits einkompiliert, lediglich aktiviert ist es noch nicht. Überprüfen Sie ob das mod-rewrite Module in Ihrer Apache2 Webserver Konfiguration vorhanden ist:

<xterm>$ <fc #008000>ls -l /etc/apache2/mods-available/ | grep rewrite</fc>
-rw-r--r-- 1 root root   66 2008-03-22 10:24 rewrite.load
</xterm>

**mod-rewrite laden:** Damit das Rewrite Module beim Start des Apache geladen wird, verlinken Sie das Modul von >><fc #008000>mods-available</fc><< nach >><fc #008000>mods-enabled</fc><<:

<xterm># <fc #008000>ln -s /etc/apache2/mods-available/rewrite.load /etc/apache2/mods-enabled/</fc></xterm>

**mod-rewrite starten:** Damit das geladene Modul gestartet wird, braucht es eine Start Anweisung. Diese Startanweisung kann ebenfalls in der >>httpd.conf<< vorgenommen werden. Hostet der Server aber mehrere Vhosts und es werden unterschiedliche rewrite-rules benötigt, empfiehlt sich die weitere Konfiguration in der lokalen >>.htaccess<< Datei, die im Document Root des VHosts vorliegen muss. In dieser Datei werden dann auch die Rewrite Regeln definiert. 

<file|{DOCUMENT_ROOT}/.htaccess>
RewriteEngine on
 
RewriteRule ^_media/(.*)              lib/exe/fetch.php?media=$1  [QSA,L]
RewriteRule ^_detail/(.*)             lib/exe/detail.php?media=$1  [QSA,L]
RewriteRule ^_export/([^/]+)/(.*)     doku.php?do=export_$1&id=$2  [QSA,L]
RewriteRule ^$                        doku.php  [L]
RewriteCond %{REQUEST_FILENAME}       !-f
RewriteCond %{REQUEST_FILENAME}       !-d
RewriteRule (.*)                      doku.php?id=$1  [QSA,L]
</file>

Als Letztes muss noch das URL Rewriting über die >>.htaccess<< in der Dokuwiki Konfiguration aktiviert werden:

{{ :tux:userewrite2.png |}}

Hier kann auch ein >>/<< (Slash) als Namespace Trenner anstelle des standardmäßigen >>:<< (Doppelpunkt) eingestellt werden.


**Verwandte Artikel:**
[[:tux:apache_vhost|-> Apache (Vhost) Installation]]


 --- //pronto 2010/10/07 10:27//
{{keywords>apache2 dokuwiki url rewrite .htaccess httpd.conf}}