2 <!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">
3 <?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?>
4 <!-- English Revision : 1673932 -->
5 <!-- French translation : Lucien GENTIS -->
6 <!-- Reviewed by : Vincent Deffontaines -->
9 Licensed to the Apache Software Foundation (ASF) under one or more
10 contributor license agreements. See the NOTICE file distributed with
11 this work for additional information regarding copyright ownership.
12 The ASF licenses this file to You under the Apache License, Version 2.0
13 (the "License"); you may not use this file except in compliance with
14 the License. You may obtain a copy of the License at
16 http://www.apache.org/licenses/LICENSE-2.0
18 Unless required by applicable law or agreed to in writing, software
19 distributed under the License is distributed on an "AS IS" BASIS,
20 WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
21 See the License for the specific language governing permissions and
22 limitations under the License.
25 <modulesynopsis metafile="mod_asis.xml.meta">
28 <description>Envoie des fichiers contenant leurs propres en-têtes
31 <sourcefile>mod_asis.c</sourcefile>
32 <identifier>asis_module</identifier>
35 <p>Ce module fournit le gestionnaire <code>send-as-is</code> qui
36 permet au serveur HTTP Apache d'envoyer le document sans ajouter la plupart des
37 en-têtes HTTP habituels.</p>
39 <p>On peut l'utiliser pour envoyer tous types de données en
40 provenance du serveur, y compris les redirections et autres réponses
41 HTTP spéciales, sans devoir faire appel à un script CGI ou nph.</p>
43 <p>Pour des raisons historiques, ce module traitera aussi tout
44 fichier dont le type MIME est <code>httpd/send-as-is</code>.</p>
47 <seealso><module>mod_headers</module></seealso>
48 <seealso><module>mod_cern_meta</module></seealso>
49 <seealso><a href="../handler.html">Utilisation des gestionnaires
50 d'Apache httpd</a></seealso>
52 <section id="usage"><title>Mode d'emploi</title>
54 <p>Dans le fichier de configuration, associez les fichiers asis au
55 gestionnaire <code>send-as-is</code> comme ceci :</p>
57 <highlight language="config">AddHandler send-as-is asis</highlight>
59 <p>Le contenu de tout fichier possédant l'extension
60 <code>.asis</code> sera envoyé par Apache httpd au client pratiquement tel
61 quel. En particulier, les en-têtes HTTP seront déduits du fichier
62 lui-même selon les règles du module <module>mod_cgi</module>, si
63 bien qu'un fichier asis doit inclure des en-têtes valides, et
64 utiliser l'en-tête CGI <code>Status:</code> pour déterminer le code de réponse
65 HTTP. L'en-tête <code>Content-Length:</code> sera automatiquement
66 inséré ou, s'il est déjà présent, corrigé par httpd.</p>
68 <p>Voici un exemple de fichier dont le contenu est envoyé <em>tel
69 quel</em> pour informer un client qu'un fichier a été déplacé.</p>
73 Status: 301 Ou se trouve cette URL maintenant<br />
74 Location: http://xyz.example.com/foo/bar.html<br />
75 Content-type: text/html<br />
79 <title>Mauvaises excuses</title><br />
82 <h1>La merveilleuse page de Fred a été déplacée vers<br />
83 <a href="http://xyz.example.com/foo/bar.html">le site de
90 <note><title>Notes :</title>
91 <p>Le serveur ajoute systématiquement les en-têtes
92 <code>Date:</code> et <code>Server:</code> aux données qu'il envoie
93 au client, si bien qu'ils n'ont pas besoin d'être inclus dans le
94 fichier. Le serveur n'ajoute <em>pas</em> d'en-tête
95 <code>Last-Modified</code>, ce qu'il devrait probablement faire.</p>