mirror of
https://github.com/apache/httpd.git
synced 2025-07-30 20:03:10 +03:00
57ef10245b
containers. git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@1673892 13f79535-47bb-0310-9956-ffa450edef68
84 lines
3.1 KiB
XML
84 lines
3.1 KiB
XML
<?xml version="1.0"?>
|
|
<!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">
|
|
<?xml-stylesheet type="text/xsl" href="../style/manual.en.xsl"?>
|
|
<!-- $LastChangedRevision$ -->
|
|
|
|
<!--
|
|
Licensed to the Apache Software Foundation (ASF) under one or more
|
|
contributor license agreements. See the NOTICE file distributed with
|
|
this work for additional information regarding copyright ownership.
|
|
The ASF licenses this file to You under the Apache License, Version 2.0
|
|
(the "License"); you may not use this file except in compliance with
|
|
the License. You may obtain a copy of the License at
|
|
|
|
http://www.apache.org/licenses/LICENSE-2.0
|
|
|
|
Unless required by applicable law or agreed to in writing, software
|
|
distributed under the License is distributed on an "AS IS" BASIS,
|
|
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
See the License for the specific language governing permissions and
|
|
limitations under the License.
|
|
-->
|
|
|
|
<modulesynopsis metafile="mod_reflector.xml.meta">
|
|
|
|
<name>mod_reflector</name>
|
|
<description>Reflect a request body as a response via the output filter stack.</description>
|
|
<status>Base</status>
|
|
<sourcefile>mod_reflector.c</sourcefile>
|
|
<identifier>reflector_module</identifier>
|
|
<compatibility>Version 2.3 and later</compatibility>
|
|
|
|
<summary>
|
|
<p>This module allows request bodies to be reflected back to the
|
|
client, in the process passing the request through the output filter
|
|
stack. A suitably configured chain of filters can be used to transform
|
|
the request into a response. This module can be used to turn an output
|
|
filter into an HTTP service.</p>
|
|
</summary>
|
|
|
|
<section id="examples"><title>Examples</title>
|
|
<dl>
|
|
<dt>Compression service</dt>
|
|
<dd>Pass the request body through the DEFLATE filter to compress the
|
|
body. This request requires a Content-Encoding request header containing
|
|
"gzip" for the filter to return compressed data.
|
|
<highlight language="config">
|
|
<Location "/compress">
|
|
SetHandler reflector
|
|
SetOutputFilter DEFLATE
|
|
</Location>
|
|
</highlight>
|
|
</dd>
|
|
|
|
<dt>Image downsampling service</dt>
|
|
<dd>Pass the request body through an image downsampling filter, and reflect
|
|
the results to the caller.
|
|
<highlight language="config">
|
|
<Location "/downsample">
|
|
SetHandler reflector
|
|
SetOutputFilter DOWNSAMPLE
|
|
</Location>
|
|
</highlight>
|
|
</dd>
|
|
</dl>
|
|
</section>
|
|
|
|
<directivesynopsis>
|
|
<name>ReflectorHeader</name>
|
|
<description>Reflect an input header to the output headers</description>
|
|
<syntax>ReflectorHeader <var>inputheader</var> <var>[outputheader]</var></syntax>
|
|
<contextlist><context>server config</context><context>virtual host</context>
|
|
<context>directory</context><context>.htaccess</context></contextlist>
|
|
<override>Options</override>
|
|
|
|
<usage>
|
|
<p>This directive controls the reflection of request headers to the response.
|
|
The first argument is the name of the request header to copy. If the optional
|
|
second argument is specified, it will be used as the name of the response
|
|
header, otherwise the original request header name will be used.</p>
|
|
</usage>
|
|
</directivesynopsis>
|
|
|
|
</modulesynopsis>
|