Serveur Apache HTTP Version 2.4
Serveur Apache HTTP Version 2.4
| Description: | Effectue des opérations de recherche/remplacement sur les corps de réponses |
|---|---|
| Statut: | Extension |
| Identificateur de Module: | substitute_module |
| Fichier Source: | mod_substitute.c |
| Compatibilité: | Disponible depuis la version 2.2.7 du serveur HTTP Apache |
mod_substitute fournit un mécanisme permettant
d'effectuer des substitutions de chaînes fixes ou d'expressions
rationnelles sur les corps de réponses.
| Description: | Modèle de substition dans le contenu de la réponse |
|---|---|
| Syntaxe: | Substitute s/modèle/substitution/[infq] |
| Contexte: | répertoire, .htaccess |
| AllowOverride: | FileInfo |
| Statut: | Extension |
| Module: | mod_substitute |
La directive Substitute permet de
spécifier un modèle de recherche/remplacement à appliquer au corps
de la réponse.
La signification du modèle peut être modifiée via toute combinaison de ces drapeaux :
inn force le traitement du
modèle en tant que chaîne fixe.ff, mod_substitute met à plat le
résultat d'une substitution (les conteneurs ou buckets ne sont
pas dissociés), ce qui permet à d'éventuelles substitutions
ultérieures de s'effectuer sur cette dernière. C'est le
comportement par défaut.qq, mod_substitute dissocie les
conteneurs (ou buckets) après chaque substitution. Ceci peut
améliorer la rapidité de la réponse et diminuer la quantité de
mémoire utilisée, mais ne doit être utilisé que s'il n'existe
aucune possibilité pour que le résultat d'une substitution ne
corresponde au modèle ou à l'expression rationnelle d'une
substitution ultérieure.<Location />
AddOutputFilterByType SUBSTITUTE text/html
Substitute s/foo/bar/ni
</Location>
Si le modèle ou la chaîne de substitution contient un caractère slash '/', il faut utiliser un autre délimiteur :
<Location />
AddOutputFilterByType SUBSTITUTE text/html
Substitute "s|<BR */?>|<br />|i"
</Location>
Lorsqu'on utilise des expressions rationnelles, on peut insérer des références arrières dans les opérations de comparaison et de substitution, comme illustré dans l'exemple suivant :
<Location />
AddOutputFilterByType SUBSTITUTE text/html
# "foo=k,bar=k" -> "foo/bar=k"
Substitute "s|foo=(\w+),bar=\1|foo/bar=$1"
</Location>
Un scénario courant d'utilisation de mod_substitute
est la situation où un serveur frontal mandate des requêtes pour un
serveur d'arrière-plan qui renvoie des documents HTML contenant des
URLs intégrées codées en dur qui font référence à ce serveur
d'arrière-plan. Ces URLs ne fonctionnent pas pour l'utilisateur
final car le serveur d'arrière-plan est hors d'atteinte.
On peut, dans ce cas, utiliser mod_substutite pour
réécrire ces URLs afin qu'elles soit utilisables dans la partie
située derrière le mandataire :
ProxyPass /blog/ http://internal.blog.example.com ProxyPassReverse /blog/ http://internal.blog.example.com/ Substitute "s|http://internal.blog.example.com/|http://www.example.com/blog/|i"
La directive ProxyPassReverse modifie tout en-tête
Location (redirection) envoyé par le serveur
d'arrière-plan et, dans cet exemple, la directive
Substitute se charge à son tour de la modification de
la réponse HTML.