mirror of
https://github.com/apache/httpd.git
synced 2025-07-07 09:41:11 +03:00
git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@1828650 13f79535-47bb-0310-9956-ffa450edef68
633 lines
44 KiB
Plaintext
633 lines
44 KiB
Plaintext
<?xml version="1.0" encoding="ISO-8859-1"?>
|
||
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
|
||
<html xmlns="http://www.w3.org/1999/xhtml" lang="fr" xml:lang="fr"><head>
|
||
<meta content="text/html; charset=ISO-8859-1" http-equiv="Content-Type" />
|
||
<!--
|
||
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
|
||
This file is generated from xml source: DO NOT EDIT
|
||
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
|
||
-->
|
||
<title>mod_proxy_html - Serveur Apache HTTP Version 2.5</title>
|
||
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" />
|
||
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" />
|
||
<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" />
|
||
<script src="../style/scripts/prettify.min.js" type="text/javascript">
|
||
</script>
|
||
|
||
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
|
||
<body>
|
||
<div id="page-header">
|
||
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p>
|
||
<p class="apache">Serveur Apache HTTP Version 2.5</p>
|
||
<img alt="" src="../images/feather.png" /></div>
|
||
<div class="up"><a href="./"><img title="<-" alt="<-" src="../images/left.gif" /></a></div>
|
||
<div id="path">
|
||
<a href="http://www.apache.org/">Apache</a> > <a href="http://httpd.apache.org/">Serveur HTTP</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.5</a> > <a href="./">Modules</a></div>
|
||
<div id="page-content">
|
||
<div id="preamble"><h1>Module Apache mod_proxy_html</h1>
|
||
<div class="toplang">
|
||
<p><span>Langues Disponibles: </span><a href="../en/mod/mod_proxy_html.html" hreflang="en" rel="alternate" title="English"> en </a> |
|
||
<a href="../fr/mod/mod_proxy_html.html" title="Fran<61>ais"> fr </a></p>
|
||
</div>
|
||
<table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>R<><52>crit les liens HTML afin de s'assurer qu'ils soient bien
|
||
adressables depuis les r<>seaux des clients dans un contexte de
|
||
mandataire.</td></tr>
|
||
<tr><th><a href="module-dict.html#Status">Statut:</a></th><td>Base</td></tr>
|
||
<tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur<75>de<64>Module:</a></th><td>proxy_html_module</td></tr>
|
||
<tr><th><a href="module-dict.html#SourceFile">Fichier<65>Source:</a></th><td>mod_proxy_html.c</td></tr>
|
||
<tr><th><a href="module-dict.html#Compatibility">Compatibilit<69>:</a></th><td>Disponible depuis la version 2.4 du serveur HTTP Apache.
|
||
Disponible en tant que module tiers dans les versions 2.x ant<6E>rieures</td></tr></table>
|
||
<h3>Sommaire</h3>
|
||
|
||
<p>Ce module fournit un filtre en sortie permettant de r<><72>crire les
|
||
liens HTML dans un contexte de mandataire, afin de s'assurer que ces
|
||
liens fonctionnent pour les utilisateurs en dehors du mandataire. Il
|
||
accomplit la m<>me t<>che que la directive ProxyPassReverse d'Apache
|
||
accomplit pour les en-t<>tes HTTP, et fait partie des composants
|
||
essentiels d'un mandataire inverse.</p>
|
||
|
||
<p>Par exemple, si une entreprise poss<73>de un serveur d'applications
|
||
nomm<EFBFBD> appserver.example.com qui n'est visible que depuis son r<>seau
|
||
interne, et un serveur web public <code>www.example.com</code>, il peut
|
||
<EFBFBD>tre souhaitable de fournir une passerelle vers le serveur d'application
|
||
<EFBFBD> l'adresse <code>http://www.example.com/appserver/</code>. Lorsque le
|
||
serveur d'applications pr<70>sente un lien vers lui-m<>me, ce lien doit <20>tre
|
||
r<EFBFBD><EFBFBD>crit pour fonctionner <20> travers la passerelle. A cet effet,
|
||
mod_proxy_html permet de r<><72>crire <code><a
|
||
href="http://appserver.example.com/foo/bar.html">foobar</a></code>
|
||
en <code><a
|
||
href="http://www.example.com/appserver/foo/bar.html">foobar</a></code>,
|
||
ce qui permet de rendre le serveur d'applications accessible depuis
|
||
l'ext<78>rieur.</p>
|
||
</div>
|
||
<div id="quickview"><h3>Sujets</h3>
|
||
<ul id="topics">
|
||
<li><img alt="" src="../images/down.gif" /> <a href="#intro">Introduction</a></li>
|
||
<li><img alt="" src="../images/down.gif" /> <a href="#custom">Interpr<70>tation HTML personnalis<69>e</a></li>
|
||
<li><img alt="" src="../images/down.gif" /> <a href="#i18n">Internationalisation</a></li>
|
||
</ul><h3 class="directives">Directives</h3>
|
||
<ul id="toc">
|
||
<li><img alt="" src="../images/down.gif" /> <a href="#proxyhtmlbufsize">ProxyHTMLBufSize</a></li>
|
||
<li><img alt="" src="../images/down.gif" /> <a href="#proxyhtmlcharsetout">ProxyHTMLCharsetOut</a></li>
|
||
<li><img alt="" src="../images/down.gif" /> <a href="#proxyhtmldoctype">ProxyHTMLDocType</a></li>
|
||
<li><img alt="" src="../images/down.gif" /> <a href="#proxyhtmlenable">ProxyHTMLEnable</a></li>
|
||
<li><img alt="" src="../images/down.gif" /> <a href="#proxyhtmlevents">ProxyHTMLEvents</a></li>
|
||
<li><img alt="" src="../images/down.gif" /> <a href="#proxyhtmlextended">ProxyHTMLExtended</a></li>
|
||
<li><img alt="" src="../images/down.gif" /> <a href="#proxyhtmlfixups">ProxyHTMLFixups</a></li>
|
||
<li><img alt="" src="../images/down.gif" /> <a href="#proxyhtmlinterp">ProxyHTMLInterp</a></li>
|
||
<li><img alt="" src="../images/down.gif" /> <a href="#proxyhtmllinks">ProxyHTMLLinks</a></li>
|
||
<li><img alt="" src="../images/down.gif" /> <a href="#proxyhtmlmeta">ProxyHTMLMeta</a></li>
|
||
<li><img alt="" src="../images/down.gif" /> <a href="#proxyhtmlstripcomments">ProxyHTMLStripComments</a></li>
|
||
<li><img alt="" src="../images/down.gif" /> <a href="#proxyhtmlurlmap">ProxyHTMLURLMap</a></li>
|
||
</ul>
|
||
<h3>Traitement des bugs</h3><ul class="seealso"><li><a href="https://www.apache.org/dist/httpd/CHANGES_2.4">Journal des modifications de httpd</a></li><li><a href="https://bz.apache.org/bugzilla/buglist.cgi?bug_status=__open__&list_id=144532&product=Apache%20httpd-2&query_format=specific&order=changeddate%20DESC%2Cpriority%2Cbug_severity&component=mod_proxy_html">Probl<62>mes connus</a></li><li><a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2&component=mod_proxy_html">Signaler un bug</a></li></ul><h3>Voir aussi</h3>
|
||
<ul class="seealso">
|
||
<li><a href="#comments_section">Commentaires</a></li></ul></div>
|
||
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
|
||
<div class="section">
|
||
<h2><a name="intro" id="intro">Introduction</a><a title="Lien permanent" href="#intro" class="permalink">¶</a></h2>
|
||
<p>mod_proxy_html est apparu en tant que module tiers avec les versions 2.0.x du
|
||
serveur HTTP Apache. Il a ensuite <20>t<EFBFBD> donn<6E> <20> l'ASF en 2011 avec le module
|
||
<code class="module"><a href="../mod/mod_xml2enc.html">mod_xml2enc</a></code> (voir <a href="#i18n">Internationalisation</a>), et
|
||
fait maintenant partie des modules standards de HTTPD 2.4 et de ses versions de
|
||
d<EFBFBD>veloppement.</p>
|
||
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
|
||
<div class="section">
|
||
<h2><a name="custom" id="custom">Interpr<70>tation HTML personnalis<69>e</a><a title="Lien permanent" href="#custom" class="permalink">¶</a></h2>
|
||
<p>mod_proxy_html utilise en interne le module HTMLParser fourni par la
|
||
biblioth<EFBFBD>que tierce <a href="http://xmlsoft.org/">libxml2</a>. A la diff<66>rence
|
||
des autres interpr<70>teurs libxml2, HTMLParser traite les documents HTML sans
|
||
imposer <20> ces derniers d'<27>tre bien form<72>s du point de vue XML. En particulier,
|
||
il sait g<>rer les tags implicites - comme le </p> fermant - et les ins<6E>re
|
||
dans le flux des <20>v<EFBFBD>nements SAX utilis<69> par mod_proxy_html. Il poss<73>de aussi une
|
||
connaissance explicite des standards HTML 4 et XHTML 1 du W3C, et peut en
|
||
corriger certaines erreurs.</p>
|
||
<p>mod_proxy_html offre toute une panoplie d'options permettant de contr<74>ler
|
||
l'interpr<70>tation du code HTML. La correction d'erreur peut <20>tre activ<69>e (selon
|
||
votre choix de standard HTML) ou d<>sactiv<69>e via la directive
|
||
<code class="directive">ProxyHTMLDocType</code>. Et <20> la demande g<>n<EFBFBD>rale, il peut <20>tre
|
||
configur<EFBFBD> pour traiter les <20>l<EFBFBD>ments et attributs non standards en tant que liens
|
||
qui devront peut-<2D>tre <20>tre r<><72>crits, et pour r<><72>crire les liens dans les contenus
|
||
embarqu<EFBFBD>s non-HTML (feuilles de style et scripts). Notez que ce module ne
|
||
convient pas pour traiter les feuilles de style ou scripts externes ; pour ces
|
||
derniers, vous devez utiliser un autre interpr<70>teur comme
|
||
<code class="module"><a href="../mod/mod_substitute.html">mod_substitute</a></code> ou <code class="module"><a href="../mod/mod_sed.html">mod_sed</a></code>. Les principales
|
||
directives permettant de personnaliser l'interpr<70>tation du code HTML sont
|
||
<code class="directive">ProxyHTMLLinks</code> et <code class="directive">ProxyHTMLEvents</code>.
|
||
Par d<>faut, elles sont d<>finies dans le fichier de configuration
|
||
<var>proxy-html.conf</var> qui contient aussi des commentaires pour vous aider <20>
|
||
personnaliser votre interpr<70>teur si n<>cessaire. </p>
|
||
<div class="note">Pour des raisons historiques, configurer mod_proxy_html pour r<><72>crire les
|
||
URLs dans les <20>v<EFBFBD>nements de scripting n'entra<72>ne pas par d<>faut la r<><72>criture des
|
||
URLs dans les feuilles de style. Ce comportement peut <20>tre modifi<66> en
|
||
d<EFBFBD>commentant la ligne correspondante du fichier <var>proxy-html.conf</var> comme
|
||
indiqu<EFBFBD> dans la documentation que contient ce dernier.</div>
|
||
|
||
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
|
||
<div class="section">
|
||
<h2><a name="i18n" id="i18n">Internationalisation</a><a title="Lien permanent" href="#i18n" class="permalink">¶</a></h2>
|
||
<p>mod_proxy_html utilise en interne un interpr<70>teur HTML intelligent fourni par
|
||
la biblioth<74>que tierce <a href="http://xmlsoft.org/">libxml2</a>. L'interpr<70>teur
|
||
utilise Unicode (UTF-8) en interne. Ceci complexifie la gestion
|
||
des autres encodages n<>cessaires pour traiter de nombreux sites web dont le
|
||
langage est autre que l'anglais. Si ce traitement n'est pas effectu<74>
|
||
de mani<6E>re appropri<72>e, les sites web qui utilisent des caract<63>res non-ASCII dans un
|
||
codage autre que UTF-8 (Unicode) ne s'afficheront pas correctement.</p>
|
||
<p>Entre sa premi<6D>re version en 2003 et sa donnation <20> Apache en 2011, le
|
||
support de l'internationalisation (i18n) est parti de rien pour arriver <20> une
|
||
structure sophistiqu<71>e capable d'appliquer des r<>gles issues de HTTP, HTML et
|
||
XML pour d<>tecter le codage d'un document et ainsi le traiter correctement. Ce
|
||
traitement <20>tait cependant commun <20> mod_proxy_html et <20> d'autres modules
|
||
utilisant libxml2, et plut<75>t que de le maintenir au niveau de chacun de ces
|
||
modules, il parut sens<6E> de l'extraire de ces derniers pour en faire
|
||
un module <20> part enti<74>re. Ce module est <code class="module"><a href="../mod/mod_xml2enc.html">mod_xml2enc</a></code> et il doit
|
||
<EFBFBD>tre charg<72> pour que l'internationalisation fonctionne.</p>
|
||
<p>L'interaction entre mod_proxy_html et mod_xml2enc est trop complexe pour <20>tre
|
||
configur<EFBFBD>e en utilisant les r<>gles de filtrage classiques, y compris les
|
||
directives de <code class="module"><a href="../mod/mod_filter.html">mod_filter</a></code>. Ainsi, m<>me si mod_proxy_html peut
|
||
quand-m<>me <20>tre configur<75> via les directives de filtrage classiques, ce ne sera
|
||
pas suffisant pour le support de l'internationalisation. A cet effet, on a
|
||
introduit la nouvelle directive <code class="directive">ProxyHTMLEnable</code> qui
|
||
permet de configurer <20> la fois le filtre de mod_proxy_html et mod_xml2enc. Il
|
||
est d'ailleurs recommand<6E> de toujours utiliser ProxyHTMLEnable, m<>me
|
||
si le support de l'internationalisation n'est pas n<>cessaire. <strong>Notez que
|
||
ceci constitue un changement par rapport aux pr<70>c<EFBFBD>dentes versions o<>
|
||
mod_proxy_html <20>tait activ<69> via les directives de filtrage.</strong></p>
|
||
|
||
</div>
|
||
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
|
||
<div class="directive-section"><h2><a name="proxyhtmlbufsize" id="proxyhtmlbufsize">Directive</a> <a name="ProxyHTMLBufSize" id="ProxyHTMLBufSize">ProxyHTMLBufSize</a><a title="Lien permanent" href="#proxyhtmlbufsize" class="permalink">¶</a></h2>
|
||
<table class="directive">
|
||
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>D<>finit l'incr<63>ment de la taille du tampon, ainsi que sa
|
||
taille initiale, pour la mise en
|
||
tampon des scripts en ligne et des feuilles de style.</td></tr>
|
||
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ProxyHTMLBufSize <var>nb-octets</var></code></td></tr>
|
||
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, r<>pertoire</td></tr>
|
||
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
|
||
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_proxy_html</td></tr>
|
||
<tr><th><a href="directive-dict.html#Compatibility">Compatibilit<69>:</a></th><td>Disponible depuis la version 2.4 du serveur HTTP Apache.
|
||
Disponible en tant que module tiers dans les versions 2.x ant<6E>rieures.</td></tr>
|
||
</table>
|
||
<p>Pour pouvoir interpr<70>ter du contenu non HTML (feuilles de style et
|
||
scripts) embarqu<71> dans des documents HTML, mod_proxy_html doit le lire
|
||
et le m<>moriser en entier dans un
|
||
tampon. Ce tampon devra <20>tre <20>tendu autant que n<>cessaire afin de
|
||
pouvoir accueillir le plus grand script ou la plus grande feuille de
|
||
style de la page, selon un incr<63>ment de <var>nb-octets</var> que cette
|
||
directive permet de d<>finir.</p>
|
||
<p>La valeur par d<>faut est 8192 et sera suffisante pour la plupart des
|
||
pages. Cependant, si vous savez que vous allez mandater des
|
||
pages contenant des feuilles de style et/ou scripts plus grands que 8k
|
||
(cette taille s'entend pour chaque script ou feuilles de style, non pour
|
||
leur ensemble), il sera plus efficace de d<>finir une taille de
|
||
tampon initiale plus grande afin d'<27>viter d'avoir <20> le redimensionner
|
||
dynamiquement au cours du traitement d'une requ<71>te.
|
||
</p>
|
||
|
||
</div>
|
||
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
|
||
<div class="directive-section"><h2><a name="proxyhtmlcharsetout" id="proxyhtmlcharsetout">Directive</a> <a name="ProxyHTMLCharsetOut" id="ProxyHTMLCharsetOut">ProxyHTMLCharsetOut</a><a title="Lien permanent" href="#proxyhtmlcharsetout" class="permalink">¶</a></h2>
|
||
<table class="directive">
|
||
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Sp<53>cifie un jeu de caract<63>res pour la sortie de
|
||
mod_proxy_html.</td></tr>
|
||
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ProxyHTMLCharsetOut <var>jeu-de-caract<63>res | *</var></code></td></tr>
|
||
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, r<>pertoire</td></tr>
|
||
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
|
||
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_proxy_html</td></tr>
|
||
<tr><th><a href="directive-dict.html#Compatibility">Compatibilit<69>:</a></th><td>Disponible depuis la version 2.4 du serveur HTTP Apache.
|
||
Disponible en tant que module tiers dans les versions 2.x ant<6E>rieures.</td></tr>
|
||
</table>
|
||
<p>Cette directive permet de sp<73>cifier un jeu de caract<63>res pour la
|
||
sortie de mod_proxy_html. Elle ne devrait jamais <20>tre utilis<69>e, car tout
|
||
changement par rapport <20> la valeur par d<>faut <code>UTF-8</code> (Unicode -
|
||
utilis<EFBFBD> en interne par libxml2) induit une charge suppl<70>mentaire de
|
||
traitement. La d<>finition sp<73>ciale <code>ProxyHTMLCharsetOut *</code>
|
||
permet de g<>n<EFBFBD>rer une sortie qui utilisera le m<>me encodage que
|
||
l'entr<74>e.</p>
|
||
<p>Notez que tout ceci ne fonctionne que si le module
|
||
<code class="module"><a href="../mod/mod_xml2enc.html">mod_xml2enc</a></code> est charg<72>.</p>
|
||
|
||
</div>
|
||
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
|
||
<div class="directive-section"><h2><a name="proxyhtmldoctype" id="proxyhtmldoctype">Directive</a> <a name="ProxyHTMLDocType" id="ProxyHTMLDocType">ProxyHTMLDocType</a><a title="Lien permanent" href="#proxyhtmldoctype" class="permalink">¶</a></h2>
|
||
<table class="directive">
|
||
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>D<>finit une d<>claration de type de document HTML ou XHTML.</td></tr>
|
||
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ProxyHTMLDocType HTML|XHTML [Legacy]<br /><strong>OR</strong>
|
||
<br />ProxyHTMLDocType <var>fpi</var> [SGML|XML]<br /><strong>OR</strong>
|
||
<br />ProxyHTMLDocType html5<br /><strong>OR</strong>
|
||
<br />ProxyHTMLDocType auto</code></td></tr>
|
||
<tr><th><a href="directive-dict.html#Default">D<>faut:</a></th><td><code>ProxyHTMLDocType auto (2.5/trunk versions); no FPI (2.4.x)</code></td></tr>
|
||
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, r<>pertoire</td></tr>
|
||
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
|
||
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_proxy_html</td></tr>
|
||
<tr><th><a href="directive-dict.html#Compatibility">Compatibilit<69>:</a></th><td>Disponible depuis la version 2.4 du serveur HTTP Apache.
|
||
Disponible en tant que module tiers dans les versions 2.x ant<6E>rieures.</td></tr>
|
||
</table>
|
||
<p>Avec la premi<6D>re syntaxe, les documents seront d<>clar<61>s de type HTML
|
||
4.01 ou XHTML 1.0 selon l'option sp<73>cifi<66>e. Cette option d<>termine aussi
|
||
si la syntaxe utilis<69>e en sortie est HTML ou XHTML. Notez que le format
|
||
des documents en provenance du serveur d'arri<72>re-plan n'est pas
|
||
important, car l'interpr<70>teur le d<>tectera automatiquement. Si le
|
||
second argument optionnel est d<>fini <20> "Legacy", les documents seront
|
||
d<EFBFBD>clar<EFBFBD>s de type "Transitional" ; cette option peut <20>tre n<>cessaire si
|
||
vous mandatez du contenu datant d'avant 1998, ou si vous travaillez avec
|
||
des outils de cr<63>ation/publication d<>ficients.</p>
|
||
<p>Avec la deuxi<78>me syntaxe, cette directive vous permet d'ins<6E>rer votre
|
||
propre FPI (Formal Public Identifier). Le second argument optionnel
|
||
d<EFBFBD>termine si la syntaxe utilis<69>e sera SGML/HTML ou XML/XHTML.</p>
|
||
<p>La troisi<73>me syntaxe attribue le type HTML 5 aux documents.</p>
|
||
<p>La quatri<72>me syntaxe est nouvelle dans la branche trunk de HTTPD et
|
||
n'est pas encore disponible dans les versions stables ; elle utilise
|
||
l'interpr<70>teur HTML de libxml2 pour d<>terminer le type de document.</p>
|
||
<p>Avec la premi<6D>re syntaxe, mod_proxy_html va aussi mettre le code HTML
|
||
en conformit<69> avec le standard sp<73>cifi<66>. Il ne pourra pas corriger
|
||
toutes les erreurs, mais il va supprimer les <20>l<EFBFBD>ments et attributs non
|
||
conformes. Il peut aussi journaliser les autres erreurs si la directive
|
||
<code class="directive"><a href="../mod/core.html#loglevel">LogLevel</a></code> est d<>finie <20>
|
||
Debug.</p>
|
||
|
||
</div>
|
||
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
|
||
<div class="directive-section"><h2><a name="proxyhtmlenable" id="proxyhtmlenable">Directive</a> <a name="ProxyHTMLEnable" id="ProxyHTMLEnable">ProxyHTMLEnable</a><a title="Lien permanent" href="#proxyhtmlenable" class="permalink">¶</a></h2>
|
||
<table class="directive">
|
||
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Permet d'activer/d<>sactiver le filtre proxy_html.</td></tr>
|
||
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ProxyHTMLEnable On|Off</code></td></tr>
|
||
<tr><th><a href="directive-dict.html#Default">D<>faut:</a></th><td><code>ProxyHTMLEnable Off</code></td></tr>
|
||
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, r<>pertoire</td></tr>
|
||
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
|
||
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_proxy_html</td></tr>
|
||
<tr><th><a href="directive-dict.html#Compatibility">Compatibilit<69>:</a></th><td>Disponible depuis la version 2.4 du serveur HTTP Apache.
|
||
Disponible en tant que module tiers dans les versions 2.x ant<6E>rieures.</td></tr>
|
||
</table>
|
||
<p>Cette directive est un simple commutateur permettant
|
||
d'activer/d<>sactiver le filtre proxy_html. Si
|
||
<code class="module"><a href="../mod/mod_xml2enc.html">mod_xml2enc</a></code> est charg<72>, elle va aussi activer
|
||
automatiquement le support de l'internationalisation.</p>
|
||
<p>Notez que le filtre proxy_html s'agira que si les donn<6E>es sont de
|
||
type HTML (Content-Type text/html ou application/xhtml+xml), et si
|
||
elles passent par un mandataire. Vous pouvez passer outre ces
|
||
contraintes (<28> vos risques et p<>rils) en d<>finissant la variable
|
||
d'environnement <var>PROXY_HTML_FORCE</var>.</p>
|
||
|
||
</div>
|
||
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
|
||
<div class="directive-section"><h2><a name="proxyhtmlevents" id="proxyhtmlevents">Directive</a> <a name="ProxyHTMLEvents" id="ProxyHTMLEvents">ProxyHTMLEvents</a><a title="Lien permanent" href="#proxyhtmlevents" class="permalink">¶</a></h2>
|
||
<table class="directive">
|
||
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Sp<53>cifie les attributs <20> traiter comme des <20>v<EFBFBD>nements de
|
||
type scripting.</td></tr>
|
||
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ProxyHTMLEvents <var>attribut [attribut ...]</var></code></td></tr>
|
||
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, r<>pertoire</td></tr>
|
||
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
|
||
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_proxy_html</td></tr>
|
||
<tr><th><a href="directive-dict.html#Compatibility">Compatibilit<69>:</a></th><td>Disponible depuis la version 2.4 du serveur HTTP Apache.
|
||
Disponible en tant que module tiers dans les versions 2.x ant<6E>rieures.</td></tr>
|
||
</table>
|
||
<p>Cette directive permet de sp<73>cifier un ou plusieurs attributs <20>
|
||
traiter comme
|
||
des <20>v<EFBFBD>nements de type scripting et de leur appliquer les r<>gles
|
||
<code class="directive"><a href="#proxyhtmlurlmap">ProxyHTMLURLMap</a></code> lorsqu'elles ont <20>t<EFBFBD> d<>finies. Vous
|
||
pouvez sp<73>cifier un nombre quelconque d'attributs dans une ou plusieurs
|
||
directives <code class="directive">ProxyHTMLEvents</code>.</p>
|
||
<p>Normalement, cette directive est d<>finie globalement. Si vous
|
||
d<EFBFBD>finissez <code class="directive">ProxyHTMLEvents</code> <20> plusieurs niveaux, certains niveaux
|
||
l'emportant sur d'autres, vous devrez sp<73>cifier un jeu complet
|
||
d'<27>v<EFBFBD>nements pour chaque niveau.</p>
|
||
<p>Le fichier <var>proxy-html.conf</var> fournit une configuration par
|
||
d<EFBFBD>faut et d<>finit les <20>v<EFBFBD>nements selon les standards
|
||
HTML 4 et XHTML 1. Cette configuration peut <20>tre adapt<70>e pour s'appliquer aux
|
||
URLs embarqu<71>es dans les attributs des feuilles de style CSS en ajoutant
|
||
l'attribut <var>style</var> <20> ProxyHTMLEvents, m<>me s'il n'existe pas dans la
|
||
configuration par d<>faut.</p>
|
||
|
||
</div>
|
||
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
|
||
<div class="directive-section"><h2><a name="proxyhtmlextended" id="proxyhtmlextended">Directive</a> <a name="ProxyHTMLExtended" id="ProxyHTMLExtended">ProxyHTMLExtended</a><a title="Lien permanent" href="#proxyhtmlextended" class="permalink">¶</a></h2>
|
||
<table class="directive">
|
||
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>D<>termine si l'on doit corriger les liens dans les scripts
|
||
en ligne, les feuilles de style et les <20>v<EFBFBD>nements de type scripting.</td></tr>
|
||
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ProxyHTMLExtended On|Off</code></td></tr>
|
||
<tr><th><a href="directive-dict.html#Default">D<>faut:</a></th><td><code>ProxyHTMLExtended Off</code></td></tr>
|
||
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, r<>pertoire</td></tr>
|
||
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
|
||
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_proxy_html</td></tr>
|
||
<tr><th><a href="directive-dict.html#Compatibility">Compatibilit<69>:</a></th><td>Disponible depuis la version 2.4 du serveur HTTP Apache.
|
||
Disponible en tant que module tiers dans les versions 2.x ant<6E>rieures.</td></tr>
|
||
</table>
|
||
<p>Si cette directive est d<>finie <20> <code>Off</code>, les liens HTML
|
||
sont r<><72>crits en fonction des directives
|
||
<code class="directive"><a href="#proxyhtmlurlmap">ProxyHTMLURLMap</a></code>, mais les liens qui apparaissent
|
||
dans le code Javascript et les feuilles de style restent inchang<6E>s.</p>
|
||
<p>Si elle est d<>finie <20> <code>On</code>, tous les <20>v<EFBFBD>nements de type
|
||
scripting (d<>finis par la directive
|
||
<code class="directive"><a href="#proxyhtmlevents">ProxyHTMLEvents</a></code>) et les scripts inclus ou les
|
||
feuilles de style sont aussi
|
||
trait<EFBFBD>s par les r<>gles <code class="directive"><a href="#proxyhtmlurlmap">ProxyHTMLURLMap</a></code>, en
|
||
fonction des drapeaux d<>finis pour chacune d'entre elles. Ne d<>finissez
|
||
cette directive <20> <code>On</code> qu'en cas de n<>cessit<69> absolue, car la
|
||
charge suppl<70>mentaire induite impacte les performances.</p>
|
||
<p>Vous devez aussi pr<70>ter attention aux mod<6F>les de comparaison, car
|
||
l'interpr<70>teur n'a aucune notion de la forme que pourrait prendre une URL dans un
|
||
script embarqu<71> ou une feuille de style. En particulier, la comparaison
|
||
<EFBFBD>tendus du caract<63>re <code>/</code> a de fortes chances d'induire des
|
||
correspondances erron<6F>es.</p>
|
||
|
||
</div>
|
||
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
|
||
<div class="directive-section"><h2><a name="proxyhtmlfixups" id="proxyhtmlfixups">Directive</a> <a name="ProxyHTMLFixups" id="ProxyHTMLFixups">ProxyHTMLFixups</a><a title="Lien permanent" href="#proxyhtmlfixups" class="permalink">¶</a></h2>
|
||
<table class="directive">
|
||
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Corrige les erreurs HTML simples.</td></tr>
|
||
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ProxyHTMLFixups [lowercase] [dospath] [reset]</code></td></tr>
|
||
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, r<>pertoire</td></tr>
|
||
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
|
||
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_proxy_html</td></tr>
|
||
<tr><th><a href="directive-dict.html#Compatibility">Compatibilit<69>:</a></th><td>Disponible depuis la version 2.4 du serveur HTTP Apache.
|
||
Disponible en tant que module tiers dans les versions 2.x ant<6E>rieures.</td></tr>
|
||
</table>
|
||
<p>Cette directive accepte un <20> trois arguments parmi les suivants :</p>
|
||
<ul>
|
||
<li><code>lowercase</code>Les Urls sont r<><72>crites en minuscules</li>
|
||
<li><code>dospath</code>Les slashes invers<72>s dans les URLs sont
|
||
remplac<EFBFBD>s par des slashes directs.</li>
|
||
<li><code>reset</code>Annule toute option d<>finie <20> un niveau sup<75>rieur
|
||
dans la configuration</li>
|
||
</ul>
|
||
<p>Cette directive doit <20>tre utilis<69>e avec prudence. Elle peut corriger
|
||
certaines erreurs de cr<63>ation, mais risque aussi de modifier par erreur
|
||
des liens corrects. Ne l'utilisez que si vous <20>tes s<>r que le serveur
|
||
d'arri<72>re-plan est d<>ficient.</p>
|
||
|
||
</div>
|
||
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
|
||
<div class="directive-section"><h2><a name="proxyhtmlinterp" id="proxyhtmlinterp">Directive</a> <a name="ProxyHTMLInterp" id="ProxyHTMLInterp">ProxyHTMLInterp</a><a title="Lien permanent" href="#proxyhtmlinterp" class="permalink">¶</a></h2>
|
||
<table class="directive">
|
||
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Active la r<>interpr<70>tation des r<>gles
|
||
<code class="directive">ProxyHTMLURLMap</code> pour chaque requ<71>te.</td></tr>
|
||
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ProxyHTMLInterp On|Off</code></td></tr>
|
||
<tr><th><a href="directive-dict.html#Default">D<>faut:</a></th><td><code>ProxyHTMLInterp Off</code></td></tr>
|
||
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, r<>pertoire</td></tr>
|
||
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
|
||
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_proxy_html</td></tr>
|
||
<tr><th><a href="directive-dict.html#Compatibility">Compatibilit<69>:</a></th><td>Disponible depuis la version 2.4 du serveur HTTP Apache.
|
||
Disponible en tant que module tiers dans les versions 2.x ant<6E>rieures.</td></tr>
|
||
</table>
|
||
<p>Cette directive permet d'activer le r<>interpr<70>tation pour chaque
|
||
requ<71>te des mod<6F>les source et cible de la directive
|
||
<code class="directive"><a href="#proxyhtmlurlmap">ProxyHTMLURLMap</a></code>.</p>
|
||
<p>Si la r<>interpr<70>tation n'est pas activ<69>e, toutes les r<>gles sont
|
||
pr<70>compil<69>es au d<>marrage du serveur. Si elle est activ<69>e, les
|
||
r<>gles doivent <20>tre recompil<69>es pour chaque requ<71>te, ce qui induit
|
||
une charge de traitement suppl<70>mentaire. Elle ne doit donc <20>tre activ<69>e que si
|
||
cela s'av<61>re n<>cessaire.</p>
|
||
|
||
</div>
|
||
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
|
||
<div class="directive-section"><h2><a name="proxyhtmllinks" id="proxyhtmllinks">Directive</a> <a name="ProxyHTMLLinks" id="ProxyHTMLLinks">ProxyHTMLLinks</a><a title="Lien permanent" href="#proxyhtmllinks" class="permalink">¶</a></h2>
|
||
<table class="directive">
|
||
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Sp<53>cifie les <20>l<EFBFBD>ments HTML dont les attributs d'URL doivent
|
||
<EFBFBD>tre r<><72>crits.</td></tr>
|
||
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ProxyHTMLLinks <var><3E>l<EFBFBD>ment attribut [attribut2 ...]</var></code></td></tr>
|
||
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, r<>pertoire</td></tr>
|
||
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
|
||
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_proxy_html</td></tr>
|
||
<tr><th><a href="directive-dict.html#Compatibility">Compatibilit<69>:</a></th><td>Disponible depuis la version 2.4 du serveur HTTP Apache.
|
||
Disponible en tant que module tiers dans les versions 2.x ant<6E>rieures.</td></tr>
|
||
</table>
|
||
<p>Cette directive permet de sp<73>cifier les <20>l<EFBFBD>ments dont les attributs d'URL
|
||
doivent <20>tre r<><72>crits en utilisant les r<>gles standards <code class="directive"><a href="#proxyhtmlurlmap">ProxyHTMLURLMap</a></code>. Vous devez d<>finir une
|
||
directive <code class="directive">ProxyHTMLLinks</code> pour chaque <20>l<EFBFBD>ment, mais chacune d'entre elles peut
|
||
sp<EFBFBD>cifier un nombre quelconque d'attributs</p> <p>Normalement, cette directive
|
||
est d<>finie globalement. Si vous d<>finissez <code class="directive">ProxyHTMLLinks</code> <20> plusieurs niveaux,
|
||
certains niveaux l'emportant sur d'autres, vous devrez sp<73>cifier un jeu complet
|
||
de liens pour chaque niveau.</p> <p>Le fichier <var>proxy-html.conf</var>
|
||
fournit une configuration par d<>faut et d<>finit les liens HTML selon les
|
||
standards HTML 4 et XHTML 1.</p>
|
||
<div class="example"><h3>Exemples issus de proxy-html.conf</h3><pre class="prettyprint lang-config">ProxyHTMLLinks a href
|
||
ProxyHTMLLinks area href
|
||
ProxyHTMLLinks link href
|
||
ProxyHTMLLinks img src longdesc usemap
|
||
ProxyHTMLLinks object classid codebase data usemap
|
||
ProxyHTMLLinks q cite
|
||
ProxyHTMLLinks blockquote cite
|
||
ProxyHTMLLinks ins cite
|
||
ProxyHTMLLinks del cite
|
||
ProxyHTMLLinks form action
|
||
ProxyHTMLLinks input src usemap
|
||
ProxyHTMLLinks head profile
|
||
ProxyHTMLLinks base href
|
||
ProxyHTMLLinks script src for</pre>
|
||
</div>
|
||
|
||
</div>
|
||
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
|
||
<div class="directive-section"><h2><a name="proxyhtmlmeta" id="proxyhtmlmeta">Directive</a> <a name="ProxyHTMLMeta" id="ProxyHTMLMeta">ProxyHTMLMeta</a><a title="Lien permanent" href="#proxyhtmlmeta" class="permalink">¶</a></h2>
|
||
<table class="directive">
|
||
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Active ou d<>sactive une pr<70>interpr<70>tation suppl<70>mentaire
|
||
des m<>tadonn<6E>es dans les sections HTML <code><head></code>.</td></tr>
|
||
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ProxyHTMLMeta On|Off</code></td></tr>
|
||
<tr><th><a href="directive-dict.html#Default">D<>faut:</a></th><td><code>ProxyHTMLMeta Off</code></td></tr>
|
||
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, r<>pertoire</td></tr>
|
||
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
|
||
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_proxy_html</td></tr>
|
||
<tr><th><a href="directive-dict.html#Compatibility">Compatibilit<69>:</a></th><td>Disponible <20> partir de la version 2.4 du serveur HTTP
|
||
Apache ; propos<6F> en tant que module tiers dans les versions 2.x
|
||
pr<EFBFBD>c<EFBFBD>dentes.</td></tr>
|
||
</table>
|
||
<p>Cette directive permet d'activer ou d<>sactiver une
|
||
pr<70>interpr<70>tation suppl<70>mentaire des m<>tadonn<6E>es dans les sections
|
||
HTML <code><head></code>. Si cette pr<70>interpr<70>tation n'est pas
|
||
requise, d<>finissez ProxyHTMLMeta <20> Off et les performances
|
||
seront l<>g<EFBFBD>rement am<61>lior<6F>es. Cependant, elle s'av<61>re parfois
|
||
n<>cessaire pour assurer un fonctionnement correct de l'internationalisation.</p>
|
||
<p>La directive <code class="directive">ProxyHTMLMeta</code> a deux effets. Le premier et le plus
|
||
important est la d<>tection des codages de caract<63>res d<>clar<61>s sous
|
||
la forme</p>
|
||
<pre><meta http-equiv="Content-Type" content="text/html;charset=<var>foo</var>"></pre>
|
||
<p>ou, dans le cas d'un document XHTML, sous la forme d'une
|
||
d<>claration XML. Elle n'est pas n<>cessaire si le jeu de caract<63>res
|
||
est d<>clar<61> explicitement dans un en-t<>te HTTP (ce qui est
|
||
pr<70>f<EFBFBD>rable) en provenance du serveur d'arri<72>re-plan, ou si le
|
||
document est en <var>utf-8</var> (unicode) ou un de ses
|
||
sous-ensembles comme ASCII. Vous pourrez aussi vous en passer
|
||
lorsque le document utilise une valeur par d<>faut d<>clar<61>e via la
|
||
directive <code class="directive"><a href="../mod/mod_xml2enc.html#xml2encdefault">xml2EncDefault</a></code>, avec le risque de
|
||
propager une d<>claration incorrecte. Une directive
|
||
<code class="directive"><a href="#proxyhtmlcharsetout">ProxyHTMLCharsetOut</a></code> permettra d'annuler ce
|
||
risque, mais pourra induire une surcharge de traitement sup<75>rieure <20>
|
||
celle de ProxyHTMLMeta.</p>
|
||
<p>Le deuxi<78>me effet est l'interpr<70>tation de toutes les d<>clarations
|
||
<code><meta http-equiv=...></code> et leur conversion en
|
||
en-t<>tes HTTP, afin de conserver le but original de cette forme
|
||
de m<>ta<74>l<EFBFBD>ment HTML.</p>
|
||
|
||
<div class="warning"><h3>Avertissement</h3> Compte tenu du fait que la
|
||
directive ProxyHTMLMeta promeut <strong>tous</strong> les <20>l<EFBFBD>ments
|
||
<code>http-equiv</code> au rang d'en-t<>tes HTTP, il est conseill<6C> de ne
|
||
l'activer que si vous faites autant confiance au contenu HTML qu'<27> votre
|
||
serveur mandataire. Avec cette directive en effet, si ce contenu est g<>r<EFBFBD>
|
||
par des gens malintentionn<6E>s, ces derniers seront en mesure d'injecter des
|
||
en-t<>tes HTTP arbitraires et peut-<2D>tre malveillants dans les r<>ponses de
|
||
votre serveur.
|
||
</div>
|
||
|
||
</div>
|
||
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
|
||
<div class="directive-section"><h2><a name="proxyhtmlstripcomments" id="proxyhtmlstripcomments">Directive</a> <a name="ProxyHTMLStripComments" id="ProxyHTMLStripComments">ProxyHTMLStripComments</a><a title="Lien permanent" href="#proxyhtmlstripcomments" class="permalink">¶</a></h2>
|
||
<table class="directive">
|
||
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>D<>termine si les commentaires HTML doivent <20>tre supprim<69>s.</td></tr>
|
||
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ProxyHTMLStripComments On|Off</code></td></tr>
|
||
<tr><th><a href="directive-dict.html#Default">D<>faut:</a></th><td><code>ProxyHTMLStripComments Off</code></td></tr>
|
||
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, r<>pertoire</td></tr>
|
||
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
|
||
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_proxy_html</td></tr>
|
||
<tr><th><a href="directive-dict.html#Compatibility">Compatibilit<69>:</a></th><td>Disponible depuis la version 2.4 du serveur HTTP Apache.
|
||
Disponible en tant que module tiers dans les versions 2.x ant<6E>rieures.</td></tr>
|
||
</table>
|
||
<p>Si cette directive est d<>finie <20> <code>On</code>, mod_proxy_html
|
||
supprimera les commentaires HTML. Notez que cela supprimera aussi tout
|
||
script ou style inclus dans les commentaires (une monstruosit<69>
|
||
introduite en 1995/1996 avec Netscape 2 pour les navigateurs plus
|
||
anciens, et encore utilis<69>e de nos jours). Cette directive peut aussi
|
||
interf<EFBFBD>rer avec des processeurs bas<61>s sur les commentaires comme SSI ou
|
||
ESI : assurez-vous d'ex<65>cuter ces derniers <em>avant</em> mod_proxy_html
|
||
dans la cha<68>ne de filtrage si vous supprimez les commentaires !</p>
|
||
|
||
</div>
|
||
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
|
||
<div class="directive-section"><h2><a name="proxyhtmlurlmap" id="proxyhtmlurlmap">Directive</a> <a name="ProxyHTMLURLMap" id="ProxyHTMLURLMap">ProxyHTMLURLMap</a><a title="Lien permanent" href="#proxyhtmlurlmap" class="permalink">¶</a></h2>
|
||
<table class="directive">
|
||
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>D<>finit une r<>gle de r<><72>criture des liens HTML</td></tr>
|
||
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ProxyHTMLURLMap <var>mod<6F>le-source mod<6F>le-cible [drapeaux] [cond]</var></code></td></tr>
|
||
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, r<>pertoire</td></tr>
|
||
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
|
||
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_proxy_html</td></tr>
|
||
<tr><th><a href="directive-dict.html#Compatibility">Compatibilit<69>:</a></th><td>Disponible depuis la version 2.4 du serveur HTTP Apache.
|
||
Disponible en tant que module tiers dans les versions 2.x ant<6E>rieures.</td></tr>
|
||
</table>
|
||
<p>Il s'agit de la directive la plus importante pour la r<><72>criture des
|
||
liens HTML. Lors de l'interpr<70>tation d'un document, chaque fois qu'un
|
||
lien correspond <20> <var>mod<6F>le-source</var>, la partie du lien concern<72>e
|
||
sera r<><72>crite en <var>mod<6F>le-cible</var>, en tenant compte des
|
||
modifications induites par les drapeaux <20>ventuellement sp<73>cifi<66>s et par
|
||
la directive <code class="directive"><a href="#proxyhtmlextended">ProxyHTMLExtended</a></code>.
|
||
Ne seront consid<69>r<EFBFBD>s comme des liens HTML que les <20>l<EFBFBD>ments sp<73>cifi<66>s via la
|
||
directive <code class="directive"><a href="#proxyhtmllinks">ProxyHTMLLinks</a></code>.</p>
|
||
|
||
<p>Le troisi<73>me argument optionnel permet de d<>finir un des drapeaux
|
||
suivants (les drapeaux sont sensibles <20> la casse) :</p>
|
||
<dl>
|
||
<dt>h</dt>
|
||
<dd><p>Ignore les liens HTML (les traverse sans les modifier)</p></dd>
|
||
<dt>e</dt>
|
||
<dd><p>Ignore les <20>v<EFBFBD>nements de scripting (les traverse sans les
|
||
modifier)</p></dd>
|
||
<dt>c</dt>
|
||
<dd><p>Traverse les sections de type style ou script sans les modifier.</p></dd>
|
||
|
||
<dt>L</dt>
|
||
<dd><p>Last-match. Si cette r<>gle s'applique, aucune autre r<>gle ne sera
|
||
prise en compte (notez qu'il s'agit du comportement automatique pour les
|
||
liens HTML).</p></dd>
|
||
<dt>l</dt>
|
||
<dd><p>L'oppos<6F> de L. Passe outre le comportement par d<>faut du
|
||
changement unique pour les liens HTML.</p></dd>
|
||
<dt>R</dt>
|
||
<dd><p>Utilise des expressions rationnelles pour les mod<6F>les.
|
||
<code>mod<6F>le-source</code> est une expression rationnelle, et
|
||
<code>mod<6F>le-cible</code> une cha<68>ne de remplacement qui peut <20>tre bas<61>e
|
||
elle aussi sur une expression rationnelle. La m<>morisation dans les
|
||
expressions rationnelles est support<72>e : vous pouvez utiliser des
|
||
parenth<EFBFBD>ses () dans le <code>mod<6F>le-source</code>, et r<>cup<75>rer la
|
||
correspondance de leur contenu via les variables $1 <20> $9 dans le
|
||
<code>mod<6F>le-cible</code>.</p>
|
||
|
||
<p>Si le drapeau R n'est pas fourni, la directive utilisera des cha<68>nes
|
||
litt<EFBFBD>rales pour les diff<66>rents mod<6F>les de recherche/remplacement. La
|
||
logique de recherche est <em>"commence par"</em> dans les liens HTML, et
|
||
<em>"contient"</em> dans les <20>v<EFBFBD>nements de scripting et les sections de
|
||
type style ou script.
|
||
</p>
|
||
</dd>
|
||
<dt>x</dt>
|
||
<dd><p>Utilise les expressions rationnelles <20>tendues POSIX. Ne
|
||
s'applique qu'avec R.</p></dd>
|
||
<dt>i</dt>
|
||
<dd><p>Recherche de correspondance sensible <20> la casse. Ne
|
||
s'applique qu'avec R.</p></dd>
|
||
|
||
<dt>n</dt>
|
||
<dd><p>D<>sactive la m<>morisation dans les expressions rationnelles (pour
|
||
am<EFBFBD>liorer les performances). Ne s'applique qu'avec R.</p></dd>
|
||
<dt>s</dt>
|
||
<dd><p>Recherche de correspondance dans les expressions rationnelles
|
||
bas<EFBFBD>e sur la ligne. Ne s'applique qu'avec R.</p></dd>
|
||
<dt>^</dt>
|
||
<dd><p>Recherche de correspondance au d<>but seulement. Ne concerne que
|
||
les recherches de correspondance par rapport <20> des cha<68>nes, et ne
|
||
s'applique pas aux liens HTML.</p></dd>
|
||
<dt>$</dt>
|
||
<dd><p>Recherche de correspondance <20> la fin seulement. Ne concerne que
|
||
les recherches de correspondance par rapport <20> des cha<68>nes, et ne
|
||
s'applique pas aux liens HTML.</p></dd>
|
||
<dt>V</dt>
|
||
<dd><p>Ins<6E>re des variables d'environnement dans le
|
||
<code>mod<6F>le-cible</code>. Un <code>mod<6F>le-cible</code> de la forme
|
||
<code>${varname|default}</code> sera remplac<61> par la valeur de la
|
||
variable d'environnement <code>varname</code>. Si cette derni<6E>re n'est
|
||
pas d<>finie, <code>mod<6F>le-cible</code> sera remplac<61> par
|
||
<code>default</code>. La sp<73>cification de <code>|default</code> est
|
||
facultative.</p>
|
||
<p>NOTE: l'insertion de variables d'environnement n'est possible que si
|
||
la directive <code class="directive"><a href="#proxyhtmlinterp">ProxyHTMLInterp</a></code> a <20>t<EFBFBD> d<>finie <20>
|
||
<var>On</var>.</p>
|
||
</dd>
|
||
|
||
<dt>v</dt>
|
||
<dd><p>Ins<6E>re des variables d'environnement dans le
|
||
<code>mod<6F>le-source</code>. La syntaxe du mod<6F>le est identique <20> la
|
||
syntaxe pr<70>c<EFBFBD>dente.</p>
|
||
<p>NOTE: l'insertion de variables d'environnement n'est possible que si
|
||
la directive <code class="directive"><a href="#proxyhtmlinterp">ProxyHTMLInterp</a></code> a <20>t<EFBFBD> d<>finie <20>
|
||
<var>On</var>.</p>
|
||
</dd>
|
||
</dl>
|
||
|
||
<p>Le quatri<72>me argument optionnel <strong>cond</strong> d<>finit une
|
||
condition qui sera <20>valu<6C>e pour chaque requ<71>te, sous r<>serve que la
|
||
directive <code class="directive"><a href="#proxyhtmlinterp">ProxyHTMLInterp</a></code> ait <20>t<EFBFBD> d<>finie <20>
|
||
<var>On</var>. Si la condition est <20>valu<6C>e <20> FALSE, la r<>gle ne sera pas
|
||
appliqu<EFBFBD>e <20> la requ<71>te. Si elle est <20>valu<6C>e <20> TRUE, ou si aucune
|
||
condition n'est d<>finie, la r<>gle s'applique.</p>
|
||
<p>La <strong>condition</strong> est <20>valu<6C>e par l'<a href="../expr.html">interpr<70>teur d'expression</a>. La syntaxe simple des
|
||
conditions dans mod_proxy_html 3.x pour HTTPD 2.0 et 2.2 est aussi
|
||
support<EFBFBD>e.</p>
|
||
|
||
</div>
|
||
</div>
|
||
<div class="bottomlang">
|
||
<p><span>Langues Disponibles: </span><a href="../en/mod/mod_proxy_html.html" hreflang="en" rel="alternate" title="English"> en </a> |
|
||
<a href="../fr/mod/mod_proxy_html.html" title="Fran<61>ais"> fr </a></p>
|
||
</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Commentaires</a></h2><div class="warning"><strong>Notice:</strong><br />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 <a href="http://httpd.apache.org/lists.html">mailing lists</a>.</div>
|
||
<script type="text/javascript"><!--//--><![CDATA[//><!--
|
||
var comments_shortname = 'httpd';
|
||
var comments_identifier = 'http://httpd.apache.org/docs/trunk/mod/mod_proxy_html.html';
|
||
(function(w, d) {
|
||
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
|
||
d.write('<div id="comments_thread"><\/div>');
|
||
var s = d.createElement('script');
|
||
s.type = 'text/javascript';
|
||
s.async = true;
|
||
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
|
||
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
|
||
}
|
||
else {
|
||
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
|
||
}
|
||
})(window, document);
|
||
//--><!]]></script></div><div id="footer">
|
||
<p class="apache">Copyright 2018 The Apache Software Foundation.<br />Autoris<69> sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
|
||
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
|
||
if (typeof(prettyPrint) !== 'undefined') {
|
||
prettyPrint();
|
||
}
|
||
//--><!]]></script>
|
||
</body></html> |