<!DOCTYPE html SYSTEM "about:legacy-compat">
<html lang="fr"><head><META http-equiv="Content-Type" content="text/html; charset=UTF-8">
<meta content="width=device-width, initial-scale=1" name="viewport">
<!--
        XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
              This file is generated from xml source: DO NOT EDIT
        XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
      -->
<title>mod_proxy_fcgi - Serveur HTTP Apache Version 2.4</title>
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
<script src="../style/scripts/prettify.min.js">
</script>

<link href="../images/favicon.png" rel="shortcut icon"></head>
<body>
<div id="page-header">
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Signaler un bug</a></p>
<p class="apache">Serveur HTTP Apache Version 2.4</p>
<img alt="" src="../images/feather.png"></div>
<div class="up"><a href="./"><img title="<-" alt="<-" src="../images/left.gif"></a></div>
<div id="path">
<a href="https://www.apache.org/">Apache</a> &gt; <a href="https://httpd.apache.org/">Serveur HTTP</a> &gt; <a href="https://httpd.apache.org/docs/">Documentation</a> &gt; <a href="../">Version 2.4</a> &gt; <a href="./">Modules</a></div>
<div id="page-content">
<div id="preamble"><h1>Module Apache mod_proxy_fcgi</h1>
<button aria-label="Toggle language list" class="lang-toggle"><svg xmlns="http://www.w3.org/2000/svg" stroke-width="2" stroke="currentColor" fill="none" viewBox="0 0 24 24" height="16" width="16"><circle r="10" cy="12" cx="12"/><line y2="12" x2="22" y1="12" x1="2"/><path d="M12 2a15.3 15.3 0 0 1 4 10 15.3 15.3 0 0 1-4 10 15.3 15.3 0 0 1-4-10 15.3 15.3 0 0 1 4-10z"/></svg></button>
<div class="toplang">
<p><span>Langues Disponibles: </span><a href="../en/mod/mod_proxy_fcgi.html" hreflang="en" rel="alternate" title="English">&nbsp;en&nbsp;</a> |
<a href="../fr/mod/mod_proxy_fcgi.html" title="Fran&ccedil;ais">&nbsp;fr&nbsp;</a></p>
</div>
<table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Module fournissant le support de FastCGI &agrave;
<code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code></td></tr>
<tr><th><a href="module-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
<tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur&nbsp;de&nbsp;Module:</a></th><td>proxy_fcgi_module</td></tr>
<tr><th><a href="module-dict.html#SourceFile">Fichier&nbsp;Source:</a></th><td>mod_proxy_fcgi.c</td></tr>
<tr><th><a href="module-dict.html#Compatibility">Compatibilit&eacute;:</a></th><td>Disponible depuis la version 2.3 d'Apache</td></tr></table>
<h3>Sommaire</h3>

    <p>Pour fonctionner, ce module <em>n&eacute;cessite</em> le chargement de
    <code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code>. Il fournit le support du protocole <a href="https://fastcgi-archives.github.io/">FastCGI</a>.</p>

    <p>Ainsi, pour pouvoir traiter le protocole <code>FastCGI</code>,
    <code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code> et <code class="module"><a href="../mod/mod_proxy_fcgi.html">mod_proxy_fcgi</a></code>
    doivent &ecirc;tre charg&eacute;s dans le serveur.</p>

    <p>A la diff&eacute;rence de <a href="http://httpd.apache.org/mod_fcgid/">mod_fcgid</a>,
    <code class="module"><a href="../mod/mod_proxy_fcgi.html">mod_proxy_fcgi</a></code> n'est pas en mesure de d&eacute;marrer le
    processus de l'application ; <code class="program"><a href="../programs/fcgistarter.html">fcgistarter</a></code> est
    fourni &agrave; cet effet sur certaines plateformes. Le framework
    applicatif FastCGI utilis&eacute; peut aussi fournir la gestion des
    processus ou des lancements de programmes externes.</p>

    <div class="warning"><h3>Avertissement</h3>
      <p>N'activez pas la fonctionnalit&eacute; de mandataire avant d'avoir <a href="mod_proxy.html#access">s&eacute;curis&eacute; votre serveur</a>. Les
      serveurs mandataires ouverts sont dangereux non seulement pour
      votre r&eacute;seau, mais aussi pour l'Internet au sens large.</p>
    </div>
</div>
<div id="quickview"><h3>Sujets</h3>
<ul id="topics">
<li><img alt="" src="../images/down.gif"> <a href="#examples">Exemples</a></li>
<li><img alt="" src="../images/down.gif"> <a href="#env">Variables d'environnement</a></li>
</ul><h3 class="directives">Directives</h3>
<ul id="toc">
<li><img alt="" src="../images/down.gif"> <a href="#proxyfcgibackendtype">ProxyFCGIBackendType</a></li>
<li><img alt="" src="../images/down.gif"> <a href="#proxyfcgisetenvif">ProxyFCGISetEnvIf</a></li>
</ul>
<h3>Traitement des bugs</h3><ul class="seealso"><li><a href="https://www.apache.org/dist/httpd/CHANGES_2.4">Journal des modifications de httpd</a></li><li><a href="https://bz.apache.org/bugzilla/buglist.cgi?bug_status=__open__&amp;list_id=144532&amp;product=Apache%20httpd-2&amp;query_format=specific&amp;order=changeddate%20DESC%2Cpriority%2Cbug_severity&amp;component=mod_proxy_fcgi">Probl&egrave;mes connus</a></li><li><a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2&amp;component=mod_proxy_fcgi">Signaler un bug</a></li></ul><h3>Voir aussi</h3>
<ul class="seealso">
<li><code class="program"><a href="../programs/fcgistarter.html">fcgistarter</a></code></li>
<li><code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code></li>
<li><code class="module"><a href="../mod/mod_authnz_fcgi.html">mod_authnz_fcgi</a></code></li>
</ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
<h2 id="examples">Exemples <a title="Lien permanent" href="#examples" class="permalink">&para;</a></h2>
    <p>Pour que ces exemples fonctionnent, vous ne devez pas oublier
    d'activer <code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code> et
    <code class="module"><a href="../mod/mod_proxy_fcgi.html">mod_proxy_fcgi</a></code>.</p>

    <div class="example"><h3>Instance d'application unique</h3><pre class="prettyprint lang-config">ProxyPass "/mon_appli/" "fcgi://localhost:4000/"</pre>
</div>

    
    <p><code class="module"><a href="../mod/mod_proxy_fcgi.html">mod_proxy_fcgi</a></code> interdisant par d&eacute;faut la
    r&eacute;utilisation des connexions, lorsqu'une requ&ecirc;te a &eacute;t&eacute; trait&eacute;e, la
    connexion ne sera pas maintenue ouverte par le processus enfant
    httpd, et ne sera donc pas r&eacute;utilis&eacute;e. Cependant, si l'application
    FastCGI supporte les connexions httpd simultan&eacute;es, vous pouvez opter
    pour la r&eacute;utilisation des connexions comme dans l'exemple suivant :</p>

    <div class="example"><h3>Instance d'application unique, r&eacute;utilisation
    des connexions (versions 2.4.11 et sup&eacute;rieures)</h3><pre class="prettyprint lang-config">ProxyPass "/myapp/" "fcgi://localhost:4000/" enablereuse=on</pre>
</div>

    <div class="note"><h3>Active la r&eacute;utilisation des connexions vers un serveur FCGI
    d'arri&egrave;re-plan tel que PHP-FPM</h3>
    <p>Il faut garder &agrave; l'esprit que PHP-FPM (en f&eacute;vrier 2018) utilise un mod&egrave;le
    du style prefork ; autrement dit, chacun de ses processus de travail ne peut
    g&eacute;rer qu'une connexion &agrave; la fois.<br> Par d&eacute;faut et lorsqu'il est
    configur&eacute; avec <code>enablereuse=on</code> et lorsqu'un MPM &agrave; base de
    threads est utilis&eacute; (comme <code class="module"><a href="../mod/worker.html">worker</a></code> ou
    <code class="module"><a href="../mod/event.html">event</a></code>), mod_proxy autorise un jeu de <code class="directive"><a href="../mod/mpm_common.html#threadsperchild">ThreadsPerChild</a></code> connexions vers le serveur
    d'arri&egrave;re-plan pour chaque processus httpd, et par cons&eacute;quent, il faut
    pr&ecirc;ter une attention particuli&egrave;re aux situations suivantes :</p>
    <ul>
      <li>Avec une charge en HTTP/1, il est fort probable que le nombre de
      connexions vers le serveur FCGI d'arri&egrave;re-plan augmente jusqu'&agrave; atteindre
      <code class="directive"><a href="../mod/mpm_common.html#maxrequestworkers">MaxRequestWorkers</a></code>.</li>
      <li>Avec une charge en HTTP/2, et vue la mani&egrave;re dont
      <code class="module"><a href="../mod/mod_http2.html">mod_http2</a></code> est impl&eacute;ment&eacute;, il y a des threads de travail
      h2 additionnels qui peuvent forcer la cr&eacute;ation de connexions
      suppl&eacute;mentaires vers le serveur d'arri&egrave;re-plan. Le nombre total de
      connexions que contiennent les jeux de connexions peut alors d&eacute;passer
      <code class="directive"><a href="../mod/mpm_common.html#maxrequestworkers">MaxRequestWorkers</a></code>.</li>
    </ul>
    <p>Le nombre maximum de processus de travail PHP-FPM doit &ecirc;tre d&eacute;fini
    judicieusement car il est possible qu'ils finissent par rester dans l'&eacute;tat
    occup&eacute; ("busy") pour ne g&eacute;rer que des connexions persistantes inactives,
    sans avoir la possibilit&eacute; d'en &eacute;tablir de nouvelles ; ce qui se traduira
    pour l'utilisateur final par une pile de "HTTP request timeouts".</p>
    </div>

    <p>Dans l'exemple suivant, l'URI de la requ&ecirc;te est transmis en tant
    que chemin du syst&egrave;me de fichiers pour l'ex&eacute;cution du d&eacute;mon PHP-FPM.
    L'URL de la requ&ecirc;te est implicitement ajout&eacute;e au second param&egrave;tre.
    PHP-FPM est &agrave; l'&eacute;coute de l'h&ocirc;te et du port qui
    suivent fcgi://. La conservation/r&eacute;utilisation des connexions est activ&eacute;e.</p>
    <div class="example"><h3>PHP-FPM</h3><pre class="prettyprint lang-config">ProxyPassMatch "^/myapp/.*\.php(/.*)?$" "fcgi://localhost:9000/var/www/" enablereuse=on</pre>
</div>

    <p>Dans l'exemple suivant, l'URI de la requ&ecirc;te est transmis en tant
    que chemin du syst&egrave;me de fichiers pour l'ex&eacute;cution du d&eacute;mon PHP-FPM.
    Dans ce cas cependant, PHP-FPM est &agrave; l'&eacute;coute d'un socket de domaine
    unix (UDS). Cette fonctionnalit&eacute; est disponible &agrave; partir de la
    version 2.4.9. Avec cette syntaxe, si un nom d'h&ocirc;te et un port sont
    ajout&eacute;s apr&egrave;s fcgi://, ils seront ignor&eacute;s.</p>
    <div class="example"><h3>PHP-FPM with UDS</h3><pre class="prettyprint lang-config">ProxyPassMatch "^/(.*\.php(/.*)?)$" "unix:/var/run/php5-fpm.sock|fcgi://localhost/var/www/"</pre>
</div>

    <p>La passerelle &agrave; r&eacute;partition de charge n&eacute;cessite le chargement du
    module <code class="module"><a href="../mod/mod_proxy_balancer.html">mod_proxy_balancer</a></code> et d'au moins un module
    fournissant un algorithme de r&eacute;partition de charge, comme
    <code class="module"><a href="../mod/mod_lbmethod_byrequests.html">mod_lbmethod_byrequests</a></code> en plus des modules
    d&eacute;j&agrave; cit&eacute;s. <code class="module"><a href="../mod/mod_lbmethod_byrequests.html">mod_lbmethod_byrequests</a></code> est le module
    par d&eacute;faut et sera utilis&eacute; dans cet exemple de configuration.</p>

    <div class="example"><h3>Passerelle &agrave; r&eacute;partition de charge vers plusieurs
    instances de l'application</h3><pre class="prettyprint lang-config">ProxyPass "/myapp/" "balancer://myappcluster/"
&lt;Proxy "balancer://myappcluster/"&gt;
    BalancerMember "fcgi://localhost:4000"
    BalancerMember "fcgi://localhost:4001"
&lt;/Proxy&gt;</pre>
</div>

    <p>Vous pouvez aussi forcer le traitement d'une requ&ecirc;te en tant que
    requ&ecirc;te de mandataire inverse en cr&eacute;ant un court-circuiteur de
    gestionnaire appropri&eacute;. Dans l'exemple ci-dessous, toutes les
    requ&ecirc;tes pour des scripts PHP seront transmises au serveur FastCGI
    sp&eacute;cifi&eacute; par mandat inverse. Cette fonctionnalit&eacute; est disponible &agrave;
    partir de la version 2.4.10 du serveur HTTP Apache. Pour des raisons
    de performances, il est recommand&eacute; de d&eacute;finir un <a href="mod_proxy.html#workers">worker (configuration d'un
    mandataire)</a> repr&eacute;sentant le m&ecirc;me serveur fcgi:// d'arri&egrave;re-plan.
    Avec cette configuration, il est possible d'effectuer une
    correspondance directe entre l'URI et le chemin du fichier sur le
    serveur, et le chemin local du fichier sera alors transmis au serveur
    d'arri&egrave;re-plan. Lorsque FastCGI est configur&eacute; ainsi, le serveur est
    en mesure de calculer le PATH_INFO le plus appropri&eacute;.
      </p>
	<div class="example"><h3>Mandataire via un gestionnaire</h3><pre class="prettyprint lang-config">&lt;FilesMatch "\.php$"&gt;
    # Note : la seule partie variable est /path/to/app.sock
    SetHandler  "proxy:unix:/path/to/app.sock|fcgi://localhost/"
&lt;/FilesMatch&gt;
   # D&eacute;finition d'une configuration de mandataire qui convient.
   # La partie qui est mise en correspondance avec la valeur de
   # SetHandler est la partie qui suit le "pipe". Si vous devez faire
   # une distinction, "localhost" peut &ecirc;tre chang&eacute; en un nom de serveur
   # unique.
   &lt;Proxy "fcgi://localhost/" enablereuse=on max=10&gt;
   &lt;/Proxy&gt;

&lt;FilesMatch ...&gt;
    SetHandler  "proxy:fcgi://localhost:9000"
&lt;/FilesMatch&gt;

&lt;FilesMatch ...&gt;
    SetHandler  "proxy:balancer://myappcluster/"
&lt;/FilesMatch&gt;</pre>
</div>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
<h2 id="env">Variables d'environnement <a title="Lien permanent" href="#env" class="permalink">&para;</a></h2>
    <p>En plus des directives de configuration qui contr&ocirc;lent le
    comportement de <code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code>, de nombreuses
    <dfn>variables d'environnement</dfn> permettent de piloter le
    fournisseur du protocole FCGI :</p>
    <dl>
        <dt>proxy-fcgi-pathinfo</dt>
        <dd>Lorsqu'il est configur&eacute; via les directives <code class="directive"><a href="../mod/mod_proxy.html#proxypass">ProxyPass</a></code> ou <code class="directive"><a href="../mod/mod_proxy.html#proxypassmatch">ProxyPassMatch</a></code>,
	<code class="module"><a href="../mod/mod_proxy_fcgi.html">mod_proxy_fcgi</a></code> ne d&eacute;finit
	pas la variable d'environnement <var>PATH_INFO</var>,
	ce qui permet au serveur FCGI d'arri&egrave;re-plan de d&eacute;terminer
	correctement <var>SCRIPT_NAME</var> et <var>Script-URI</var>, et
	de se conformer &agrave; la section 3.3 de la RFC 3875. Si au contraire
	vous avez souhaitez que <code class="module"><a href="../mod/mod_proxy_fcgi.html">mod_proxy_fcgi</a></code> g&eacute;n&egrave;re une
	"estimation la plus exacte possible" de <var>PATH_INFO</var>,
	d&eacute;finissez la variable d'environnement
	<var>proxy-fcgi-pathinfo</var>. Ceci peut servir de
	contournement pour une bogue pr&eacute;sente dans certaines
	impl&eacute;mentations de FCGI. Cette variable peut &ecirc;tre
	multivalu&eacute;e afin de pouvoir choisir la valeur la plus appropri&eacute;e
	(versions 2.4.11 et sup&eacute;rieures) :
	<dl>
          <dt>first-dot</dt>
          <dd>PATH_INFO est extrait &agrave; partir du slash qui suit le
	  <em>premier</em> "." de l'URL.</dd>
          <dt>last-dot</dt>
          <dd>PATH_INFO est extrait &agrave; partir du slash qui suit le
	  <em>dernier</em> "." de l'URL.</dd>
          <dt>full</dt> 
          <dd>PATH_INFO est calcul&eacute; en supposant que l'URL correspond au
	  chemin du syst&egrave;me de fichiers.</dd>
          <dt>unescape</dt>
          <dd>PATH_INFO correspond &agrave; la partie chemin de l'URL avec ses
	  s&eacute;quences d'&eacute;chappement d&eacute;cod&eacute;es.</dd>
          <dt>toute autre valeur</dt>
          <dd>PATH_INFO correspond &agrave; la partie chemin de l'URL.  
              Auparavant, c'&eacute;tait la seule option pour proxy-fcgi-pathinfo.</dd>
         </dl>
	</dd>
    </dl>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="directive-section"><h2 id="proxyfcgibackendtype">Directive <span id="ProxyFCGIBackendType">ProxyFCGIBackendType</span> <a title="Lien permanent" href="#proxyfcgibackendtype" class="permalink">&para;</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Sp&eacute;cifie le type de l'application FastCGI d'arri&egrave;re-plan</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ProxyFCGIBackendType FPM|GENERIC</code></td></tr>
<tr><th><a href="directive-dict.html#Default">D&eacute;faut:</a></th><td><code>ProxyFCGIBackendType FPM</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration globale, serveur virtuel, r&eacute;pertoire, .htaccess</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_proxy_fcgi</td></tr>
<tr><th><a href="directive-dict.html#Compatibility">Compatibilit&eacute;:</a></th><td>Disponible &agrave; partir de la version 2.4.26 du serveur HTTP Apache</td></tr>
</table>
<p>Cette directive permet de sp&eacute;cifier le type de l'application FastCGI
d'arri&egrave;re-plan. Certains serveurs FastCGI, comme PHP-FPM, utilisent de mani&egrave;re
historique des variables d'environnement exotiques pour identifier le type du
serveur mandataire utilis&eacute;. D&eacute;finissez cette directive &agrave; "GENERIC" si votre
application n'est pas de type PHP-FPM et n'interpr&eacute;ter pas correctement des
variables d'environnement comme SCRIPT_FILENAME ou PATH_TRANSLATED telles
qu'elles sont d&eacute;finies par le serveur.</p>

<p>SCRIPT_FILENAME est un exemple de valeur modifi&eacute;e par la d&eacute;finition de cette
directive. Historiquement, lorsqu'on utilisait le module
<code class="module"><a href="../mod/mod_proxy_fcgi.html">mod_proxy_fcgi</a></code>, SCRIPT_FILENAME &eacute;tait pr&eacute;fix&eacute; par la cha&icirc;ne
"proxy:fcgi://". C'est cette variable que lisent certaines applications FastCGI
g&eacute;n&eacute;riques en tant que valeur en entr&eacute;e pour leur script ; cependant, PHP-FPM
peut supprimer le pr&eacute;fixe, puis garder en m&eacute;moire qu'il communique avec Apache.
Avec les versions 2.4.21 &agrave; 2.4.25, ce pr&eacute;fixe &eacute;tait automatiquement supprim&eacute; par
le serveur, emp&ecirc;chant ainsi PHP-FPM de d&eacute;tecter et interop&eacute;rer avec Apache dans
certains sc&eacute;narios.</p> 

</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="directive-section"><h2 id="proxyfcgisetenvif">Directive <span id="ProxyFCGISetEnvIf">ProxyFCGISetEnvIf</span> <a title="Lien permanent" href="#proxyfcgisetenvif" class="permalink">&para;</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Permet d'adapter la valeur des variables envoy&eacute;es aux serveurs
FastCGI</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ProxyFCGISetEnvIf <var>conditional-expression</var>
    [!]<var>environment-variable-name</var>
    [<var>value-expression</var>]</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration globale, serveur virtuel, r&eacute;pertoire, .htaccess</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_proxy_fcgi</td></tr>
<tr><th><a href="directive-dict.html#Compatibility">Compatibilit&eacute;:</a></th><td>Disponible &agrave; partir de la version 2.4.26 du serveur HTTP Apache.</td></tr>
</table>
<p>Juste avant la transmission d'une requ&ecirc;te au serveur FastCGI configur&eacute;, le
coeur du programme du serveur web d&eacute;finit un certain nombre de variables
d'environnement en fonction de certains d&eacute;tails de la requ&ecirc;te consid&eacute;r&eacute;e. Les
programmes FastCGI utilisent souvent ces variables comme donn&eacute;es en entr&eacute;e afin
de d&eacute;terminer quels scripts sous-jacents ils vont ex&eacute;cuter, ou quelles donn&eacute;es
en sortie doivent &ecirc;tre produites.</p>
<p>Voici quelques exemples de variables d'environnement importantes :</p>
<ul>
  <li>SCRIPT_NAME</li>
  <li>SCRIPT_FILENAME</li>
  <li>REQUEST_URI</li>
  <li>PATH_INFO</li>
  <li>PATH_TRANSLATED</li>
</ul>

<p>Cette directive permet de passer outre les variables d'environnement
ci-dessus, entre autres. Elle est &eacute;valu&eacute;e apr&egrave;s la d&eacute;finition de la valeur
initiale de ces variables ; elle peuvent donc &ecirc;tre utilis&eacute;es comme entr&eacute;es dans
les expressions d&eacute;finissants les conditions et les valeurs.</p>
<p>Syntaxe des param&egrave;tres :</p>
<dl>
<dt>conditional-expression</dt> 
<dd>D&eacute;finit une condition en fonction de laquelle la
variable d'environnement qui suit sera modifi&eacute;e ou non. Pour la syntaxe de cette
expression, reportez-vous aux exemples qui suivent ou &agrave; la sp&eacute;cification
d&eacute;taill&eacute;e dans le document <a href="../expr.html">ap_expr</a>.
   </dd>
<dt>environment-variable-name</dt> 
<dd>Sp&eacute;cifie le nom de la variable d'environnement &agrave; modifier, par exemple
PATH_INFO. Si elle est pr&eacute;c&eacute;d&eacute;e d'un point d'exclamation, la d&eacute;finition de la
variable sera annul&eacute;e.</dd>
<dt>value-expression</dt>
<dd>Sp&eacute;cifie la nouvelle valeur de la variable "environment-variable-name". On
peut inclure des
r&eacute;f&eacute;rences arri&egrave;res, comme "$1", issues de captures en provenance de
l'expression rationnelle <var>conditional-expression</var>. Si cette valeur est
omise, la variable est d&eacute;finie (ou sa valeur est &eacute;cras&eacute;e) par une cha&icirc;ne vide
&mdash; voir cependant la note ci-apr&egrave;s.</dd>
</dl>
  
<div class="example"><pre class="prettyprint lang-config"># Une modification basique, inconditionnelle
ProxyFCGISetEnvIf "true" PATH_INFO "/example"

# Utilisation d'une variable d'environnement pour sp&eacute;cifier la nouvelle valeur
ProxyFCGISetEnvIf "true" PATH_INFO "%{reqenv:SCRIPT_NAME}"
<br>
# Utilisation de captures dans la condition et de r&eacute;f&eacute;rences arri&egrave;res dans la
# nouvelle valeur
ProxyFCGISetEnvIf "reqenv('PATH_TRANSLATED') =~ m#(/.*prefix)(\d+)(.*)#" PATH_TRANSLATED "$1$3"</pre>
</div>

<div class="note"><h3>Note : Annulation d&eacute;finition ou valeur vide</h3>
  La ligne suivante annule la d&eacute;finition de la variable <code>VARIABLE</code>,
  ce qui l'emp&ecirc;che d'&ecirc;tre envoy&eacute;e au serveur FastCGI :

    <pre class="prettyprint lang-config">ProxyFCGISetEnvIf true !VARIABLE</pre>


  La ligne suivante, quant &agrave; elle, efface la <em>valeur</em> de la variable
  <code>VARIABLE</code> en lui affectant la cha&icirc;ne vide ; cette variable
  <code>VARIABLE</code> sera alors tout de m&ecirc;me envoy&eacute;e au serveur FastCGI :

    <pre class="prettyprint lang-config">ProxyFCGISetEnvIf true VARIABLE</pre>


  La sp&eacute;cification CGI/1.1 ne fait pas de distinction (<a href="https://www.rfc-editor.org/rfc/rfc3875#section-4.1">RFC 3875</a>) entre une variable contenant une cha&icirc;ne vide et une
  variable qui n'existe pas. De nombreuses impl&eacute;mentations CGI et FastCGI font
  cependant cette distinction (ou permettent aux scripts de la faire). Le choix
  de celle que vous allez utiliser d&eacute;pend de votre impl&eacute;mentation et de la
  raison qui vous pousse &agrave; modifier cette variable.
</div>


</div>
</div>
<div class="bottomlang">
<p><span>Langues Disponibles: </span><a href="../en/mod/mod_proxy_fcgi.html" hreflang="en" rel="alternate" title="English">&nbsp;en&nbsp;</a> |
<a href="../fr/mod/mod_proxy_fcgi.html" title="Fran&ccedil;ais">&nbsp;fr&nbsp;</a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Autoris&eacute; sous <a href="https://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Signaler un bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
    prettyPrint();
}
var langToggle = document.querySelector('.lang-toggle');
var topLang = document.querySelector('.toplang');
if (langToggle && topLang) {
    langToggle.addEventListener('click', function() { topLang.classList.toggle('open'); });
}
var qv = document.getElementById('quickview');
if (qv) {
    document.body.appendChild(qv);
    var qvBtn = document.createElement('button');
    qvBtn.className = 'qv-toggle';
    qvBtn.setAttribute('aria-label', 'Toggle page navigation');
    qvBtn.innerHTML = '&#9776;';
    document.body.appendChild(qvBtn);
    qvBtn.addEventListener('click', function() {
        var isOpen = qv.classList.toggle('open');
        if (isOpen) {
            qv.style.top = window.scrollY + 10 + 'px';
        }
    });
    window.addEventListener('scroll', function() { qv.classList.remove('open'); });
}
//--><!]]></script>
</body></html>