granicus.if.org Git - apache/blob - docs/manual/mod/mod_proxy_scgi.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: 1589417:1672484 (outdated) -->
   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_proxy_scgi.xml.meta">
  26
  27 <name>mod_proxy_scgi</name>
  28 <description>Module fournissant le support de la passerelle SCGI &agrave;
  29 <module>mod_proxy</module></description>
  30 <status>Extension</status>
  31 <sourcefile>mod_proxy_scgi.c</sourcefile>
  32 <identifier>proxy_scgi_module</identifier>
  33 <compatibility>Disponible depuis la version 2.2.14 d'Apache</compatibility>
  34
  35 <summary>
  36     <p>Pour pouvoir fonctionner, ce module <em>requiert</em> le
  37     chargement de <module>mod_proxy</module>. Il fournit le support du
  38     <a href="http://python.ca/scgi/protocol.txt">protocole SCGI, version
  39     1</a>.</p>
  40
  41     <p>Ainsi, pour &ecirc;tre en mesure de traiter le protocole SCGI,
  42     <module>mod_proxy</module> et <module>mod_proxy_scgi</module>
  43     doivent &ecirc;tre charg&eacute;s dans le serveur.</p>
  44
  45     <note type="warning"><title>Avertissement</title>
  46       <p>N'activez pas la fonctionnalit&eacute; de mandataire avant d'avoir <a
  47       href="mod_proxy.html#access">s&eacute;curis&eacute; votre serveur</a>. Les
  48       serveurs mandataires ouverts sont dangereux non seulement pour
  49       votre r&eacute;seau, mais aussi pour l'Internet au sens large.</p>
  50     </note>
  51 </summary>
  52
  53 <seealso><module>mod_proxy</module></seealso>
  54 <seealso><module>mod_proxy_balancer</module></seealso>
  55
  56 <section id="examples"><title>Exemples</title>
  57     <p>Rappelez-vous, pour que les exemples suivants puissent
  58     fonctionner, vous devez activer <module>mod_proxy</module> et
  59     <module>mod_proxy_scgi</module>.</p>
  60
  61     <example><title>Passerelle simple</title>
  62     <highlight language="config">
  63       ProxyPass /scgi-bin/ scgi://localhost:4000/
  64       </highlight>
  65     </example>
  66
  67     <p>La passerelle &agrave; r&eacute;partition de charge n&eacute;cessite le chargement du
  68     module <module>mod_proxy_balancer</module> et d'au moins un module
  69     fournissant un algorithme de r&eacute;partition de charge, comme
  70     <module>mod_lbmethod_byrequests</module> en plus des modules
  71     d&eacute;j&agrave; cit&eacute;s. <module>mod_lbmethod_byrequests</module> est le module
  72     par d&eacute;faut et sera utilis&eacute; dans cet exemple de configuration.</p>
  73
  74     <example><title>Passerelle &agrave; r&eacute;partition de charge</title>
  75     <highlight language="config">
  76 ProxyPass /scgi-bin/ balancer://somecluster/
  77 &lt;Proxy balancer://somecluster&gt;
  78     BalancerMember scgi://localhost:4000
  79     BalancerMember scgi://localhost:4001
  80 &lt;/Proxy&gt;
  81     </highlight>
  82     </example>
  83 </section>
  84
  85 <section id="env"><title>Variables d'environnement</title>
  86     <p>En plus des directives de configuration qui permettent de
  87     contr&ocirc;ler le comportement de <module>mod_proxy</module>, de
  88     nombreuses <dfn>variables d'environnement</dfn> permettent de
  89     contr&ocirc;ler le fournisseur de protocole SCGI :</p>
  90     <dl>
  91         <dt>proxy-scgi-pathinfo</dt>
  92         <dd>Par d&eacute;faut, <module>mod_proxy_scgi</module> ne cr&eacute;era ni
  93         exportera jamais la variable d'environnement
  94         <var>PATH_INFO</var>. Ceci permet au serveur SCGI d'arri&egrave;re-plan
  95         de d&eacute;terminer correctement <var>SCRIPT_NAME</var> et
  96         <var>Script-URI</var>, et de rester en conformit&eacute; avec la section
  97         3.3 de la RFC 3875. Si au contraire vous souhaitez que
  98         <module>mod_proxy_scgi</module> g&eacute;n&egrave;re une estimation la plus
  99         pr&eacute;cise possible de <var>PATH_INFO</var>, d&eacute;finissez cette
 100         variable d'environnement.</dd>
 101     </dl>
 102 </section>
 103
 104 <directivesynopsis>
 105 <name>ProxySCGISendfile</name>
 106 <description>Active l'&eacute;valuation du pseudo en-t&ecirc;te de r&eacute;ponse
 107 <var>X-Sendfile</var></description>
 108 <syntax>ProxySCGISendfile On|Off|<var>nom-en-t&ecirc;te</var></syntax>
 109 <default>ProxySCGISendfile Off</default>
 110 <contextlist><context>server config</context><context>virtual host</context>
 111 <context>directory</context></contextlist>
 112
 113 <usage>
 114     <p>La directive <directive>ProxySCGISendfile</directive> permet au
 115     serveur cible SCGI de faire servir les fichiers directement par la
 116     passerelle. Ceci s'av&egrave;re b&eacute;n&eacute;fique en
 117     mati&egrave;re de performances &mdash;
 118     httpd peut alors utiliser <code>sendfile</code> ou d'autres
 119     optimisations, ce qui n'est pas possible si les fichiers passent par
 120     la socket du serveur cible. En outre, les fichiers ne sont transmis
 121     qu'une seule fois.</p>
 122     <p>L'argument de la directive
 123     <directive>ProxySCGISendfile</directive> d&eacute;termine le comportement
 124     de la passerelle :</p>
 125     <dl>
 126     <dt><code>Off</code></dt>
 127     <dd>Aucun traitement particulier n'est effectu&eacute;.</dd>
 128
 129     <dt><code>On</code></dt>
 130     <dd>La passerelle recherche un en-t&ecirc;te dans la r&eacute;ponse du serveur
 131     cible nomm&eacute; <code>X-Sendfile</code>, et interpr&egrave;te sa valeur comme
 132     le nom du fichier &agrave; servir. L'en-t&ecirc;te est ensuite supprim&eacute; de la
 133     r&eacute;ponse finale. Cet argument produit le m&ecirc;me effet que
 134     <code>ProxySCGISendfile X-Sendfile</code>.</dd>
 135
 136     <dt>toute autre valeur</dt>
 137     <dd>Identique &agrave; <code>On</code>, mais au lieu de rechercher le nom
 138     d'en-t&ecirc;te cod&eacute; en dur <code>X-Sendfile</code>, c'est la
 139     valeur de l'argument qui constitue le nom de l'en-t&ecirc;te
 140     &agrave; rechercher.</dd>
 141     </dl>
 142
 143     <example><title>Exemple</title>
 144     <highlight language="config">
 145     # Utilise le nom d'en-t&ecirc;te par d&eacute;faut (X-Sendfile)
 146     ProxySCGISendfile On
 147
 148     # Utilise un nom d'en-t&ecirc;te diff&eacute;rent
 149     ProxySCGISendfile X-Send-Static
 150     </highlight>
 151     </example>
 152 </usage>
 153 </directivesynopsis>
 154
 155 <directivesynopsis>
 156 <name>ProxySCGIInternalRedirect</name>
 157 <description>Active ou d&eacute;sactive les r&eacute;ponses de redirection interne en
 158 provenance du serveur cible.</description>
 159 <syntax>ProxySCGIInternalRedirect On|Off</syntax>
 160 <default>ProxySCGIInternalRedirect On</default>
 161 <contextlist><context>server config</context><context>virtual host</context>
 162 <context>directory</context></contextlist>
 163
 164 <usage>
 165     <p>La directive <directive>ProxySCGIInternalRedirect</directive>
 166     permet au serveur cible de rediriger en interne la passerelle vers
 167     une URL diff&eacute;rente. Cette fonctionnalit&eacute; trouve son origine dans
 168     <module>mod_cgi</module> qui redirige la r&eacute;ponse en interne si
 169     l'&eacute;tat de la r&eacute;ponse est <code>OK</code> (<code>200</code>), et si
 170     la r&eacute;ponse contient un en-t&ecirc;te <code>Location</code> dont la valeur
 171     d&eacute;bute par un slash (<code>/</code>). Cette valeur est interpr&eacute;t&eacute;e
 172     comme une nouvelle URL locale vers laquelle Apache httpd effectue sa
 173     redirection.</p>
 174
 175     <p>De ce point de vue, <module>mod_proxy_scgi</module> fait la m&ecirc;me
 176     chose que <module>mod_cgi</module>, mais vous pouvez en plus
 177     d&eacute;sactiver la fonctionnalit&eacute;.</p>
 178
 179     <example><title>Exemple</title>
 180     <highlight language="config">
 181     ProxySCGIInternalRedirect Off
 182     </highlight>
 183     </example>
 184 </usage>
 185 </directivesynopsis>
 186
 187 </modulesynopsis>