|
Packit |
90a5c9 |
|
|
Packit |
90a5c9 |
|
|
Packit |
90a5c9 |
<html xmlns="http://www.w3.org/1999/xhtml" lang="fr" xml:lang="fr"><head>
|
|
Packit |
90a5c9 |
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
|
|
Packit |
90a5c9 |
|
|
Packit |
90a5c9 |
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
|
|
Packit |
90a5c9 |
This file is generated from xml source: DO NOT EDIT
|
|
Packit |
90a5c9 |
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
|
|
Packit |
90a5c9 |
-->
|
|
Packit |
90a5c9 |
<title>mod_proxy_html - Serveur HTTP Apache Version 2.4</title>
|
|
Packit |
90a5c9 |
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" />
|
|
Packit |
90a5c9 |
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" />
|
|
Packit |
90a5c9 |
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" /><link rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
|
|
Packit |
90a5c9 |
<script src="../style/scripts/prettify.min.js" type="text/javascript">
|
|
Packit |
90a5c9 |
</script>
|
|
Packit |
90a5c9 |
|
|
Packit |
90a5c9 |
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
|
|
Packit |
90a5c9 |
<body>
|
|
Packit |
90a5c9 |
|
|
Packit |
90a5c9 |
Modules | Directives | FAQ | Glossaire | Plan du site
|
|
Packit |
90a5c9 |
Serveur HTTP Apache Version 2.4
|
|
Packit |
90a5c9 |
|
|
Packit |
90a5c9 |
|
|
Packit |
90a5c9 |
|
|
Packit |
90a5c9 |
Apache > Serveur HTTP > Documentation > Version 2.4 > Modules
|
|
Packit |
90a5c9 |
|
|
Packit |
90a5c9 |
Module Apache mod_proxy_html
|
|
Packit |
90a5c9 |
|
|
Packit |
90a5c9 |
Langues Disponibles: en |
|
|
Packit |
90a5c9 |
fr
|
|
Packit |
90a5c9 |
|
|
Packit |
90a5c9 |
| Description: | Réécrit les liens HTML afin de s'assurer qu'ils soient bien |
|---|
|
|
Packit |
90a5c9 |
adressables depuis les réseaux des clients dans un contexte de
|
|
Packit |
90a5c9 |
mandataire.
|
|
Packit |
90a5c9 |
Statut:Base
|
|
Packit |
90a5c9 |
Identificateur de Module:proxy_html_module
|
|
Packit |
90a5c9 |
Fichier Source:mod_proxy_html.c
|
|
Packit |
90a5c9 |
Compatibilité:Disponible depuis la version 2.4 du serveur HTTP Apache.
|
|
Packit |
90a5c9 |
Disponible en tant que module tiers dans les versions 2.x antérieures
|
|
Packit |
90a5c9 |
Sommaire
|
|
Packit |
90a5c9 |
|
|
Packit |
90a5c9 |
Ce module fournit un filtre en sortie permettant de réécrire les liens
|
|
Packit |
90a5c9 |
HTML dans un contexte de mandataire, afin de s'assurer que ces liens
|
|
Packit |
90a5c9 |
fonctionnent pour les utilisateurs en dehors du mandataire. Il accomplit la
|
|
Packit |
90a5c9 |
même tâche que la directive ProxyPassReverse d'Apache accomplit pour les
|
|
Packit |
90a5c9 |
en-têtes HTTP, et fait partie des composants essentiels d'un mandataire
|
|
Packit |
90a5c9 |
inverse.
|
|
Packit |
90a5c9 |
|
|
Packit |
90a5c9 |
Par exemple, si une entreprise possède un serveur d'applications
|
|
Packit |
90a5c9 |
nommé appserver.example.com qui n'est visible que depuis son réseau
|
|
Packit |
90a5c9 |
interne, et un serveur web public www.example.com, il peut
|
|
Packit |
90a5c9 |
être souhaitable de fournir une passerelle vers le serveur d'application
|
|
Packit |
90a5c9 |
à l'adresse http://www.example.com/appserver/. Lorsque le
|
|
Packit |
90a5c9 |
serveur d'applications présente un lien vers lui-même, ce lien doit être
|
|
Packit |
90a5c9 |
réécrit pour fonctionner à travers la passerelle. A cet effet,
|
|
Packit |
90a5c9 |
mod_proxy_html permet de réécrire <a
|
|
Packit |
90a5c9 |
href="http://appserver.example.com/foo/bar.html">foobar</a>
|
|
Packit |
90a5c9 |
en <a
|
|
Packit |
90a5c9 |
href="http://www.example.com/appserver/foo/bar.html">foobar</a>,
|
|
Packit |
90a5c9 |
ce qui permet de rendre le serveur d'applications accessible depuis
|
|
Packit |
90a5c9 |
l'extérieur.
|
|
Packit |
90a5c9 |
|
|
Packit |
90a5c9 |
mod_proxy_html a été développé à l'origine à WebÞing, dont la documentation
|
|
Packit |
90a5c9 |
détaillée pourra s'avérer utile aux utilisateurs.
|
|
Packit |
90a5c9 |
|
|
Packit |
90a5c9 |
![Support Apache!]() Directives
|
|
Packit |
90a5c9 |
|
|
Packit |
90a5c9 |
 ProxyHTMLBufSize
|
|
Packit |
90a5c9 |
ProxyHTMLCharsetOut
|
|
Packit |
90a5c9 |
ProxyHTMLDocType
|
|
Packit |
90a5c9 |
ProxyHTMLEnable
|
|
Packit |
90a5c9 |
ProxyHTMLEvents
|
|
Packit |
90a5c9 |
ProxyHTMLExtended
|
|
Packit |
90a5c9 |
ProxyHTMLFixups
|
|
Packit |
90a5c9 |
ProxyHTMLInterp
|
|
Packit |
90a5c9 |
ProxyHTMLLinks
|
|
Packit |
90a5c9 |
ProxyHTMLMeta
|
|
Packit |
90a5c9 |
ProxyHTMLStripComments
|
|
Packit |
90a5c9 |
ProxyHTMLURLMap
|
|
Packit |
90a5c9 |
|
|
Packit |
90a5c9 |
Traitement des bugsVoir aussi
|
|
Packit |
90a5c9 |
|
|
Packit |
90a5c9 |
Commentaires
|
|
Packit |
90a5c9 |
|
|
Packit |
90a5c9 |
|
|
Packit |
90a5c9 |
|
|
Packit |
90a5c9 |
|
|
Packit |
90a5c9 |
Description:Définit l'incrément de la taille du tampon, ainsi que sa
|
|
Packit |
90a5c9 |
taille initiale, pour la mise en
|
|
Packit |
90a5c9 |
tampon des scripts en ligne et des feuilles de style.
|
|
Packit |
90a5c9 |
Syntaxe:ProxyHTMLBufSize nb-octets
|
|
Packit |
90a5c9 |
Défaut:ProxyHTMLBufSize 8192
|
|
Packit |
90a5c9 |
Contexte:configuration globale, serveur virtuel, répertoire
|
|
Packit |
90a5c9 |
Statut:Base
|
|
Packit |
90a5c9 |
Module:mod_proxy_html
|
|
Packit |
90a5c9 |
Compatibilité:Disponible depuis la version 2.4 du serveur HTTP Apache.
|
|
Packit |
90a5c9 |
Disponible en tant que module tiers dans les versions 2.x antérieures.
|
|
Packit |
90a5c9 |
|
|
Packit |
90a5c9 |
Pour pouvoir interpréter du contenu non HTML (feuilles de style et
|
|
Packit |
90a5c9 |
scripts) embarqué dans des documents HTML, mod_proxy_html doit
|
|
Packit |
90a5c9 |
le lire et le mémoriser en entier dans un
|
|
Packit |
90a5c9 |
tampon. Ce tampon devra être étendu autant que nécessaire afin de
|
|
Packit |
90a5c9 |
pouvoir accueillir le plus grand script ou la plus grande feuille de
|
|
Packit |
90a5c9 |
style de la page, selon un incrément de nb-octets que cette
|
|
Packit |
90a5c9 |
directive permet de définir.
|
|
Packit |
90a5c9 |
La valeur par défaut est 8192 et sera suffisante pour la plupart des
|
|
Packit |
90a5c9 |
pages. Cependant, si vous savez que vous allez mandater des
|
|
Packit |
90a5c9 |
pages contenant des feuilles de style et/ou scripts plus grands que 8k
|
|
Packit |
90a5c9 |
(cette taille s'entend pour chaque script ou feuilles de style, non pour
|
|
Packit |
90a5c9 |
leur ensemble), il sera plus efficace de définir une taille de
|
|
Packit |
90a5c9 |
tampon initiale plus grande afin d'éviter d'avoir à le redimensionner
|
|
Packit |
90a5c9 |
dynamiquement au cours du traitement d'une requête.
|
|
Packit |
90a5c9 |
|
|
Packit |
90a5c9 |
|
|
Packit |
90a5c9 |
|
|
Packit |
90a5c9 |
|
|
Packit |
90a5c9 |
|
|
Packit |
90a5c9 |
|
|
Packit |
90a5c9 |
Description:Spécifie un jeu de caractères pour la sortie de
|
|
Packit |
90a5c9 |
mod_proxy_html.
|
|
Packit |
90a5c9 |
Syntaxe:ProxyHTMLCharsetOut jeu-de-caractères | *
|
|
Packit |
90a5c9 |
Contexte:configuration globale, serveur virtuel, répertoire
|
|
Packit |
90a5c9 |
Statut:Base
|
|
Packit |
90a5c9 |
Module:mod_proxy_html
|
|
Packit |
90a5c9 |
Compatibilité:Disponible depuis la version 2.4 du serveur HTTP Apache.
|
|
Packit |
90a5c9 |
Disponible en tant que module tiers dans les versions 2.x antérieures.
|
|
Packit |
90a5c9 |
|
|
Packit |
90a5c9 |
Cette directive permet de spécifier un jeu de caractères pour la
|
|
Packit |
90a5c9 |
sortie de mod_proxy_html. Elle ne devrait jamais être utilisée, car tout
|
|
Packit |
90a5c9 |
changement par rapport à la valeur par défaut UTF-8 (Unicode -
|
|
Packit |
90a5c9 |
utilisé en interne par libxml2) induit une charge supplémentaire de
|
|
Packit |
90a5c9 |
traitement. La définition spéciale ProxyHTMLCharsetOut *
|
|
Packit |
90a5c9 |
permet de générer une sortie qui utilisera le même encodage que
|
|
Packit |
90a5c9 |
l'entrée.
|
|
Packit |
90a5c9 |
Notez que tout ceci ne fonctionne que si le module
|
|
Packit |
90a5c9 |
mod_xml2enc est chargé.
|
|
Packit |
90a5c9 |
|
|
Packit |
90a5c9 |
|
|
Packit |
90a5c9 |
|
|
Packit |
90a5c9 |
|
|
Packit |
90a5c9 |
|
|
Packit |
90a5c9 |
Description:Définit une déclaration de type de document HTML ou XHTML.
|
|
Packit |
90a5c9 |
Syntaxe:ProxyHTMLDocType HTML|XHTML [Legacy]
OR
|
|
Packit |
90a5c9 |
ProxyHTMLDocType fpi [SGML|XML]
|
|
Packit |
90a5c9 |
Contexte:configuration globale, serveur virtuel, répertoire
|
|
Packit |
90a5c9 |
Statut:Base
|
|
Packit |
90a5c9 |
Module:mod_proxy_html
|
|
Packit |
90a5c9 |
Compatibilité:Disponible depuis la version 2.4 du serveur HTTP Apache.
|
|
Packit |
90a5c9 |
Disponible en tant que module tiers dans les versions 2.x antérieures.
|
|
Packit |
90a5c9 |
|
|
Packit |
90a5c9 |
Avec la première syntaxe, les documents seront déclarés de type HTML
|
|
Packit |
90a5c9 |
4.01 ou XHTML 1.0 selon l'option spécifiée. Cette option détermine aussi
|
|
Packit |
90a5c9 |
si la syntaxe utilisée en sortie est HTML ou XHTML. Notez que le format
|
|
Packit |
90a5c9 |
des documents en provenance du serveur d'arrière-plan n'est pas
|
|
Packit |
90a5c9 |
important, car l'interpréteur le détectera automatiquement. Si le
|
|
Packit |
90a5c9 |
second argument optionnel est défini à Legacy, les documents seront
|
|
Packit |
90a5c9 |
déclarés de type "Transitional" ; cette option peut être nécessaire si
|
|
Packit |
90a5c9 |
vous mandatez du contenu datant d'avant 1998, ou si vous travaillez avec
|
|
Packit |
90a5c9 |
des outils de création/publication déficients.
|
|
Packit |
90a5c9 |
Avec la deuxième syntaxe, cette directive vous permet d'insérer votre
|
|
Packit |
90a5c9 |
propre FPI (Formal Public Identifier). Le second argument optionnel
|
|
Packit |
90a5c9 |
détermine si la syntaxe utilisée sera SGML/HTML ou XML/XHTML.
|
|
Packit |
90a5c9 |
Par défaut, aucun FPI n'est inséré, étant donné qu'il vaut mieux pas
|
|
Packit |
90a5c9 |
de FPI du tout qu'un FPI bogué. Si par contre votre serveur d'arrière-plan
|
|
Packit |
90a5c9 |
génère du contenu HTML ou XHTML correct, vous pouvez définir cette
|
|
Packit |
90a5c9 |
directive en conséquence.
|
|
Packit |
90a5c9 |
Avec la première syntaxe, mod_proxy_html va aussi mettre le code HTML
|
|
Packit |
90a5c9 |
en conformité avec le standard spécifié. Il ne pourra pas corriger
|
|
Packit |
90a5c9 |
toutes les erreurs, mais il va supprimer les éléments et attributs non
|
|
Packit |
90a5c9 |
conformes. Il peut aussi journaliser les autres erreurs si la directive
|
|
Packit |
90a5c9 |
LogLevel est définie à
|
|
Packit |
90a5c9 |
Debug.
|
|
Packit |
90a5c9 |
|
|
Packit |
90a5c9 |
|
|
Packit |
90a5c9 |
|
|
Packit |
90a5c9 |
|
|
Packit |
90a5c9 |
|
|
Packit |
90a5c9 |
Description:Permet d'activer/désactiver le filtre proxy_html.
|
|
Packit |
90a5c9 |
Syntaxe:ProxyHTMLEnable On|Off
|
|
Packit |
90a5c9 |
Défaut:ProxyHTMLEnable Off
|
|
Packit |
90a5c9 |
Contexte:configuration globale, serveur virtuel, répertoire
|
|
Packit |
90a5c9 |
Statut:Base
|
|
Packit |
90a5c9 |
Module:mod_proxy_html
|
|
Packit |
90a5c9 |
Compatibilité:Disponible depuis la version 2.4 du serveur HTTP Apache.
|
|
Packit |
90a5c9 |
Disponible en tant que module tiers dans les versions 2.x antérieures.
|
|
Packit |
90a5c9 |
|
|
Packit |
90a5c9 |
Cette directive est un simple commutateur permettant
|
|
Packit |
90a5c9 |
d'activer/désactiver le filtre proxy_html. Si
|
|
Packit |
90a5c9 |
mod_xml2enc est chargé, elle va aussi activer
|
|
Packit |
90a5c9 |
automatiquement le support de l'internationalisation.
|
|
Packit |
90a5c9 |
Notez que le filtre proxy_html s'agira que si les données sont de
|
|
Packit |
90a5c9 |
type HTML (Content-Type text/html ou application/xhtml+xml), et si
|
|
Packit |
90a5c9 |
elles passent par un mandataire. Vous pouvez passer outre ces
|
|
Packit |
90a5c9 |
contraintes (à vos risques et périls) en définissant la variable
|
|
Packit |
90a5c9 |
d'environnement PROXY_HTML_FORCE.
|
|
Packit |
90a5c9 |
|
|
Packit |
90a5c9 |
|
|
Packit |
90a5c9 |
|
|
Packit |
90a5c9 |
|
|
Packit |
90a5c9 |
|
|
Packit |
90a5c9 |
Description:Spécifie les attributs à traiter comme des évènements de
|
|
Packit |
90a5c9 |
type scripting.
|
|
Packit |
90a5c9 |
Syntaxe:ProxyHTMLEvents attribut [attribut ...]
|
|
Packit |
90a5c9 |
Contexte:configuration globale, serveur virtuel, répertoire
|
|
Packit |
90a5c9 |
Statut:Base
|
|
Packit |
90a5c9 |
Module:mod_proxy_html
|
|
Packit |
90a5c9 |
Compatibilité:Disponible depuis la version 2.4 du serveur HTTP Apache.
|
|
Packit |
90a5c9 |
Disponible en tant que module tiers dans les versions 2.x antérieures.
|
|
Packit |
90a5c9 |
|
|
Packit |
90a5c9 |
Cette directive permet de spécifier un ou plusieurs attributs à
|
|
Packit |
90a5c9 |
traiter comme
|
|
Packit |
90a5c9 |
des évènements de type scripting et de leur appliquer les règles
|
|
Packit |
90a5c9 |
ProxyHTMLURLMap lorsqu'elles ont été définies. Vous
|
|
Packit |
90a5c9 |
pouvez spécifier un nombre quelconque d'attributs dans une ou plusieurs
|
|
Packit |
90a5c9 |
directives ProxyHTMLEvents.
|
|
Packit |
90a5c9 |
Normalement, cette directive est définie globalement. Si vous
|
|
Packit |
90a5c9 |
définissez ProxyHTMLEvents à plusieurs niveaux, certains niveaux
|
|
Packit |
90a5c9 |
l'emportant sur d'autres, vous devrez spécifier un jeu complet
|
|
Packit |
90a5c9 |
d'évènements pour chaque niveau.
|
|
Packit |
90a5c9 |
Le fichier proxy-html.conf fournit une configuration par
|
|
Packit |
90a5c9 |
défaut et définit les évènements selon les standards
|
|
Packit |
90a5c9 |
HTML 4 et XHTML 1.
|
|
Packit |
90a5c9 |
|
|
Packit |
90a5c9 |
|
|
Packit |
90a5c9 |
|
|
Packit |
90a5c9 |
|
|
Packit |
90a5c9 |
|
|
Packit |
90a5c9 |
Description:Détermine si l'on doit corriger les liens dans les scripts
|
|
Packit |
90a5c9 |
en ligne, les feuilles de style et les évènements de type scripting.
|
|
Packit |
90a5c9 |
Syntaxe:ProxyHTMLExtended On|Off
|
|
Packit |
90a5c9 |
Défaut:ProxyHTMLExtended Off
|
|
Packit |
90a5c9 |
Contexte:configuration globale, serveur virtuel, répertoire
|
|
Packit |
90a5c9 |
Statut:Base
|
|
Packit |
90a5c9 |
Module:mod_proxy_html
|
|
Packit |
90a5c9 |
Compatibilité:Disponible depuis la version 2.4 du serveur HTTP Apache.
|
|
Packit |
90a5c9 |
Disponible en tant que module tiers dans les versions 2.x antérieures.
|
|
Packit |
90a5c9 |
|
|
Packit |
90a5c9 |
Si cette directive est définie à Off, les liens HTML
|
|
Packit |
90a5c9 |
sont réécrits en fonction des directives
|
|
Packit |
90a5c9 |
ProxyHTMLURLMap, mais les liens qui apparaissent
|
|
Packit |
90a5c9 |
dans le code Javascript et les feuilles de style restent inchangés.
|
|
Packit |
90a5c9 |
Si elle est définie à On, tous les évènements de type
|
|
Packit |
90a5c9 |
scripting (définis par la directive
|
|
Packit |
90a5c9 |
ProxyHTMLEvents) et les scripts inclus ou les
|
|
Packit |
90a5c9 |
feuilles de style sont aussi
|
|
Packit |
90a5c9 |
traités par les règles ProxyHTMLURLMap, en
|
|
Packit |
90a5c9 |
fonction des drapeaux définis pour chacune d'entre elles. Ne définissez
|
|
Packit |
90a5c9 |
cette directive à On qu'en cas de nécessité absolue, car la
|
|
Packit |
90a5c9 |
charge supplémentaire induite impacte les performances.
|
|
Packit |
90a5c9 |
Vous devez aussi prêter attention aux modèles de comparaison, car
|
|
Packit |
90a5c9 |
l'interpréteur n'a aucune notion de la forme que pourrait prendre une URL dans un
|
|
Packit |
90a5c9 |
script embarqué ou une feuille de style. En particulier, la comparaison
|
|
Packit |
90a5c9 |
étendus du caractère / a de fortes chances d'induire des
|
|
Packit |
90a5c9 |
correspondances erronées.
|
|
Packit |
90a5c9 |
|
|
Packit |
90a5c9 |
|
|
Packit |
90a5c9 |
|
|
Packit |
90a5c9 |
|
|
Packit |
90a5c9 |
|
|
Packit |
90a5c9 |
Description:Corrige les erreurs HTML simples.
|
|
Packit |
90a5c9 |
Syntaxe:ProxyHTMLFixups [lowercase] [dospath] [reset]
|
|
Packit |
90a5c9 |
Contexte:configuration globale, serveur virtuel, répertoire
|
|
Packit |
90a5c9 |
Statut:Base
|
|
Packit |
90a5c9 |
Module:mod_proxy_html
|
|
Packit |
90a5c9 |
Compatibilité:Disponible depuis la version 2.4 du serveur HTTP Apache.
|
|
Packit |
90a5c9 |
Disponible en tant que module tiers dans les versions 2.x antérieures.
|
|
Packit |
90a5c9 |
|
|
Packit |
90a5c9 |
Cette directive accepte un à trois arguments parmi les suivants :
|
|
Packit |
90a5c9 |
|
|
Packit |
90a5c9 |
lowercaseLes Urls sont réécrites en minuscules
|
|
Packit |
90a5c9 |
dospathLes slashes inversés dans les URLs sont
|
|
Packit |
90a5c9 |
remplacés par des slashes directs.
|
|
Packit |
90a5c9 |
resetAnnule toute option définie à un niveau supérieur
|
|
Packit |
90a5c9 |
dans la configuration
|
|
Packit |
90a5c9 |
|
|
Packit |
90a5c9 |
Cette directive doit être utilisée avec prudence. Elle peut corriger
|
|
Packit |
90a5c9 |
certaines erreurs de création, mais risque aussi de modifier par erreur
|
|
Packit |
90a5c9 |
des liens corrects. Ne l'utilisez que si vous êtes sûr que le serveur
|
|
Packit |
90a5c9 |
d'arrière-plan est déficient.
|
|
Packit |
90a5c9 |
|
|
Packit |
90a5c9 |
|
|
Packit |
90a5c9 |
|
|
Packit |
90a5c9 |
|
|
Packit |
90a5c9 |
|
|
Packit |
90a5c9 |
Description:Active la réinterprétation des règles
|
|
Packit |
90a5c9 |
ProxyHTMLURLMap pour chaque requête.
|
|
Packit |
90a5c9 |
Syntaxe:ProxyHTMLInterp On|Off
|
|
Packit |
90a5c9 |
Défaut:ProxyHTMLInterp Off
|
|
Packit |
90a5c9 |
Contexte:configuration globale, serveur virtuel, répertoire
|
|
Packit |
90a5c9 |
Statut:Base
|
|
Packit |
90a5c9 |
Module:mod_proxy_html
|
|
Packit |
90a5c9 |
Compatibilité:Disponible depuis la version 2.4 du serveur HTTP Apache.
|
|
Packit |
90a5c9 |
Disponible en tant que module tiers dans les versions 2.x antérieures.
|
|
Packit |
90a5c9 |
|
|
Packit |
90a5c9 |
Cette directive permet d'activer le réinterprétation pour chaque
|
|
Packit |
90a5c9 |
requête des modèles source et cible de la directive
|
|
Packit |
90a5c9 |
ProxyHTMLURLMap.
|
|
Packit |
90a5c9 |
Si la réinterprétation n'est pas activée, toutes les règles sont
|
|
Packit |
90a5c9 |
précompilées au démarrage du serveur. Si elle est activée, les
|
|
Packit |
90a5c9 |
règles doivent être recompilées pour chaque requête, ce qui induit
|
|
Packit |
90a5c9 |
une charge de traitement supplémentaire. Elle ne doit donc être activée que si
|
|
Packit |
90a5c9 |
cela s'avère nécessaire.
|
|
Packit |
90a5c9 |
|
|
Packit |
90a5c9 |
|
|
Packit |
90a5c9 |
|
|
Packit |
90a5c9 |
|
|
Packit |
90a5c9 |
|
|
Packit |
90a5c9 |
Description:Spécifie les éléments HTML dont les attributs d'URL doivent
|
|
Packit |
90a5c9 |
être réécrits.
|
|
Packit |
90a5c9 |
Syntaxe:ProxyHTMLLinks élément attribut [attribut2 ...]
|
|
Packit |
90a5c9 |
Contexte:configuration globale, serveur virtuel, répertoire
|
|
Packit |
90a5c9 |
Statut:Base
|
|
Packit |
90a5c9 |
Module:mod_proxy_html
|
|
Packit |
90a5c9 |
Compatibilité:Disponible depuis la version 2.4 du serveur HTTP Apache.
|
|
Packit |
90a5c9 |
Disponible en tant que module tiers dans les versions 2.x antérieures.
|
|
Packit |
90a5c9 |
|
|
Packit |
90a5c9 |
Cette directive permet de spécifier les éléments dont les attributs d'URL
|
|
Packit |
90a5c9 |
doivent être réécrits en utilisant les règles standards ProxyHTMLURLMap. Vous devez définir une
|
|
Packit |
90a5c9 |
directive ProxyHTMLLinks pour chaque élément, mais chacune d'entre elles peut
|
|
Packit |
90a5c9 |
spécifier un nombre quelconque d'attributs Normalement, cette directive
|
|
Packit |
90a5c9 |
est définie globalement. Si vous définissez ProxyHTMLLinks à plusieurs niveaux,
|
|
Packit |
90a5c9 |
certains niveaux l'emportant sur d'autres, vous devrez spécifier un jeu complet
|
|
Packit |
90a5c9 |
de liens pour chaque niveau. Le fichier proxy-html.conf
|
|
Packit |
90a5c9 |
fournit une configuration par défaut et définit les liens HTML selon les
|
|
Packit |
90a5c9 |
standards HTML 4 et XHTML 1.
|
|
Packit |
90a5c9 |
Exemples issus de proxy-html.confProxyHTMLLinks a href
|
|
Packit |
90a5c9 |
ProxyHTMLLinks area href
|
|
Packit |
90a5c9 |
ProxyHTMLLinks link href
|
|
Packit |
90a5c9 |
ProxyHTMLLinks img src longdesc usemap
|
|
Packit |
90a5c9 |
ProxyHTMLLinks object classid codebase data usemap
|
|
Packit |
90a5c9 |
ProxyHTMLLinks q cite
|
|
Packit |
90a5c9 |
ProxyHTMLLinks blockquote cite
|
|
Packit |
90a5c9 |
ProxyHTMLLinks ins cite
|
|
Packit |
90a5c9 |
ProxyHTMLLinks del cite
|
|
Packit |
90a5c9 |
ProxyHTMLLinks form action
|
|
Packit |
90a5c9 |
ProxyHTMLLinks input src usemap
|
|
Packit |
90a5c9 |
ProxyHTMLLinks head profile
|
|
Packit |
90a5c9 |
ProxyHTMLLinks base href
|
|
Packit |
90a5c9 |
ProxyHTMLLinks script src for
|
|
Packit |
90a5c9 |
|
|
Packit |
90a5c9 |
|
|
Packit |
90a5c9 |
|
|
Packit |
90a5c9 |
|
|
Packit |
90a5c9 |
|
|
Packit |
90a5c9 |
|
|
Packit |
90a5c9 |
Description:Active ou désactive une préinterprétation supplémentaire
|
|
Packit |
90a5c9 |
des métadonnées dans les sections HTML <head>.
|
|
Packit |
90a5c9 |
Syntaxe:ProxyHTMLMeta On|Off
|
|
Packit |
90a5c9 |
Défaut:ProxyHTMLMeta Off
|
|
Packit |
90a5c9 |
Contexte:configuration globale, serveur virtuel, répertoire
|
|
Packit |
90a5c9 |
Statut:Base
|
|
Packit |
90a5c9 |
Module:mod_proxy_html
|
|
Packit |
90a5c9 |
Compatibilité:Disponible à partir de la version 2.4 du serveur HTTP
|
|
Packit |
90a5c9 |
Apache ; proposé en tant que module tiers dans les versions 2.x
|
|
Packit |
90a5c9 |
précédentes.
|
|
Packit |
90a5c9 |
|
|
Packit |
90a5c9 |
Cette directive permet d'activer ou désactiver une
|
|
Packit |
90a5c9 |
préinterprétation supplémentaire des métadonnées dans les sections
|
|
Packit |
90a5c9 |
HTML <head>. Si cette préinterprétation n'est pas
|
|
Packit |
90a5c9 |
requise, définissez ProxyHTMLMeta à Off et les performances
|
|
Packit |
90a5c9 |
seront légèrement améliorées. Cependant, elle s'avère parfois
|
|
Packit |
90a5c9 |
nécessaire pour assurer un fonctionnement correct de l'internationalisation.
|
|
Packit |
90a5c9 |
La directive ProxyHTMLMeta a deux effets. Le premier et le plus
|
|
Packit |
90a5c9 |
important est la détection des codages de caractères déclarés sous
|
|
Packit |
90a5c9 |
la forme
|
|
Packit |
90a5c9 |
<meta http-equiv="Content-Type" content="text/html;charset=foo">
|
|
Packit |
90a5c9 |
ou, dans le cas d'un document XHTML, sous la forme d'une
|
|
Packit |
90a5c9 |
déclaration XML. Elle n'est pas nécessaire si le jeu de caractères
|
|
Packit |
90a5c9 |
est déclaré explicitement dans un en-tête HTTP (ce qui est
|
|
Packit |
90a5c9 |
préférable) en provenance du serveur d'arrière-plan, ou si le
|
|
Packit |
90a5c9 |
document est en utf-8 (unicode) ou un de ses
|
|
Packit |
90a5c9 |
sous-ensembles comme ASCII. Vous pourrez aussi vous en passer
|
|
Packit |
90a5c9 |
lorsque le document utilise une valeur par défaut déclarée via la
|
|
Packit |
90a5c9 |
directive xml2EncDefault, avec le risque de
|
|
Packit |
90a5c9 |
propager une déclaration incorrecte. Une directive
|
|
Packit |
90a5c9 |
ProxyHTMLCharsetOut permettra d'annuler ce
|
|
Packit |
90a5c9 |
risque, mais pourra induire une surcharge de traitement supérieure à
|
|
Packit |
90a5c9 |
celle de ProxyHTMLMeta.
|
|
Packit |
90a5c9 |
Le deuxième effet est l'interprétation de toutes les déclarations
|
|
Packit |
90a5c9 |
<meta http-equiv=...> et leur conversion en
|
|
Packit |
90a5c9 |
en-têtes HTTP, afin de conserver le but original de cette forme
|
|
Packit |
90a5c9 |
de métaélément HTML.
|
|
Packit |
90a5c9 |
|
|
Packit |
90a5c9 |
Avertissement Compte tenu du fait que la
|
|
Packit |
90a5c9 |
directive ProxyHTMLMeta promeut tous les éléments
|
|
Packit |
90a5c9 |
http-equiv au rang d'en-têtes HTTP, il est conseillé de ne
|
|
Packit |
90a5c9 |
l'activer que si vous faites autant confiance au contenu HTML qu'à votre
|
|
Packit |
90a5c9 |
serveur mandataire. Avec cette directive en effet, si ce contenu est géré
|
|
Packit |
90a5c9 |
par des gens malintentionnés, ces derniers seront en mesure d'injecter des
|
|
Packit |
90a5c9 |
en-têtes HTTP arbitraires et peut-être malveillants dans les réponses de
|
|
Packit |
90a5c9 |
votre serveur.
|
|
Packit |
90a5c9 |
|
|
Packit |
90a5c9 |
|
|
Packit |
90a5c9 |
|
|
Packit |
90a5c9 |
|
|
Packit |
90a5c9 |
|
|
Packit |
90a5c9 |
|
|
Packit |
90a5c9 |
Description:Détermine si les commentaires HTML doivent être supprimés.
|
|
Packit |
90a5c9 |
Syntaxe:ProxyHTMLStripComments On|Off
|
|
Packit |
90a5c9 |
Défaut:ProxyHTMLStripComments Off
|
|
Packit |
90a5c9 |
Contexte:configuration globale, serveur virtuel, répertoire
|
|
Packit |
90a5c9 |
Statut:Base
|
|
Packit |
90a5c9 |
Module:mod_proxy_html
|
|
Packit |
90a5c9 |
Compatibilité:Disponible depuis la version 2.4 du serveur HTTP Apache.
|
|
Packit |
90a5c9 |
Disponible en tant que module tiers dans les versions 2.x antérieures.
|
|
Packit |
90a5c9 |
|
|
Packit |
90a5c9 |
Si cette directive est définie à On, mod_proxy_html
|
|
Packit |
90a5c9 |
supprimera les commentaires HTML. Notez que cela supprimera aussi tout
|
|
Packit |
90a5c9 |
script ou style inclus dans les commentaires (une monstruosité
|
|
Packit |
90a5c9 |
introduite en 1995/1996 avec Netscape 2 pour les navigateurs plus
|
|
Packit |
90a5c9 |
anciens, et encore utilisée de nos jours). Cette directive peut aussi
|
|
Packit |
90a5c9 |
interférer avec des processeurs basés sur les commentaires comme SSI ou
|
|
Packit |
90a5c9 |
ESI : assurez-vous d'exécuter ces derniers avant mod_proxy_html
|
|
Packit |
90a5c9 |
dans la chaîne de filtrage si vous supprimez les commentaires !
|
|
Packit |
90a5c9 |
|
|
Packit |
90a5c9 |
|
|
Packit |
90a5c9 |
|
|
Packit |
90a5c9 |
|
|
Packit |
90a5c9 |
|
|
Packit |
90a5c9 |
Description:Définit une règle de réécriture des liens HTML
|
|
Packit |
90a5c9 |
Syntaxe:ProxyHTMLURLMap modèle-source modèle-cible [drapeaux] [cond]
|
|
Packit |
90a5c9 |
Contexte:configuration globale, serveur virtuel, répertoire
|
|
Packit |
90a5c9 |
Statut:Base
|
|
Packit |
90a5c9 |
Module:mod_proxy_html
|
|
Packit |
90a5c9 |
Compatibilité:Disponible depuis la version 2.4 du serveur HTTP Apache.
|
|
Packit |
90a5c9 |
Disponible en tant que module tiers dans les versions 2.x antérieures.
|
|
Packit |
90a5c9 |
|
|
Packit |
90a5c9 |
Il s'agit de la directive la plus importante pour la réécriture des
|
|
Packit |
90a5c9 |
liens HTML. Lors de l'interprétation d'un document, chaque fois qu'un
|
|
Packit |
90a5c9 |
lien correspond à modèle-source, la partie du lien concernée
|
|
Packit |
90a5c9 |
sera réécrite en modèle-cible, en tenant compte des
|
|
Packit |
90a5c9 |
modifications induites par les drapeaux éventuellement spécifiés et par
|
|
Packit |
90a5c9 |
la directive ProxyHTMLExtended.
|
|
Packit |
90a5c9 |
Ne seront considérés comme des liens HTML que les éléments spécifiés via la
|
|
Packit |
90a5c9 |
directive ProxyHTMLLinks.
|
|
Packit |
90a5c9 |
|
|
Packit |
90a5c9 |
Le troisième argument optionnel permet de définir un des drapeaux
|
|
Packit |
90a5c9 |
suivants (les drapeaux sont sensibles à la casse) :
|
|
Packit |
90a5c9 |
|
|
Packit |
90a5c9 |
h
|
|
Packit |
90a5c9 |
Ignore les liens HTML (les traverse sans les modifier)
|
|
Packit |
90a5c9 |
e
|
|
Packit |
90a5c9 |
Ignore les évènements de scripting (les traverse sans les
|
|
Packit |
90a5c9 |
modifier)
|
|
Packit |
90a5c9 |
c
|
|
Packit |
90a5c9 |
Traverse les sections de type style ou script sans les modifier.
|
|
Packit |
90a5c9 |
|
|
Packit |
90a5c9 |
L
|
|
Packit |
90a5c9 |
Last-match. Si cette règle s'applique, aucune autre règle ne sera
|
|
Packit |
90a5c9 |
prise en compte (notez qu'il s'agit du comportement automatique pour les
|
|
Packit |
90a5c9 |
liens HTML).
|
|
Packit |
90a5c9 |
l
|
|
Packit |
90a5c9 |
L'opposé de L. Passe outre le comportement par défaut du
|
|
Packit |
90a5c9 |
changement unique pour les liens HTML.
|
|
Packit |
90a5c9 |
R
|
|
Packit |
90a5c9 |
Utilise des expressions rationnelles pour les modèles.
|
|
Packit |
90a5c9 |
modèle-source est une expression rationnelle, et
|
|
Packit |
90a5c9 |
modèle-cible une chaîne de remplacement qui peut être basée
|
|
Packit |
90a5c9 |
elle aussi sur une expression rationnelle. La mémorisation dans les
|
|
Packit |
90a5c9 |
expressions rationnelles est supportée : vous pouvez utiliser des
|
|
Packit |
90a5c9 |
parenthèses () dans le modèle-source, et récupérer la
|
|
Packit |
90a5c9 |
correspondance de leur contenu via les variables $1 à $9 dans le
|
|
Packit |
90a5c9 |
modèle-cible.
|
|
Packit |
90a5c9 |
|
|
Packit |
90a5c9 |
Si le drapeau R n'est pas fourni, la directive utilisera des chaînes
|
|
Packit |
90a5c9 |
littérales pour les différents modèles de recherche/remplacement. La
|
|
Packit |
90a5c9 |
logique de recherche est "commence par" dans les liens HTML, et
|
|
Packit |
90a5c9 |
"contient" dans les évènements de scripting et les sections de
|
|
Packit |
90a5c9 |
type style ou script.
|
|
Packit |
90a5c9 |
|
|
Packit |
90a5c9 |
|
|
Packit |
90a5c9 |
x
|
|
Packit |
90a5c9 |
Utilise les expressions rationnelles étendues POSIX. Ne
|
|
Packit |
90a5c9 |
s'applique qu'avec R.
|
|
Packit |
90a5c9 |
i
|
|
Packit |
90a5c9 |
Recherche de correspondance sensible à la casse. Ne
|
|
Packit |
90a5c9 |
s'applique qu'avec R.
|
|
Packit |
90a5c9 |
|
|
Packit |
90a5c9 |
n
|
|
Packit |
90a5c9 |
Désactive la mémorisation dans les expressions rationnelles (pour
|
|
Packit |
90a5c9 |
améliorer les performances). Ne s'applique qu'avec R.
|
|
Packit |
90a5c9 |
s
|
|
Packit |
90a5c9 |
Recherche de correspondance dans les expressions rationnelles
|
|
Packit |
90a5c9 |
basée sur la ligne. Ne s'applique qu'avec R.
|
|
Packit |
90a5c9 |
^
|
|
Packit |
90a5c9 |
Recherche de correspondance au début seulement. Ne concerne que
|
|
Packit |
90a5c9 |
les recherches de correspondance par rapport à des chaînes, et ne
|
|
Packit |
90a5c9 |
s'applique pas aux liens HTML.
|
|
Packit |
90a5c9 |
$
|
|
Packit |
90a5c9 |
Recherche de correspondance à la fin seulement. Ne concerne que
|
|
Packit |
90a5c9 |
les recherches de correspondance par rapport à des chaînes, et ne
|
|
Packit |
90a5c9 |
s'applique pas aux liens HTML.
|
|
Packit |
90a5c9 |
V
|
|
Packit |
90a5c9 |
Insère des variables d'environnement dans le
|
|
Packit |
90a5c9 |
modèle-cible. Un modèle-cible de la forme
|
|
Packit |
90a5c9 |
${varname|default} sera remplacé par la valeur de la
|
|
Packit |
90a5c9 |
variable d'environnement varname. Si cette dernière n'est
|
|
Packit |
90a5c9 |
pas définie, modèle-cible sera remplacé par
|
|
Packit |
90a5c9 |
default. La spécification de |default est
|
|
Packit |
90a5c9 |
facultative.
|
|
Packit |
90a5c9 |
NOTE: l'insertion de variables d'environnement n'est possible que si
|
|
Packit |
90a5c9 |
la directive ProxyHTMLInterp a été définie à
|
|
Packit |
90a5c9 |
On.
|
|
Packit |
90a5c9 |
|
|
Packit |
90a5c9 |
|
|
Packit |
90a5c9 |
v
|
|
Packit |
90a5c9 |
Insère des variables d'environnement dans le
|
|
Packit |
90a5c9 |
modèle-source. La syntaxe du modèle est identique à la
|
|
Packit |
90a5c9 |
syntaxe précédente.
|
|
Packit |
90a5c9 |
NOTE: l'insertion de variables d'environnement n'est possible que si
|
|
Packit |
90a5c9 |
la directive ProxyHTMLInterp a été définie à
|
|
Packit |
90a5c9 |
On.
|
|
Packit |
90a5c9 |
|
|
Packit |
90a5c9 |
|
|
Packit |
90a5c9 |
|
|
Packit |
90a5c9 |
Le quatrième argument optionnel cond définit une
|
|
Packit |
90a5c9 |
condition qui sera évaluée pour chaque requête, sous réserve que la
|
|
Packit |
90a5c9 |
directive ProxyHTMLInterp ait été définie à
|
|
Packit |
90a5c9 |
On. Si la condition est évaluée à FALSE, la règle ne sera pas
|
|
Packit |
90a5c9 |
appliquée à la requête. Si elle est évaluée à TRUE, ou si aucune
|
|
Packit |
90a5c9 |
condition n'est définie, la règle s'applique.
|
|
Packit |
90a5c9 |
La condition est évaluée par l'interpréteur d'expression. La syntaxe simple des
|
|
Packit |
90a5c9 |
conditions dans mod_proxy_html 3.x pour HTTPD 2.0 et 2.2 est aussi
|
|
Packit |
90a5c9 |
supportée.
|
|
Packit |
90a5c9 |
|
|
Packit |
90a5c9 |
|
|
Packit |
90a5c9 |
|
|
Packit |
90a5c9 |
|
|
Packit |
90a5c9 |
Langues Disponibles: en |
|
|
Packit |
90a5c9 |
fr
|
|
Packit |
90a5c9 |
Notice:This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed again by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Freenode, or sent to our mailing lists.
|
|
Packit |
90a5c9 |
<script type="text/javascript">
|
|
Packit |
90a5c9 |
var comments_shortname = 'httpd';
|
|
Packit |
90a5c9 |
var comments_identifier = 'http://httpd.apache.org/docs/2.4/mod/mod_proxy_html.html';
|
|
Packit |
90a5c9 |
(function(w, d) {
|
|
Packit |
90a5c9 |
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
|
|
Packit |
90a5c9 |
d.write('
|
|
Packit |
90a5c9 |
var s = d.createElement('script');
|
|
Packit |
90a5c9 |
s.type = 'text/javascript';
|
|
Packit |
90a5c9 |
s.async = true;
|
|
Packit |
90a5c9 |
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
|
|
Packit |
90a5c9 |
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
|
|
Packit |
90a5c9 |
}
|
|
Packit |
90a5c9 |
else {
|
|
Packit |
90a5c9 |
d.write('
|
|
Packit |
90a5c9 |
}
|
|
Packit |
90a5c9 |
})(window, document);
|
|
Packit |
90a5c9 |
//--></script>
|
|
Packit |
90a5c9 |
Copyright 2018 The Apache Software Foundation.
Autorisé sous Apache License, Version 2.0.
|
|
Packit |
90a5c9 |
Modules | Directives | FAQ | Glossaire | Plan du site <script type="text/javascript">
|
|
Packit |
90a5c9 |
if (typeof(prettyPrint) !== 'undefined') {
|
|
Packit |
90a5c9 |
prettyPrint();
|
|
Packit |
90a5c9 |
}
|
|
Packit |
90a5c9 |
//--></script>
|
|
Packit |
90a5c9 |
</body></html>
|
