| <?xml version="1.0"?> |
| <!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd"> |
| <?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?> |
| <!-- English Revision : 1673932 --> |
| <!-- French translation : Lucien GENTIS --> |
| <!-- Reviewed by : Vincent Deffontaines --> |
| |
| <!-- |
| 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_asis.xml.meta"> |
| |
| <name>mod_asis</name> |
| <description>Envoie des fichiers contenant leurs propres en-têtes |
| HTTP</description> |
| <status>Base</status> |
| <sourcefile>mod_asis.c</sourcefile> |
| <identifier>asis_module</identifier> |
| |
| <summary> |
| <p>Ce module fournit le gestionnaire <code>send-as-is</code> qui |
| permet au serveur HTTP Apache d'envoyer le document sans ajouter la plupart des |
| en-têtes HTTP habituels.</p> |
| |
| <p>On peut l'utiliser pour envoyer tous types de données en |
| provenance du serveur, y compris les redirections et autres réponses |
| HTTP spéciales, sans devoir faire appel à un script CGI ou nph.</p> |
| |
| <p>Pour des raisons historiques, ce module traitera aussi tout |
| fichier dont le type MIME est <code>httpd/send-as-is</code>.</p> |
| </summary> |
| |
| <seealso><module>mod_headers</module></seealso> |
| <seealso><module>mod_cern_meta</module></seealso> |
| <seealso><a href="../handler.html">Utilisation des gestionnaires |
| d'Apache httpd</a></seealso> |
| |
| <section id="usage"><title>Mode d'emploi</title> |
| |
| <p>Dans le fichier de configuration, associez les fichiers asis au |
| gestionnaire <code>send-as-is</code> comme ceci :</p> |
| |
| <highlight language="config">AddHandler send-as-is asis</highlight> |
| |
| <p>Le contenu de tout fichier possédant l'extension |
| <code>.asis</code> sera envoyé par Apache httpd au client pratiquement tel |
| quel. En particulier, les en-têtes HTTP seront déduits du fichier |
| lui-même selon les règles du module <module>mod_cgi</module>, si |
| bien qu'un fichier asis doit inclure des en-têtes valides, et |
| utiliser l'en-tête CGI <code>Status:</code> pour déterminer le code de réponse |
| HTTP. L'en-tête <code>Content-Length:</code> sera automatiquement |
| inséré ou, s'il est déjà présent, corrigé par httpd.</p> |
| |
| <p>Voici un exemple de fichier dont le contenu est envoyé <em>tel |
| quel</em> pour informer un client qu'un fichier a été déplacé.</p> |
| |
| |
| <example> |
| Status: 301 Ou se trouve cette URL maintenant<br /> |
| Location: http://xyz.example.com/foo/bar.html<br /> |
| Content-type: text/html<br /> |
| <br /> |
| <html><br /> |
| <head><br /> |
| <title>Mauvaises excuses</title><br /> |
| </head><br /> |
| <body><br /> |
| <h1>La merveilleuse page de Fred a été déplacée vers<br /> |
| <a href="http://xyz.example.com/foo/bar.html">le site de |
| Joe</a>.<br /> |
| </h1><br /> |
| </body><br /> |
| </html> |
| </example> |
| |
| <note><title>Notes :</title> |
| <p>Le serveur ajoute systématiquement les en-têtes |
| <code>Date:</code> et <code>Server:</code> aux données qu'il envoie |
| au client, si bien qu'ils n'ont pas besoin d'être inclus dans le |
| fichier. Le serveur n'ajoute <em>pas</em> d'en-tête |
| <code>Last-Modified</code>, ce qu'il devrait probablement faire.</p> |
| </note> |
| </section> |
| |
| </modulesynopsis> |