granicus.if.org Git - apache/blob - docs/manual/mod/mod_asis.xml.fr

   1 <?xml version="1.0"?>
   2 <!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">
   3 <?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?>
   4 <!-- English Revision : 1330911 -->
   5 <!-- French translation : Lucien GENTIS -->
   6 <!-- Reviewed by : Vincent Deffontaines -->
   7
   8 <!--
   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
  15
  16      http://www.apache.org/licenses/LICENSE-2.0
  17
  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.
  23 -->
  24
  25 <modulesynopsis metafile="mod_asis.xml.meta">
  26
  27 <name>mod_asis</name>
  28 <description>Envoie des fichiers contenant leurs propres en-t&ecirc;tes
  29 HTTP</description>
  30 <status>Base</status>
  31 <sourcefile>mod_asis.c</sourcefile>
  32 <identifier>asis_module</identifier>
  33
  34 <summary>
  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&ecirc;tes HTTP habituels.</p>
  38
  39     <p>On peut l'utiliser pour envoyer tous types de donn&eacute;es en
  40     provenance du serveur, y compris les redirections et autres r&eacute;ponses
  41     HTTP sp&eacute;ciales, sans devoir faire appel &agrave; un script CGI ou nph.</p>
  42
  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>
  45 </summary>
  46
  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>
  51
  52 <section id="usage"><title>Mode d'emploi</title>
  53
  54     <p>Dans le fichier de configuration, associez les fichiers asis au
  55     gestionnaire <code>send-as-is</code> comme ceci :</p>
  56
  57     <highlight language="config">AddHandler send-as-is asis</highlight>
  58
  59     <p>Le contenu de tout fichier poss&eacute;dant l'extension
  60     <code>.asis</code> sera envoy&eacute; par Apache httpd au client pratiquement tel
  61     quel. En particulier, les en-t&ecirc;tes HTTP seront d&eacute;duits du fichier
  62     lui-m&ecirc;me selon les r&egrave;gles du module <module>mod_cgi</module>, si
  63     bien qu'un fichier asis doit inclure des en-t&ecirc;tes valides, et
  64     utiliser l'en-t&ecirc;te CGI <code>Status:</code> pour d&eacute;terminer le code de r&eacute;ponse
  65     HTTP. L'en-t&ecirc;te <code>Content-Length:</code> sera automatiquement
  66     ins&eacute;r&eacute; ou, s'il est d&eacute;j&agrave; pr&eacute;sent, corrig&eacute; par httpd.</p>
  67
  68     <p>Voici un exemple de fichier dont le contenu est envoy&eacute; <em>tel
  69     quel</em> pour informer un client qu'un fichier a &eacute;t&eacute; d&eacute;plac&eacute;.</p>
  70
  71
  72     <example>
  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 />
  76       <br />
  77       &lt;html&gt;<br />
  78       &lt;head&gt;<br />
  79       &lt;title&gt;Mauvaises excuses&lt;/title&gt;<br />
  80       &lt;/head&gt;<br />
  81       &lt;body&gt;<br />
  82       &lt;h1&gt;La merveilleuse page de Fred a &eacute;t&eacute; d&eacute;plac&eacute;e vers<br />
  83       &lt;a href="http://xyz.example.com/foo/bar.html"&gt;le site de
  84       Joe&lt;/a&gt;.<br />
  85       &lt;/h1&gt;<br />
  86       &lt;/body&gt;<br />
  87       &lt;/html&gt;
  88     </example>
  89
  90     <note><title>Notes :</title>
  91     <p>Le serveur ajoute syst&eacute;matiquement les en-t&ecirc;tes
  92     <code>Date:</code> et <code>Server:</code> aux donn&eacute;es qu'il envoie
  93     au client, si bien qu'ils n'ont pas besoin d'&ecirc;tre inclus dans le
  94     fichier. Le serveur n'ajoute <em>pas</em> d'en-t&ecirc;te
  95     <code>Last-Modified</code>, ce qu'il devrait probablement faire.</p>
  96     </note>
  97 </section>
  98
  99 </modulesynopsis>