b73a2be324e0b7fda7671ffc1e580a83a2af0d61nd<!DOCTYPE modulesynopsis SYSTEM "/style/modulesynopsis.dtd">
b73a2be324e0b7fda7671ffc1e580a83a2af0d61nd<?xml-stylesheet type="text/xsl" href="/style/manual.en.xsl"?>
5f5d1b4cc970b7f06ff8ef6526128e9a27303d88nd<!-- $LastChangedRevision$ -->
db479b48bd4d75423ed4a45e15b75089d1a8ad72fielding Licensed to the Apache Software Foundation (ASF) under one or more
db479b48bd4d75423ed4a45e15b75089d1a8ad72fielding contributor license agreements. See the NOTICE file distributed with
db479b48bd4d75423ed4a45e15b75089d1a8ad72fielding this work for additional information regarding copyright ownership.
db479b48bd4d75423ed4a45e15b75089d1a8ad72fielding The ASF licenses this file to You under the Apache License, Version 2.0
db479b48bd4d75423ed4a45e15b75089d1a8ad72fielding (the "License"); you may not use this file except in compliance with
db479b48bd4d75423ed4a45e15b75089d1a8ad72fielding the License. You may obtain a copy of the License at
d5d794fc2f4cc9ca6d6da17cfa2cdcd8d244bacdnd Unless required by applicable law or agreed to in writing, software
d5d794fc2f4cc9ca6d6da17cfa2cdcd8d244bacdnd distributed under the License is distributed on an "AS IS" BASIS,
d5d794fc2f4cc9ca6d6da17cfa2cdcd8d244bacdnd WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
d5d794fc2f4cc9ca6d6da17cfa2cdcd8d244bacdnd See the License for the specific language governing permissions and
d5d794fc2f4cc9ca6d6da17cfa2cdcd8d244bacdnd limitations under the License.
b73a2be324e0b7fda7671ffc1e580a83a2af0d61nd<description>HTTP support module for
b73a2be324e0b7fda7671ffc1e580a83a2af0d61nd >mod_proxy</module>. It provides the features used for
4ea8055e720d18f386b8026b546e5836ecccba4arjung proxying HTTP and HTTPS requests. <module>mod_proxy_http</module>
b73a2be324e0b7fda7671ffc1e580a83a2af0d61nd supports HTTP/0.9, HTTP/1.0 and HTTP/1.1. It does <em>not</em>
b73a2be324e0b7fda7671ffc1e580a83a2af0d61nd provide any caching abilities. If you want to set up a caching
b73a2be324e0b7fda7671ffc1e580a83a2af0d61nd proxy, you might want to use the additional service of the
b73a2be324e0b7fda7671ffc1e580a83a2af0d61nd <p>Thus, in order to get the ability of handling HTTP proxy requests,
b73a2be324e0b7fda7671ffc1e580a83a2af0d61nd <module>mod_proxy</module> and <module>mod_proxy_http</module>
b73a2be324e0b7fda7671ffc1e580a83a2af0d61nd have to be present in the server.</p>
b73a2be324e0b7fda7671ffc1e580a83a2af0d61nd href="mod_proxy.html#access">secured your server</a>. Open proxy
b73a2be324e0b7fda7671ffc1e580a83a2af0d61nd servers are dangerous both to your network and to the Internet at
b73a2be324e0b7fda7671ffc1e580a83a2af0d61nd large.</p>
3d5bba702bba34c9c15e4b2e3bc685e4249e51a5niq <p>In addition to the configuration directives that control the
3d5bba702bba34c9c15e4b2e3bc685e4249e51a5niq behaviour of <module>mod_proxy</module>, there are a number of
3d5bba702bba34c9c15e4b2e3bc685e4249e51a5niq <dfn>environment variables</dfn> that control the HTTP protocol
8775d48814768233a02ef1b564a02331ff782671covener provider. Environment variables below that don't specify specific values
8775d48814768233a02ef1b564a02331ff782671covener are enabled when set to any value.</p>
3d5bba702bba34c9c15e4b2e3bc685e4249e51a5niq <dd>Causes proxy to send an extra CR-LF newline on the end of a
a0dd9c437e3d11e11de853185e12b03028a2b980niq request. This is a workaround for a bug in some browsers.</dd>
3d5bba702bba34c9c15e4b2e3bc685e4249e51a5niq <dd>Forces the proxy to send requests to the backend as HTTP/1.0
3d5bba702bba34c9c15e4b2e3bc685e4249e51a5niq <dd>Forces the proxy to close the backend connection after
3d5bba702bba34c9c15e4b2e3bc685e4249e51a5niq each request.</dd>
3d5bba702bba34c9c15e4b2e3bc685e4249e51a5niq <dd>If the proxy requires authentication, it will read and
3d5bba702bba34c9c15e4b2e3bc685e4249e51a5niq consume the proxy authentication credentials sent by the client.
aeb8e2623144f9de6b5a77b01b76a385ed27a159rpluem With <var>proxy-chain-auth</var> it will <em>also</em> forward
3d5bba702bba34c9c15e4b2e3bc685e4249e51a5niq the credentials to the next proxy in the chain. This may
3d5bba702bba34c9c15e4b2e3bc685e4249e51a5niq be necessary if you have a chain of proxies that share
3d5bba702bba34c9c15e4b2e3bc685e4249e51a5niq authentication information. <strong>Security Warning:</strong>
3d5bba702bba34c9c15e4b2e3bc685e4249e51a5niq Do not set this unless you know you need it, as it forwards
3d5bba702bba34c9c15e4b2e3bc685e4249e51a5niq sensitive information!</dd>
3d5bba702bba34c9c15e4b2e3bc685e4249e51a5niq <dd>HTTP/1.0 required all HTTP requests that include a body
3d5bba702bba34c9c15e4b2e3bc685e4249e51a5niq (e.g. POST requests) to include a <var>Content-Length</var>
3d5bba702bba34c9c15e4b2e3bc685e4249e51a5niq header. This environment variable forces the Apache proxy to
3d5bba702bba34c9c15e4b2e3bc685e4249e51a5niq send this header to the backend server, regardless of what the
3d5bba702bba34c9c15e4b2e3bc685e4249e51a5niq Client sent to the proxy. It ensures compatibility when
3d5bba702bba34c9c15e4b2e3bc685e4249e51a5niq proxying for an HTTP/1.0 or unknown backend. However, it
3d5bba702bba34c9c15e4b2e3bc685e4249e51a5niq may require the entire request to be buffered by the proxy,
3d5bba702bba34c9c15e4b2e3bc685e4249e51a5niq so it becomes very inefficient for large requests.</dd>
3d5bba702bba34c9c15e4b2e3bc685e4249e51a5niq <dd>This is the opposite of <var>proxy-sendcl</var>. It allows
3d5bba702bba34c9c15e4b2e3bc685e4249e51a5niq request bodies to be sent to the backend using chunked transfer
3d5bba702bba34c9c15e4b2e3bc685e4249e51a5niq encoding. This allows the request to be efficiently streamed,
3d5bba702bba34c9c15e4b2e3bc685e4249e51a5niq but requires that the backend server supports HTTP/1.1.</dd>
fa4bc4198626704f98fcd06c9644aa41f64ad5f8igalic <dd>This variable takes values <code>RFC</code> (the default) or
c6f2d0c33368d0ff719e176c3bef9c2ea5177d43niq <code>Suppress</code>. Earlier httpd versions would suppress
c6f2d0c33368d0ff719e176c3bef9c2ea5177d43niq HTTP interim (1xx) responses sent from the backend. This is
c6f2d0c33368d0ff719e176c3bef9c2ea5177d43niq technically a violation of the HTTP protocol. In practice,
c6f2d0c33368d0ff719e176c3bef9c2ea5177d43niq if a backend sends an interim response, it may itself be
c6f2d0c33368d0ff719e176c3bef9c2ea5177d43niq extending the protocol in a manner we know nothing about,
c6f2d0c33368d0ff719e176c3bef9c2ea5177d43niq or just broken. So this is now configurable: set
c6f2d0c33368d0ff719e176c3bef9c2ea5177d43niq <code>proxy-interim-response RFC</code> to be fully protocol
c6f2d0c33368d0ff719e176c3bef9c2ea5177d43niq compliant, or <code>proxy-interim-response Suppress</code>
c6f2d0c33368d0ff719e176c3bef9c2ea5177d43niq to suppress interim responses.</dd>
83adf5bfebbca92456b367a2cea7d4a39a51d533covener <dd>If this variable is set, no pooled connection will be reused
83adf5bfebbca92456b367a2cea7d4a39a51d533covener if the client request is the initial request on the frontend connection. This avoids
f486d8cb300dbb998e5f626efc8d8b1c23558702rpluem the "proxy: error reading status line from remote server" error message
f486d8cb300dbb998e5f626efc8d8b1c23558702rpluem caused by the race condition that the backend server closed the
f486d8cb300dbb998e5f626efc8d8b1c23558702rpluem pooled connection after the connection check by the proxy and
7d8d640620e0673c40e65bfb222b2607edf4f4c7lgentis before data sent by the proxy reached the backend. It has to be
f486d8cb300dbb998e5f626efc8d8b1c23558702rpluem kept in mind that setting this variable downgrades performance,
df58c3a1c000d76859808ca4746a41623b432c81sf <p><module>mod_proxy_http</module> creates the following request notes for
df58c3a1c000d76859808ca4746a41623b432c81sf <directive module="mod_log_config">LogFormat</directive> or
df58c3a1c000d76859808ca4746a41623b432c81sf <dd>The local port used for the connection to the backend server.</dd>
df58c3a1c000d76859808ca4746a41623b432c81sf <dd>The HTTP status received from the backend server.</dd>
b73a2be324e0b7fda7671ffc1e580a83a2af0d61nd</modulesynopsis>