1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
|
<?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><!--
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" />
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" />
<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/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>
<img alt="" src="../images/feather.gif" /></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.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> |
<a href="../fr/mod/mod_proxy_http.html" title="Fran�ais"> fr </a></p>
</div>
<table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Module fournissant le support HTTP �
<code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code></td></tr>
<tr><th><a href="module-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
<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>
supporte HTTP/0.9, HTTP/1.0 et HTTP/1.1. Il ne fournit
<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
<code class="module"><a href="../mod/mod_cache.html">mod_cache</a></code>.</p>
<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">
<li><img alt="" src="../images/down.gif" /> <a href="#env">Variables d'environnement</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#notes">Informations sur les requ�tes</a></li>
</ul><h3>Voir aussi</h3>
<ul class="seealso">
<li><code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code></li>
<li><code class="module"><a href="../mod/mod_proxy_connect.html">mod_proxy_connect</a></code></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="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
cible selon le protocole HTTP/1.0 et d�sactive les
fonctionnalit�s propres � HTTP/1.1.</dd>
<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>
<dd>Avec HTTP/1.0, toutes les requ�tes qui poss�dent un corps
(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
mettant en oeuvre un protocole de type HTTP/1.0 ou inconnu. Elle
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
protocole HTTP/1.1.</dd>
<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
HTTP/1.0.
</dd>
</dl>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<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> |
<a href="../fr/mod/mod_proxy_http.html" title="Fran�ais"> fr </a></p>
</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>
|
