(cf doc apache officielle)

mod_alias et directives alias

Les directives fournies par ce module replica Rolex submariner permettent de manipuler et de contrôler les URLs à l’arrivée des requêtes sur le serveur. Les directives Alias et ScriptAlias permettent de faire correspondre des URLs avec des chemins du système de fichiers. Ceci permet de servir des contenus qui ne sont pas situés dans l’arborescence de DocumentRoot comme s’ils y étaient réellement. La directive ScriptAlias a pour effet supplémentaire de marquer le répertoire cible comme conteneur de scripts CGI.

mod_alias est conçu pour traiter des tâches simples replica watches uk  de manipulation d’URL. Pour des tâches plus complexes comme la manipulation des chaînes d’arguments des requêtes, utilisez plutôt les outils fournis par le module mod_rewrite

Alias "/foo/bar" "/baz"
Alias "/foo" "/gaq"

Alias "/image" "/ftp/pub/image"

Alias "/icons/" "/usr/local/apache/icons/"

Alias "/image" "/ftp/pub/image"
<Directory "/ftp/pub/image">
    Require all granted
</Directory>

• permanent tells the client the resource has moved permanently. This returns a 301 HTTP status code.
• temp is the default behavior, and tells the client the resource has moved temporarily. This returns a 302 HTTP status code.
• seeother tells the user the requested resource has been replaced by another one. This returns a 303 HTTP status code.
• gone tells the user that the resource they are looking for has been removed permanently. When using this argument, you don’t need to specify a final URL. This returns a 410 HTTP status code.

Exemple de redirection http vers https

RediRedirect permanent / https://localhost/

ou plus générique

Redirect permanent / https://%{HTTP_HOST}%{REQUEST_URI}

mod_rewrite et directive rewrite

Le module Apache mod_rewrite est un module puissant et sophistiqué qui  permet la réécriture des URLs. Grâce à lui, vous pouvez effectuer quasiment tous les types de réécriture d’URLs dont vous avez besoin. Il est cependant assez complexe, et peut paraître intimidant au débutant. Certains ont aussi tendance à traiter les règles de réécriture comme des incantations magiques, et à les utiliser sans vraiment comprendre leur manière d’agir.

Gardez à l’esprit que de nombreuses tâches de manipulation d’URLs courantes n’ont pas besoin de la puissance et de la complexité de mod_rewrite. Pour les tâches simples, voir mod_alias

Regles d’écritures

Une règle de réécriture RewriteRule est constituée de trois arguments séparés par des espaces. Les arguments sont :

1. Modèle: le modèle des URLs auxquelles la règle doit s’appliquer;
2. Substitution: vers quoi la requête correspondante doit être transformée;
3. [drapeaux]: options affectant la requête réécrite.

Le Modèle est une expression rationnelle. Au sein de la première règle de réécriture, ou jusqu’à ce qu’une substitution survienne, elle est comparée au chemin de l’URL de la requête entrante (la partie située après le nom d’hôte mais avant tout point d’interrogation qui indique le début d’une chaîne de paramètres de requête) ou, dans un contexte de répertoire, au chemin de la requête relativement au répertoire pour lequel la règle est définie. Lorsqu’une substitution a eu lieu, les règles suivantes effectuent leurs comparaisons par rapport à la valeur substituée.

exemple

rediriger /produits/vues vers une URL complete sans tenir compte de la casse:

RewriteRule "^/produits/vues$" "http://site2.example.com/voirproduits.html" [NC]

DEBUG

Configurer le niveau de journalisation de mod_rewrite à un des niveaux de trace via la directive LogLevel. Bien que ceci risque de vous submerger sous une énorme quantité d’informations, le débogage des problèmes avec la configuration de mod_rewrite est à ce prix car vous verrez alors exactement comment chaque règle est traitée.

Expressions rationnelles

mod_rewrite utilise le vocabulaire des Expressions rationnelles compatibles Perl. Voir la page de manuel des expressions rationnelles Perl, et l’ouvrage Mastering Regular Expressions, by Jeffrey Friedl.

Résumé des expression régulières

Drapeaux de réécriture

Le comportement d’une règle RewriteRule peut être modifié par la présence d’un ou plusieurs drapeaux en fin de règle. Par exemple, les conditions de correspondance d’une règle peuvent être rendues insensibles à la casse par la présence du drapeau [NC] :

RewriteRule "^puppy.html" "petitchien.html" [NC]

Pour une liste des drapeaux disponibles, leurs significations, et des exemples, voir ci dessous:

.

Quelques exemples

De l’ancienne à la nouvelle URL (en interne)

Supposons que nous ayons récemment renommé la page foo.html en bar.html, et voulions maintenant que l’ancienne URL soit toujours valide à des fins de compatibilité ascendante. En fait, on voudrait que le changement de nom soit transparent aux utilisateurs de l’ancienne URL.

Solution : On réécrit l’ancienne URL en interne vers la nouvelle via la règle suivante :

RewriteEngine  on
RewriteRule    "^/foo\.html$" "/bar.html" [PT]

Redirection http vers https

RewriteEngine On
RewriteCond %{HTTPS} !on
RewriteRule (.*) https://%{HTTP_HOST}%{REQUEST_URI}

le ‘.’ indique un caractere quelconque et le ‘*’ n’importe quelle chaine eventuellement vide.
Donc (.*) indique que pour que la regle s’applique il faut qu’il y ait au moins un caractere , un URL vide ne declenche …rien.