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

   1 <?xml version="1.0" encoding="UTF-8" ?>
   2 <!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">
   3 <?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?>
   4 <!-- English Revision : 1778350 -->
   5 <!-- French translation : Lucien GENTIS -->
   6 <!-- $LastChangedRevision: 2017011401 $ -->
   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_fcgi.xml.meta">
  26
  27 <name>mod_proxy_fcgi</name>
  28 <description>Module fournissant le support de FastCGI à
  29 <module>mod_proxy</module></description>
  30 <status>Extension</status>
  31 <sourcefile>mod_proxy_fcgi.c</sourcefile>
  32 <identifier>proxy_fcgi_module</identifier>
  33 <compatibility>Disponible depuis la version 2.3 d'Apache</compatibility>
  34
  35 <summary>
  36     <p>Pour fonctionner, ce module <em>nécessite</em> le chargement de
  37     <module>mod_proxy</module>. Il fournit le support du protocole <a
  38     href="http://www.fastcgi.com/">FastCGI</a>.</p>
  39
  40     <p>Ainsi, pour pouvoir traiter le protocole <code>FastCGI</code>,
  41     <module>mod_proxy</module> et <module>mod_proxy_fcgi</module>
  42     doivent être chargés dans le serveur.</p>
  43
  44     <p>A la différence de <a
  45     href="http://httpd.apache.org/mod_fcgid/">mod_fcgid</a> et <a
  46     href="http://www.fastcgi.com/">mod_fastcgi</a>,
  47     <module>mod_proxy_fcgi</module> n'est pas en mesure de démarrer le
  48     processus de l'application ; <program>fcgistarter</program> est
  49     fourni à cet effet sur certaines plateformes. Le framework
  50     applicatif FastCGI utilisé peut aussi fournir la gestion des
  51     processus ou des lancements de programmes externes.</p>
  52
  53     <note type="warning"><title>Avertissement</title>
  54       <p>N'activez pas la fonctionnalité de mandataire avant d'avoir <a
  55       href="mod_proxy.html#access">sécurisé votre serveur</a>. Les
  56       serveurs mandataires ouverts sont dangereux non seulement pour
  57       votre réseau, mais aussi pour l'Internet au sens large.</p>
  58     </note>
  59 </summary>
  60
  61 <seealso><program>fcgistarter</program></seealso>
  62 <seealso><module>mod_proxy</module></seealso>
  63 <seealso><module>mod_authnz_fcgi</module></seealso>
  64
  65 <section id="examples"><title>Exemples</title>
  66     <p>Pour que ces exemples fonctionnent, vous ne devez pas oublier
  67     d'activer <module>mod_proxy</module> et
  68     <module>mod_proxy_fcgi</module>.</p>
  69
  70     <example><title>Instance d'application unique</title>
  71     <highlight language="config">
  72 ProxyPass "/mon_appli/" "fcgi://localhost:4000/"
  73       </highlight>
  74     </example>
  75
  76
  77     <p><module>mod_proxy_fcgi</module> interdisant par défaut la
  78     réutilisation des connexions, lorsqu'une requête a été traitée, la
  79     connexion ne sera pas maintenue ouverte par le processus enfant
  80     httpd, et ne sera donc pas réutilisée. Cependant, si l'application
  81     FastCGI supporte les connexions httpd simultanées, vous pouvez opter
  82     pour la réutilisation des connexions comme dans l'exemple suivant :</p>
  83
  84     <example><title>Instance d'application unique, réutilisation
  85     des connexions (versions 2.4.11 et supérieures)</title>
  86     <highlight language="config">
  87   ProxyPass "/myapp/" "fcgi://localhost:4000/" enablereuse=on
  88     </highlight>
  89     </example>
  90
  91     <p>Dans l'exemple suivant, l'URI de la requête est transmis en tant
  92     que chemin du système de fichiers pour l'exécution du démon PHP-FPM.
  93     L'URL de la requête est implicitement ajoutée au second paramètre.
  94     PHP-FPM est à l'écoute de l'hôte et du port qui
  95     suivent fcgi://. La conservation des connexions est activée.</p>
  96     <example><title>PHP-FPM</title>
  97     <highlight language="config">
  98 ProxyPassMatch "^/myapp/.*\.php(/.*)?$" "fcgi://localhost:9000/var/www/" enablereuse=on
  99     </highlight>
 100     </example>
 101
 102     <p>Dans l'exemple suivant, l'URI de la requête est transmis en tant
 103     que chemin du système de fichiers pour l'exécution du démon PHP-FPM.
 104     Dans ce cas cependant, PHP-FPM est à l'écoute d'un socket de domaine
 105     unix (UDS). Cette fonctionnalité est disponible à partir de la
 106     version 2.4.9. Avec cette syntaxe, si un nom d'hôte et un port sont
 107     ajoutés après fcgi://, ils seront ignorés.</p>
 108     <example><title>PHP-FPM with UDS</title>
 109     <highlight language="config">
 110 # A ce jour, UDS ne supporte pas la réutilisation des connexions
 111 ProxyPassMatch "^/(.*\.php(/.*)?)$" "unix:/var/run/php5-fpm.sock|fcgi://localhost/var/www/"
 112     </highlight>
 113     </example>
 114
 115     <p>La passerelle à répartition de charge nécessite le chargement du
 116     module <module>mod_proxy_balancer</module> et d'au moins un module
 117     fournissant un algorithme de répartition de charge, comme
 118     <module>mod_lbmethod_byrequests</module> en plus des modules
 119     déjà cités. <module>mod_lbmethod_byrequests</module> est le module
 120     par défaut et sera utilisé dans cet exemple de configuration.</p>
 121
 122     <example><title>Passerelle à répartition de charge vers plusieurs
 123     instances de l'application</title>
 124     <highlight language="config">
 125 ProxyPass "/myapp/" "balancer://myappcluster/"
 126 &lt;Proxy "balancer://myappcluster/"&gt;
 127     BalancerMember "fcgi://localhost:4000"
 128     BalancerMember "fcgi://localhost:4001"
 129 &lt;/Proxy&gt;
 130     </highlight>
 131     </example>
 132
 133     <p>Vous pouvez aussi forcer le traitement d'une requête en tant que
 134     requête de mandataire inverse en créant un court-circuiteur de
 135     gestionnaire approprié. Dans l'exemple ci-dessous, toutes les
 136     requêtes pour des scripts PHP seront transmises au serveur FastCGI
 137     spécifié par mandat inverse. Cette fonctionnalité est disponible à
 138     partir de la version 2.4.10 du serveur HTTP Apache. Pour des raisons
 139     de performances, il est recommandé de définir un <a
 140     href="mod_proxy.html#workers">worker (configuration d'un
 141     mandataire)</a> représentant le même serveur fcgi:// d'arrière-plan.
 142     Avec cette configuration, il est possible d'effectuer une
 143     correspondance directe entre l'URI et le chemin du fichier sur le
 144     serveur, et le chemin local du fichier sera alors transmis au serveur
 145     d'arrière-plan. Lorsque FastCGI est configuré ainsi, le serveur est
 146     en mesure de calculer le PATH_INFO le plus approprié.
 147       </p>
 148         <example><title>Mandataire via un gestionnaire</title>
 149       <highlight language="config">
 150 &lt;FilesMatch "\.php$"&gt;
 151     # Note : la seule partie variable est /path/to/app.sock
 152     SetHandler  "proxy:unix:/path/to/app.sock|fcgi://localhost/"
 153 &lt;/FilesMatch&gt;
 154    # Définition d'une configuration de mandataire qui convient.
 155    # La partie qui est mise en correspondance avec la valeur de
 156    # SetHandler est la partie qui suit le "pipe". Si vous devez faire
 157    # une distinction, "localhost" peut être changé en un nom de serveur
 158    # unique.
 159    &lt;Proxy fcgi://localhost/ enablereuse=on max=10&gt;
 160    &lt;/Proxy&gt;
 161
 162 &lt;FilesMatch ...&gt;
 163     SetHandler  "proxy:fcgi://localhost:9000"
 164 &lt;/FilesMatch&gt;
 165
 166 &lt;FilesMatch ...&gt;
 167     SetHandler  "proxy:balancer://myappcluster/"
 168 &lt;/FilesMatch&gt;
 169       </highlight>
 170    </example>
 171 </section>
 172
 173 <section id="env"><title>Variables d'environnement</title>
 174     <p>En plus des directives de configuration qui contrôlent le
 175     comportement de <module>mod_proxy</module>, de nombreuses
 176     <dfn>variables d'environnement</dfn> permettent de piloter le
 177     fournisseur du protocole FCGI :</p>
 178     <dl>
 179         <dt>proxy-fcgi-pathinfo</dt>
 180         <dd>Par défaut, <module>mod_proxy_fcgi</module> ne créera jamais
 181         ni n'exportera la variable d'environnement <var>PATH_INFO</var>,
 182         ce qui permet au serveur FCGI d'arrière-plan de déterminer
 183         correctement <var>SCRIPT_NAME</var> et <var>Script-URI</var>, et
 184         de se conformer à la section 3.3 de la RFC 3875. Si au contraire
 185         vous avez souhaitez que <module>mod_proxy_fcgi</module> génère une
 186         "estimation la plus exacte possible" de <var>PATH_INFO</var>,
 187         définissez la variable d'environnement
 188         <var>proxy-fcgi-pathinfo</var>. Ceci peut servir de
 189         contournement pour une bogue présente dans certaines
 190         implémentations de FCGI. Cette variable peut être
 191         multivaluée afin de pouvoir choisir la valeur la plus appropriée
 192         (versions 2.4.11 et supérieures) :
 193         <dl>
 194           <dt>first-dot</dt>
 195           <dd>PATH_INFO est extrait à partir du slash qui suit le
 196           <em>premier</em> "." de l'URL.</dd>
 197           <dt>last-dot</dt>
 198           <dd>PATH_INFO est extrait à partir du slash qui suit le
 199           <em>dernier</em> "." de l'URL.</dd>
 200           <dt>full</dt>
 201           <dd>PATH_INFO est calculé en supposant que l'URL correspond au
 202           chemin du système de fichiers.</dd>
 203           <dt>unescape</dt>
 204           <dd>PATH_INFO correspond à la partie chemin de l'URL avec ses
 205           séquences d'échappement décodées.</dd>
 206           <dt>toute autre valeur</dt>
 207           <dd>PATH_INFO correspond à la partie chemin de l'URL.
 208               Auparavant, c'était la seule option pour proxy-fcgi-pathinfo.</dd>
 209          </dl>
 210         </dd>
 211     </dl>
 212 </section>
 213
 214 <directivesynopsis>
 215 <name>ProxyFCGIBackendType</name>
 216 <description>Spécifie le type de l'application FastCGI d'arrière-plan</description>
 217 <syntax>ProxyFCGIBackendType FPM|GENERIC</syntax>
 218 <default>ProxyFCGIBackendType FPM</default>
 219 <contextlist><context>server config</context>
 220 <context>virtual host</context><context>directory</context>
 221 <context>.htaccess</context></contextlist>
 222 <compatibility>Disponible à partir de la version 2.5 du serveur HTTP Apache</compatibility>
 223
 224 <usage>
 225 <p>Cette directive permet de spécifier le type de l'application FastCGI
 226 d'arrière-plan. Certains serveurs FastCGI, comme PHP-FPM, utilisent de manière
 227 historique des variables d'environnement exotiques pour identifier le type du
 228 serveur mandataire utilisé. Définissez cette directive à "GENERIC" si votre
 229 application n'est pas de type PHP-FPM et n'interpréter pas correctement des
 230 variables d'environnement comme SCRIPT_FILENAME ou PATH_TRANSLATED telles
 231 qu'elles sont définies par le serveur.</p>
 232
 233 <p>SCRIPT_FILENAME est un exemple de valeur modifiée par la définition de cette
 234 directive. Historiquement, lorsqu'on utilisait le module
 235 <module>mod_proxy_fcgi</module>, SCRIPT_FILENAME était préfixé par la chaîne
 236 "proxy:fcgi://". C'est cette variable que lisent certaines applications FastCGI
 237 génériques en tant que valeur en entrée pour leur script ; cependant, PHP-FPM
 238 peut supprimer le préfixe, puis garder en mémoire qu'il communique avec Apache.
 239 Avec les versions 2.4.21 à 2.4.25, ce préfixe était automatiquement supprimé par
 240 le serveur, empêchant ainsi PHP-FPM de détecter et interopérer avec Apache dans
 241 certains scénarios.</p>
 242 </usage>
 243 </directivesynopsis>
 244
 245 </modulesynopsis>