mod_proxy_http.html.en revision 19e58a269fe969b87c28465ee4914f3ae637e264
6ae232055d4d8a97267517c5e50074c2c819941and<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
6ae232055d4d8a97267517c5e50074c2c819941and<html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en"><head><!--
6ae232055d4d8a97267517c5e50074c2c819941and XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
6ae232055d4d8a97267517c5e50074c2c819941and This file is generated from xml source: DO NOT EDIT
6ae232055d4d8a97267517c5e50074c2c819941and XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
6ae232055d4d8a97267517c5e50074c2c819941and<link href="/style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" />
6ae232055d4d8a97267517c5e50074c2c819941and<link href="/style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" />
d29d9ab4614ff992b0e8de6e2b88d52b6f1f153erbowen<link href="/style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" />
d29d9ab4614ff992b0e8de6e2b88d52b6f1f153erbowen<link href="/images/favicon.ico" rel="shortcut icon" /></head>
6ae232055d4d8a97267517c5e50074c2c819941and<p class="menu"><a href="/mod/">Modules</a> | <a href="/mod/directives.html">Directives</a> | <a href="/faq/">FAQ</a> | <a href="/glossary.html">Glossary</a> | <a href="/sitemap.html">Sitemap</a></p>
d229f940abfb2490dee17979e9a5ff31b7012eb5rbowen<div class="up"><a href="./"><img title="<-" alt="<-" src="/images/left.gif" /></a></div>
6ae232055d4d8a97267517c5e50074c2c819941and<a href="http://www.apache.org/">Apache</a> > <a href="http://httpd.apache.org/">HTTP Server</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.3</a> > <a href="./">Modules</a></div>
6ae232055d4d8a97267517c5e50074c2c819941and<p><span>Available Languages: </span><a href="/en/mod/mod_proxy_http.html" title="English"> en </a></p>
6ae232055d4d8a97267517c5e50074c2c819941and<table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>HTTP support module for
b43f840409794ed298e8634f6284741f193b6c4ftakashi<code class="module"><a href="/mod/mod_proxy.html">mod_proxy</a></code></td></tr>
11495c9f0bd33e51a25b4d532beadfbcf9b944a3nilgun<tr><th><a href="module-dict.html#Status">Status:</a></th><td>Extension</td></tr>
6ae232055d4d8a97267517c5e50074c2c819941and<tr><th><a href="module-dict.html#ModuleIdentifier">Module�Identifier:</a></th><td>proxy_http_module</td></tr>
f086b4b402fa9a2fefc7dda85de2a3cc1cd0a654rjung<tr><th><a href="module-dict.html#SourceFile">Source�File:</a></th><td>mod_proxy_http.c</td></tr></table>
b43f840409794ed298e8634f6284741f193b6c4ftakashi <p>This module <em>requires</em> the service of <code class="module"><a href="/mod/mod_proxy.html">mod_proxy</a></code>. It provides the features used for
b43f840409794ed298e8634f6284741f193b6c4ftakashi proxying HTTP requests. <code class="module"><a href="/mod/mod_proxy_http.html">mod_proxy_http</a></code>
b43f840409794ed298e8634f6284741f193b6c4ftakashi supports HTTP/0.9, HTTP/1.0 and HTTP/1.1. It does <em>not</em>
6ae232055d4d8a97267517c5e50074c2c819941and provide any caching abilities. If you want to set up a caching
6ae232055d4d8a97267517c5e50074c2c819941and proxy, you might want to use the additional service of the
6ae232055d4d8a97267517c5e50074c2c819941and <code class="module"><a href="/mod/mod_cache.html">mod_cache</a></code> module.</p>
6ae232055d4d8a97267517c5e50074c2c819941and <p>Thus, in order to get the ability of handling HTTP proxy requests,
6ae232055d4d8a97267517c5e50074c2c819941and <code class="module"><a href="/mod/mod_proxy.html">mod_proxy</a></code> and <code class="module"><a href="/mod/mod_proxy_http.html">mod_proxy_http</a></code>
6ae232055d4d8a97267517c5e50074c2c819941and have to be present in the server.</p>
6ae232055d4d8a97267517c5e50074c2c819941and <p>Do not enable proxying until you have <a href="mod_proxy.html#access">secured your server</a>. Open proxy
6ae232055d4d8a97267517c5e50074c2c819941and servers are dangerous both to your network and to the Internet at
6ae232055d4d8a97267517c5e50074c2c819941and large.</p>
6ae232055d4d8a97267517c5e50074c2c819941and<div id="quickview"><h3 class="directives">Directives</h3>
6ae232055d4d8a97267517c5e50074c2c819941and<p>This module provides no
6ae232055d4d8a97267517c5e50074c2c819941and directives.</p>
6ae232055d4d8a97267517c5e50074c2c819941and<li><img alt="" src="/images/down.gif" /> <a href="#env">Environment Variables</a></li>
6ae232055d4d8a97267517c5e50074c2c819941and<li><code class="module"><a href="/mod/mod_proxy.html">mod_proxy</a></code></li>
6ae232055d4d8a97267517c5e50074c2c819941and<li><code class="module"><a href="/mod/mod_proxy_connect.html">mod_proxy_connect</a></code></li>
6ae232055d4d8a97267517c5e50074c2c819941and<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
6ae232055d4d8a97267517c5e50074c2c819941and <p>In addition to the configuration directives that control the
6ae232055d4d8a97267517c5e50074c2c819941and behaviour of <code class="module"><a href="/mod/mod_proxy.html">mod_proxy</a></code>, there are a number of
6ae232055d4d8a97267517c5e50074c2c819941and <dfn>environment variables</dfn> that control the HTTP protocol
6ae232055d4d8a97267517c5e50074c2c819941and provider:</p>
6ae232055d4d8a97267517c5e50074c2c819941and <dd>Causes proxy to send an extra CR-LF newline on the end of a
6ae232055d4d8a97267517c5e50074c2c819941and request. This is a workaround for a bug in some browsers.</dd>
6ae232055d4d8a97267517c5e50074c2c819941and <dd>Forces the proxy to send requests to the backend as HTTP/1.0
6ae232055d4d8a97267517c5e50074c2c819941and <dd>Forces the proxy to close the backend connection after
6ae232055d4d8a97267517c5e50074c2c819941and each request.</dd>
6ae232055d4d8a97267517c5e50074c2c819941and <dd>If the proxy requires authentication, it will read and
6ae232055d4d8a97267517c5e50074c2c819941and consume the proxy authentication credentials sent by the client.
6ae232055d4d8a97267517c5e50074c2c819941and With <var>proxy-chain-auth</var> it will <em>also</em> forward
6ae232055d4d8a97267517c5e50074c2c819941and the credentials to the next proxy in the chain. This may
6ae232055d4d8a97267517c5e50074c2c819941and be necessary if you have a chain of proxies that share
6ae232055d4d8a97267517c5e50074c2c819941and authentication information. <strong>Security Warning:</strong>
6ae232055d4d8a97267517c5e50074c2c819941and Do not set this unless you know you need it, as it forwards
6ae232055d4d8a97267517c5e50074c2c819941and sensitive information!</dd>
6ae232055d4d8a97267517c5e50074c2c819941and <dd>HTTP/1.0 required all HTTP requests that include a body
6ae232055d4d8a97267517c5e50074c2c819941and (e.g. POST requests) to include a <var>Content-Length</var>
6ae232055d4d8a97267517c5e50074c2c819941and header. This environment variable forces the Apache proxy to
6ae232055d4d8a97267517c5e50074c2c819941and send this header to the backend server, regardless of what the
6ae232055d4d8a97267517c5e50074c2c819941and Client sent to the proxy. It ensures compatibility when
6ae232055d4d8a97267517c5e50074c2c819941and may require the entire request to be buffered by the proxy,
6ae232055d4d8a97267517c5e50074c2c819941and so it becomes very inefficient for large requests.</dd>
6ae232055d4d8a97267517c5e50074c2c819941and <dd>This is the opposite of <var>proxy-sendcl</var>. It allows
6ae232055d4d8a97267517c5e50074c2c819941and request bodies to be sent to the backend using chunked transfer
6ae232055d4d8a97267517c5e50074c2c819941and encoding. This allows the request to be efficiently streamed,
6ae232055d4d8a97267517c5e50074c2c819941and but requires that the backend server supports HTTP/1.1.</dd>
6ae232055d4d8a97267517c5e50074c2c819941and <code>Suppress</code>. Earlier httpd versions would suppress
6ae232055d4d8a97267517c5e50074c2c819941and HTTP interim (1xx) responses sent from the backend. This is
6ae232055d4d8a97267517c5e50074c2c819941and technically a violation of the HTTP protocol. In practice,
6ae232055d4d8a97267517c5e50074c2c819941and if a backend sends an interim response, it may itself be
6ae232055d4d8a97267517c5e50074c2c819941and extending the protocol in a manner we know nothing about,
6ae232055d4d8a97267517c5e50074c2c819941and or just broken. So this is now configurable: set
6ae232055d4d8a97267517c5e50074c2c819941and <code>proxy-interim-response RFC</code> to be fully protocol
6ae232055d4d8a97267517c5e50074c2c819941and compliant, or <code>proxy-interim-response Suppress</code>
6ae232055d4d8a97267517c5e50074c2c819941and to suppress interim responses.</dd>
6ae232055d4d8a97267517c5e50074c2c819941and <dd>If this variable is set no pooled connection will be reused
6ae232055d4d8a97267517c5e50074c2c819941and if the client connection is an initial connection. This avoids
6ae232055d4d8a97267517c5e50074c2c819941and the "proxy: error reading status line from remote server" error message
6ae232055d4d8a97267517c5e50074c2c819941and caused by the race condition that the backend server closed the
6ae232055d4d8a97267517c5e50074c2c819941and pooled connection after the connection check by the proxy and
6ae232055d4d8a97267517c5e50074c2c819941and before data sent by the proxy reached the backend. It has to be
6ae232055d4d8a97267517c5e50074c2c819941and kept in mind that setting this variable downgrades performance,
6ae232055d4d8a97267517c5e50074c2c819941and<p><span>Available Languages: </span><a href="/en/mod/mod_proxy_http.html" title="English"> en </a></p>
6ae232055d4d8a97267517c5e50074c2c819941and<p class="apache">Copyright 2009 The Apache Software Foundation.<br />Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
6ae232055d4d8a97267517c5e50074c2c819941and<p class="menu"><a href="/mod/">Modules</a> | <a href="/mod/directives.html">Directives</a> | <a href="/faq/">FAQ</a> | <a href="/glossary.html">Glossary</a> | <a href="/sitemap.html">Sitemap</a></p></div>