mod_proxy_http.html.fr revision 0844fff26cb7719e0f0a368d88544156ed6374b6
<?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">
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>mod_proxy_http - Serveur Apache HTTP</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" />
<body>
<div id="page-header">
<p class="menu"><a href="/mod/">Modules</a> | <a href="/mod/directives.html">Directives</a> | <a href="/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.3</p>
<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.3</a> > <a href="./">Modules</a></div>
<div id="page-content">
<div id="preamble"><h1>Module Apache mod_proxy_http</h1>
<div class="toplang">
<p><span>Langues Disponibles: </span><a href="/en/mod/mod_proxy_http.html" hreflang="en" rel="alternate" title="English"> en </a> |
</div>
<table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Module fournissant le support HTTP �
<tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur�de�Module:</a></th><td>proxy_http_module</td></tr>
<tr><th><a href="module-dict.html#SourceFile">Fichier�Source:</a></th><td>mod_proxy_http.c</td></tr></table>
<h3>Sommaire</h3>
<p>Pour pouvoir fonctionner, ce module <em>requiert</em> le
chargement de <code class="module"><a href="/mod/mod_proxy.html">mod_proxy</a></code>. Il fournit le support du
mandatement des requ�tes HTTP et HTTPS. <code class="module"><a href="/mod/mod_proxy_http.html">mod_proxy_http</a></code>
<em>aucune</em> fonctionnalit� de mise en cache. Si vous souhaitez
mettre en oeuvre un mandataire qui assure aussi les fonctions de
mise en cache, vous devez utiliser les services du module
<p>Ainsi, pour pouvoir traiter les requ�tes HTTP mandat�es,
<code class="module"><a href="/mod/mod_proxy.html">mod_proxy</a></code>, et <code class="module"><a href="/mod/mod_proxy_http.html">mod_proxy_http</a></code>
doivent �tre charg�s dans le serveur.</p>
<div class="warning"><h3>Avertissement</h3>
<p>N'activez pas la fonctionnalit� de mandataire avant d'avoir <a href="mod_proxy.html#access">s�curis� votre serveur</a>. Les
serveurs mandataires ouverts sont dangereux non seulement pour
votre r�seau, mais aussi pour l'Internet au sens large.</p>
</div>
</div>
<div id="quickview"><h3 class="directives">Directives</h3>
<p>Ce module ne fournit aucune directive.</p>
<h3>Sujets</h3>
<ul id="topics">
</ul><h3>Voir aussi</h3>
<ul class="seealso">
</ul></div>
<div class="section">
<h2><a name="env" id="env">Variables d'environnement</a></h2>
<p>Outre les directives de configuration qui contr�lent le
comportement de <code class="module"><a href="/mod/mod_proxy.html">mod_proxy</a></code>, plusieurs <dfn>variables
d'environnement</dfn> permettent de contr�ler le fournisseur du
protocole HTTP :</p>
<dl>
<dt>proxy-sendextracrlf</dt>
<dd>Provoque l'envoi par le mandataire d'une nouvelle ligne
CR-LF suppl�mentaire � la fin de la requ�te. Cei constitue un
moyen de contournement d'une bogue de certains
navigateurs.</dd>
<dt>force-proxy-request-1.0</dt>
<dd>Force le mandataire � envoyer des requ�tes vers le serveur
<dt>proxy-nokeepalive</dt>
<dd>Force le mandataire � fermer la connexion avec le serveur
cible apr�s chaque requ�te.</dd>
<dt>proxy-chain-auth</dt>
<dd>Si le mandataire requiert une authentification, il va lire
et exploiter les donn�es d'authentification pour mandataire
envoy�es par le client. Si <var>proxy-chain-auth</var> est
d�finie, il va <em>aussi</em> faire suivre ces donn�es vers le
mandataire suivant dans la cha�ne. Ceci peut s'av�rer n�cessaire
si une cha�ne de mandataires partagent les informations
d'authentification.
<strong>Avertissement concernant la s�curit� :</strong>
Ne d�finissez cette variable que si vous �tes s�r d'en avoir
besoin, car elle peut provoquer la divulgation d'informations
sensibles !</dd>
<dt>proxy-sendcl</dt>
(par exemple les requ�tes POST) doivent comporter un en-t�te
<var>Content-Length</var>. Cette variable d'environnement force
le mandataire Apache � envoyer cet en-t�te au serveur cible,
sans tenir compte de ce que lui a envoy� le client. Ceci permet
d'assurer la compatibilit� lorsqu'on mandate un serveur cible
peut cependant n�cessiter la mise en tampon de l'int�gralit� de
la requ�te par le mandataire, ce qui s'av�re tr�s inefficace
pour les requ�tes de grande taille.</dd>
<dt>proxy-sendchunks ou proxy-sendchunked</dt>
<dd>Cette variable constitue l'oppos� de
<var>proxy-sendcl</var>. Elle permet la transmission des corps
de requ�tes vers le serveur cible en utilisant un codage de
transfert fractionn�. Ceci permet une transmission des requ�tes
plus efficace, mais n�cessite que le serveur cible supporte le
<dt>proxy-interim-response</dt>
<dd>Cette variable peut prendre les valeurs <code>RFC</code>
(valeur par d�faut) ou
<code>Suppress</code>. Les versions pr�c�dentes de httpd
supprimaient les r�ponses interm�diaires HTTP (1xx) envoy�es par
le serveur cible. En pratique, si un serveur cible envoie une
r�ponse interm�diaire, il se peut qu'il �tende lui-m�me le
protocole d'une mani�re dont nous n'avons pas connaissance, ou
tout simplement non conforme. Le comportement du mandataire est
donc maintenant configurable : d�finissez
<code>proxy-interim-response RFC</code> pour �tre totalement
compatible avec le protocole, ou <code>proxy-interim-response
Suppress</code> pour supprimer les r�ponses interm�diaires.</dd>
<dt>proxy-initial-not-pooled</dt>
<dd>Si cette variable est d�finie, aucune connexion faisant
partie d'un jeu ne sera r�utilis�e si la connexion client est
une connexion initiale. Ceci permet d'�viter le message d'erreur
"proxy: error reading status line from remote server" caus� par
la situation de comp�tition au cours de laquelle le serveur
cible ferme la connexion du jeu apr�s la v�rification de la
connexion par le mandataire, et avant que les donn�es envoy�es
par le mandataire n'atteignent le serveur cible. Il faut
cependant garder � l'esprit que la d�finition de cette variable
d�grade les performances, particuli�rement avec les clients
</dd>
</dl>
<div class="section">
<h2><a name="notes" id="notes">Informations sur les requ�tes</a></h2>
<p><code class="module"><a href="/mod/mod_proxy_http.html">mod_proxy_http</a></code> enregistre les informations
suivantes pour journalisation via le format <code>%{NOMVAR}n</code>
dans les directives <code class="directive"><a href="/mod/mod_log_config.html#logformat">LogFormat</a></code> ou <code class="directive"><a href="/mod/core.html#errorlogformat">ErrorLogFormat</a></code> :
</p>
<dl>
<dt>proxy-source-port</dt>
<dd>Le port local utilis� pour la connexion vers le serveur
d'arri�re-plan.</dd>
<dt>proxy-status</dt>
<dd>Le code d'�tat HTTP re�u du serveur d'arri�re-plan.</dd>
</dl>
</div>
</div>
<div class="bottomlang">
<p><span>Langues Disponibles: </span><a href="/en/mod/mod_proxy_http.html" hreflang="en" rel="alternate" title="English"> en </a> |
</div><div id="footer">
<p class="apache">Copyright 2011 The Apache Software Foundation.<br />Autoris� 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/directives.html">Directives</a> | <a href="/faq/">FAQ</a> | <a href="/glossary.html">Glossaire</a> | <a href="/sitemap.html">Plan du site</a></p></div>
</body></html>