Apache/URL Rewriting

Principe

Sur Internet on distingue globalement quatre types de redirection automatique des navigateurs vers d'autres adresses que celles sur lesquelles ils arrivent :

1. HTML (<meta http-equiv="refresh" content="1; URL=http://destination.fr">).
2. PHP (header('Location: http://destination.fr');).
3. Javascript.
4. HTTP, proposant elle-même plusieurs techniques décrites ci-dessous.

Les règles de réécriture appliquées sur tout le serveur Apache se situent dans /etc/apache2/sites-available/default ou /usr/local/apache/conf/httpd.conf.

Les fichiers .htaccess peuvent également en contenir pour personnaliser chaque répertoire.

D'une manière générale, Apache permet de rediriger vers une autre page grâce à :

1. Dans les systèmes Unix, la ligne Options +FollowSymLinks permet au navigateur de suivre les liens symboliques, en naviguant dans le système de fichier.
2. Alias.
3. AliasMatch (pareil avec du regex).
4. RewriteRule réécrit l'URL selon des règles pouvant être précisées en regex. Il nécessite d'être installé sous peine d'erreurs 500, via la commande Unix a2enmod rewrite.
5. Redirect renvoie simplement ailleurs.
6. RedirectMatch (pareil avec du regex).

Attention !

Définir une redirection définitive (Redirect permanent) ne s'annule pas seulement en changeant le code qui l'a définit, mais dure jusqu'à expiration du cache serveur. Pour forcer sa suppression immédiate, lancer par exemple :

/usr/local/apache/bin/htcacheclean -p/var/cache/edb/dep/usr/local/portage-ovh/www-apache -l500M
/etc/init.d/apache restart

AllowOverride

Attention, si vous n'avez pas créé de VirtualHost, un VirtualHost par défaut est utilisé par apache2 qui ignore les fichiers .htaccess

Pour y remédier :

 sudo vi /etc/apache2/sites-enabled/000-default

et remplacez AllowOverride none par AllowOverride All (normalement 2 fois), puis relancez apache :

 sudo /etc/init.d/apache2 reload

Exemples

Dans la syntaxe suivante, le point seul représente le répertoire courant, et le slash seul la racine de l'URL (le domaine).

Pour changer le domaine vers localhost, tout en gardant la même URL :

SetEnv PHP_VER 5
Redirect / http://localhost/

Plus subtile, on peut changer l'ordre des paramètres initiaux dans l'URL de destination :

RewriteEngine on
RewriteBase /
RewriteRule ^/xtools/ec/*$ /xtools/pcount/index.php

Pour rediriger les requêtes sous certaines condition il existe RewriteCond. Par exemple pour que toutes les pages non trouvées renvoient vers l'accueil au lieu d'afficher une erreur :

RewriteCond %{REQUEST_FILENAME} !-f
RewriteRule ^(.*)$ index.php