mod_asis.xml revision 5f5d1b4cc970b7f06ff8ef6526128e9a27303d88
5ca6c5dacac07297bb0b2162fa8f58f5b073d8d7maudj<!DOCTYPE modulesynopsis SYSTEM "/style/modulesynopsis.dtd">
5ca6c5dacac07297bb0b2162fa8f58f5b073d8d7maudj<?xml-stylesheet type="text/xsl" href="/style/manual.en.xsl"?>
5ca6c5dacac07297bb0b2162fa8f58f5b073d8d7maudj<!-- $LastChangedRevision$ -->
5ca6c5dacac07297bb0b2162fa8f58f5b073d8d7maudj Copyright 2002-2004 The Apache Software Foundation
5ca6c5dacac07297bb0b2162fa8f58f5b073d8d7maudj Licensed under the Apache License, Version 2.0 (the "License");
5ca6c5dacac07297bb0b2162fa8f58f5b073d8d7maudj you may not use this file except in compliance with the License.
5ca6c5dacac07297bb0b2162fa8f58f5b073d8d7maudj You may obtain a copy of the License at
5ca6c5dacac07297bb0b2162fa8f58f5b073d8d7maudj Unless required by applicable law or agreed to in writing, software
5ca6c5dacac07297bb0b2162fa8f58f5b073d8d7maudj distributed under the License is distributed on an "AS IS" BASIS,
5ca6c5dacac07297bb0b2162fa8f58f5b073d8d7maudj WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
5ca6c5dacac07297bb0b2162fa8f58f5b073d8d7maudj See the License for the specific language governing permissions and
5ca6c5dacac07297bb0b2162fa8f58f5b073d8d7maudj limitations under the License.
5ca6c5dacac07297bb0b2162fa8f58f5b073d8d7maudj<description>Sends files that contain their own
5ca6c5dacac07297bb0b2162fa8f58f5b073d8d7maudjHTTP headers</description>
5ca6c5dacac07297bb0b2162fa8f58f5b073d8d7maudj <p>This module provides the handler <code>send-as-is</code>
5ca6c5dacac07297bb0b2162fa8f58f5b073d8d7maudj which causes Apache to send the document without adding most of
5ca6c5dacac07297bb0b2162fa8f58f5b073d8d7maudj the usual HTTP headers.</p>
5ca6c5dacac07297bb0b2162fa8f58f5b073d8d7maudj <p>This can be used to send any kind of data from the server,
5ca6c5dacac07297bb0b2162fa8f58f5b073d8d7maudj including redirects and other special HTTP responses, without
5ca6c5dacac07297bb0b2162fa8f58f5b073d8d7maudj requiring a cgi-script or an nph script.</p>
5ca6c5dacac07297bb0b2162fa8f58f5b073d8d7maudj <p>For historical reasons, this module will also process any
5ca6c5dacac07297bb0b2162fa8f58f5b073d8d7maudj file with the mime type <code>httpd/send-as-is</code>.</p>
5ca6c5dacac07297bb0b2162fa8f58f5b073d8d7maudj<seealso><a href="/handler.html">Apache's Handler Use</a></seealso>
5ca6c5dacac07297bb0b2162fa8f58f5b073d8d7maudj <p>In the server configuration file, associate files with the
7a9377c735308afe55faff5f0ad1cba971646cd4gary.williams <p>The contents of any file with a <code>.asis</code> extension
5ca6c5dacac07297bb0b2162fa8f58f5b073d8d7maudj will then be sent by Apache to the client with almost no
5ca6c5dacac07297bb0b2162fa8f58f5b073d8d7maudj changes. Clients will need HTTP headers to be attached, so do
5ca6c5dacac07297bb0b2162fa8f58f5b073d8d7maudj not forget them. A Status: header is also required; the data
5ca6c5dacac07297bb0b2162fa8f58f5b073d8d7maudj should be the 3-digit HTTP response code, followed by a textual
5ca6c5dacac07297bb0b2162fa8f58f5b073d8d7maudj message.</p>
5ca6c5dacac07297bb0b2162fa8f58f5b073d8d7maudj <p>Here's an example of a file whose contents are sent <em>as
5ca6c5dacac07297bb0b2162fa8f58f5b073d8d7maudj is</em> so as to tell the client that a file has
5ca6c5dacac07297bb0b2162fa8f58f5b073d8d7maudj redirected.</p>
5ca6c5dacac07297bb0b2162fa8f58f5b073d8d7maudj Status: 301 Now where did I leave that URL<br />
5ca6c5dacac07297bb0b2162fa8f58f5b073d8d7maudj <html><br />
7a9377c735308afe55faff5f0ad1cba971646cd4gary.williams <head><br />
5ca6c5dacac07297bb0b2162fa8f58f5b073d8d7maudj <title>Lame excuses'R'us</title><br />
5ca6c5dacac07297bb0b2162fa8f58f5b073d8d7maudj </head><br />
5ca6c5dacac07297bb0b2162fa8f58f5b073d8d7maudj <body><br />
5ca6c5dacac07297bb0b2162fa8f58f5b073d8d7maudj <h1>Fred's exceptionally wonderful page has moved to<br />
5ca6c5dacac07297bb0b2162fa8f58f5b073d8d7maudj <a href="http://xyz.abc.com/foo/bar.html">Joe's</a>
5ca6c5dacac07297bb0b2162fa8f58f5b073d8d7maudj site.<br />
5ca6c5dacac07297bb0b2162fa8f58f5b073d8d7maudj </h1><br />
5ca6c5dacac07297bb0b2162fa8f58f5b073d8d7maudj </body><br />
5ca6c5dacac07297bb0b2162fa8f58f5b073d8d7maudj </html>
5ca6c5dacac07297bb0b2162fa8f58f5b073d8d7maudj <p>The server always adds a <code>Date:</code> and <code>Server:</code>
5ca6c5dacac07297bb0b2162fa8f58f5b073d8d7maudj header to the data returned to the client, so these should not be
7a9377c735308afe55faff5f0ad1cba971646cd4gary.williams included in the file. The server does <em>not</em> add a
75e4d72341a69fa125aeab6e326e49a5422a9eaccsovant <code>Last-Modified</code> header; it probably should.</p>
5ca6c5dacac07297bb0b2162fa8f58f5b073d8d7maudj</modulesynopsis>