www/apache
1
0
Fork 0
mirror of https://github.com/apache/httpd.git synced 2025-10-30 08:05:39 +03:00
Code Activity
Files
1a2aaa45d0a390d1f4dd91ba6806bac6f7924ace
apache/docs/manual/mod/mod_proxy_html.html.fr
Luca Toscano 3a216c2776 Happy new year's documentation rebuild 
git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@1820055 13f79535-47bb-0310-9956-ffa450edef68
2018-01-04 10:58:20 +00:00

557 lines
38 KiB
Plaintext
Raw Blame History

<?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="&lt;-" alt="&lt;-" src="../images/left.gif" /></a></div>
<div id="path">
<a href="http://www.apache.org/">Apache</a> &gt; <a href="http://httpd.apache.org/">Serveur HTTP</a> &gt; <a href="http://httpd.apache.org/docs/">Documentation</a> &gt; <a href="../">Version 2.5</a> &gt; <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">&nbsp;en&nbsp;</a> |
<a href="../fr/mod/mod_proxy_html.html" title="Fran<61>ais">&nbsp;fr&nbsp;</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>&lt;a
href="http://appserver.example.com/foo/bar.html"&gt;foobar&lt;/a&gt;</code>
en <code>&lt;a
href="http://www.example.com/appserver/foo/bar.html"&gt;foobar&lt;/a&gt;</code>,
ce qui permet de rendre le serveur d'applications accessible depuis
l'ext<78>rieur.</p>
<p>mod_proxy_html a <20>t<EFBFBD> d<>velopp<70> <20> l'origine <20> Web<65>ing, dont la <a href="http://apache.webthing.com/mod_proxy_html/">documentation</a>
d<EFBFBD>taill<EFBFBD>e pourra s'av<61>rer utile aux utilisateurs.</p>
</div>
<div id="quickview"><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__&amp;list_id=144532&amp;product=Apache%20httpd-2&amp;query_format=specific&amp;order=changeddate%20DESC%2Cpriority%2Cbug_severity&amp;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&amp;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="directive-section"><h2><a name="proxyhtmlbufsize" id="proxyhtmlbufsize">Directive</a> <a name="ProxyHTMLBufSize" id="ProxyHTMLBufSize">ProxyHTMLBufSize</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></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></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></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></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.</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></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></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></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></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></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>&lt;head&gt;</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>&lt;head&gt;</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>&lt;meta http-equiv="Content-Type" content="text/html;charset=<var>foo</var>"&gt;</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>&lt;meta http-equiv=...&gt;</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></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></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">&nbsp;en&nbsp;</a> |
<a href="../fr/mod/mod_proxy_html.html" title="Fran<61>ais">&nbsp;fr&nbsp;</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&amp;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>
View Git Blame Copy Permalink